Quick Start

Get timecode running in under 5 minutes

1

Download & Install

Grab the latest release for your platform:

Download Latest Release
  • Windows: Run the .exe installer
  • macOS: Open the .dmg and drag to Applications
  • Linux: Extract the .tar.gz and run ./bptimecode
2

Start the Server

Open a terminal and run:

bptimecode serve

This starts the server and opens the web UI in your browser at http://localhost:5050

3

Create Your First Slot

In the web UI:

  1. Click the + button
  2. Name your slot (e.g., "Main TC")
  3. Choose a frame rate (default: 29.97 drop-frame)
  4. Click Create

Or via CLI:

bptimecode slot create --name "Main TC" --framerate 29.97df
4

Start Playback

Click the ▶ Play button on your slot. You'll see the timecode start counting.

Or via CLI:

bptimecode slot play 1
5

Route to an Output

Now let's send that timecode somewhere useful:

🔊 LTC Audio

  1. Go to Settings → LTC
  2. Select your audio output device
  3. Enable LTC output for Slot 1

💡 Art-Net

  1. Go to Settings → Art-Net
  2. Configure your network interface
  3. Set the universe and enable output

🎹 MTC (MIDI)

  1. Go to Settings → MTC
  2. Select your MIDI output device
  3. Enable MTC output for Slot 1

What's Next?

📡 Routing

Learn how to route timecode to multiple outputs simultaneously.

🎯 Presets

Save timecode positions for instant recall during shows.

🎛️ OSC Control

Control BPTimecode from QLab, Companion, or any OSC-capable software.