Quick Start

import { Steps, Tabs, TabItem } from ‘@astrojs/starlight/components’;

Desktop Quick Start

This walkthrough takes you from a fresh install to playing your first track on air.

1. Launch brūhi

   Open brūhi from your Applications folder (macOS), Start menu (Windows), or run ./bruhi.AppImage (Linux).

   The app opens to the Live Broadcast workspace.

2. Select your audio output device

   Click the System tab in the top navigation. Under Audio Devices, choose your speakers or headphones as the Output device.

   Tip

   If you have a dedicated audio interface, select it here. The output device is used for both broadcast monitoring and the PFL/cue headphone bus.

3. Add music to the library

   Click the Content Library tab. Click Scan Folder and choose a folder containing your music files.

   brūhi supports MP3, FLAC, WAV, OGG, AAC, AIFF, and Opus. Tags are extracted automatically.

4. Load a track to Deck A

   In the library, click a track row and press Load to Deck A (or drag it to the Deck A area in the Live Broadcast workspace).

5. Press Play

   In the Live Broadcast workspace, press the Play button on Deck A. You should see the VU meters move and hear audio through your output device.

6. Configure broadcast output (optional)

   To stream to Icecast or Shoutcast, click Broadcast Outputs in the System tab. Enter your server details and click Start Broadcast.

   See Broadcast Outputs for full configuration.

Cloud Quick Start

This walkthrough takes you from docker compose up to broadcasting from your browser.

1. Start the stack

   Extract the brūhi Cloud release package, then:

   cd bruhi-cloud
   docker compose up -d

2. Verify it is running

   curl http://localhost:8000/health
   # {"status":"ok"}

3. Open the dashboard

   Navigate to http://localhost:8000 in your browser. You will see the brūhi login screen.

   Authentication

   Authentication (email + OTP) is currently in development. The dashboard may be accessible directly in the current build.

4. Select a station

   After logging in, you will be prompted to select a station. Station 1 is created by default.

5. Allow microphone access

   Click Go Live in the top bar. Your browser will request microphone permission. Accept it.

   brūhi captures your browser microphone via WebRTC and streams it through GStreamer into the Liquidsoap broadcast chain.

6. Add music and queue tracks

   Click the Content Library tab. Upload audio files directly from your computer, or configure an S3 bucket to browse cloud-stored media.

   Drag tracks into the queue on the Live Broadcast workspace.

7. Check your stream

   Your station streams to the Icecast server included in the Docker stack. By default the mountpoint is /station-1.mp3:

   http://localhost:8005/station-1.mp3

   Open this URL in any media player or browser to hear the output.