# Block distortion

> A distortion you can plug in: its state, a panel that draws its transfer curve and an engine that plays it. Play a loop through it and turn the drive

A shadcn/ui block from the [@audio-ui](https://www.audio-ui.dev/?utm_source=shadcn.exchange) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/audio-ui/block-distortion).

- Page, with a live preview: https://shadcn.exchange/r/audio-ui/block-distortion
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/audio-ui/block-distortion-light-9ffa8aa3c7e9d3ee.png
- Registry item: https://www.audio-ui.dev/r/new-york-v4/block-distortion.json
- Listed: 2026-10-17, source last changed 2026-10-17

## Install

```bash
npx shadcn@latest add https://shadcn.exchange/r/audio-ui/block-distortion.json
```

Run it in a project that has shadcn/ui set up. It adds the files below and installs what they depend on.

## Dependencies

- npm packages: `@audio-ui/react`
- Registry items: `@audio-ui/distortion-panel`, `@audio-ui/distortion-device`, `@audio-ui/distortion-engine`, `@audio-ui/play-toggle`, `@audio-ui/use-device-loop`, `@audio-ui/use-master-bus`

## Files

### `block-distortion.tsx`

```tsx
"use client";

import { useState } from "react";
import { PlayToggle } from "@/components/audio-ui/play-toggle";
import { DistortionPanel } from "@/components/audio-ui/devices/distortion/panel";
import { useDeviceLoop } from "@/hooks/use-device-loop";
import { useMasterBus } from "@/hooks/use-master-bus";
import {
  type DistortionState,
  distortionDevice,
} from "@/components/audio-ui/devices/distortion/device";
import { createDistortionEngine } from "@/components/audio-ui/devices/distortion/engine";

const MASTER_VOLUME = 0.7;

/**
 * A distortion you can plug in: its state, a panel that draws its transfer
 * curve and an engine that plays it, each its own file and none knowing the
 * others. Play the loop and turn the drive: the curve bends as the sound does.
 */
export function BlockDistortion() {
  const [state, setState] = useState<DistortionState>(() =>
    distortionDevice.defaults()
  );
  const master = useMasterBus(MASTER_VOLUME);
  const { playing, toggle } = useDeviceLoop({
    create: createDistortionEngine,
    destination: master,
    state,
  });
  return (
    <div className="rounded-xl h-full w-full min-w-0">
      <DistortionPanel onValueChange={setState} value={state}>
        <PlayToggle
          label="Play a loop through it"
          onToggle={toggle}
          playing={playing}
        />
      </DistortionPanel>
    </div>
  );
}
```