# Block transient

> A transient shaper you can plug in: its state, a panel with a handle for the attack and the sustain and an engine that plays it. Play a loop through it and drag the handle: up for more click, left for a shorter ring

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-transient).

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

## Install

```bash
npx shadcn@latest add https://shadcn.exchange/r/audio-ui/block-transient.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/transient-panel`, `@audio-ui/transient-device`, `@audio-ui/transient-engine`, `@audio-ui/play-toggle`, `@audio-ui/use-device-loop`, `@audio-ui/use-master-bus`

## Files

### `block-transient.tsx`

```tsx
"use client";

import { useState } from "react";
import { PlayToggle } from "@/components/audio-ui/play-toggle";
import { TransientPanel } from "@/components/audio-ui/devices/transient/panel";
import { useDeviceLoop } from "@/hooks/use-device-loop";
import { useMasterBus } from "@/hooks/use-master-bus";
import {
  type TransientState,
  transientDevice,
} from "@/components/audio-ui/devices/transient/device";
import { createTransientEngine } from "@/components/audio-ui/devices/transient/engine";

const MASTER_VOLUME = 0.7;

/**
 * A transient shaper you can plug in: its state, a panel with a handle for
 * the attack and the sustain and an engine that plays it, each its own file
 * and none knowing the others. Play the loop and drag the handle: up for more
 * click, down to soften it, left to shorten what rings.
 */
export function BlockTransient() {
  const [state, setState] = useState<TransientState>(() =>
    transientDevice.defaults()
  );
  const master = useMasterBus(MASTER_VOLUME);
  const { playing, toggle } = useDeviceLoop({
    create: createTransientEngine,
    destination: master,
    state,
  });
  return (
    <div className="rounded-xl h-full w-full min-w-0">
      <TransientPanel onValueChange={setState} value={state}>
        <PlayToggle
          label="Play a loop through it"
          onToggle={toggle}
          playing={playing}
        />
      </TransientPanel>
    </div>
  );
}
```