Configuration Reference

Configuration Options

Key	Type	Default	Description
server.port	number	5050	HTTP server port
server.host	string	0.0.0.0	Server bind address
osc.enabled	boolean	true	Enable OSC server
osc.port	number	5051	OSC server port
ltc.defaultDevice	string	null	Default LTC audio device
ltc.volume	number	0.8	LTC output volume (0-1)
artnet.enabled	boolean	true	Enable Art-Net
artnet.interface	string	auto	Network interface for Art-Net
sacn.enabled	boolean	true	Enable sACN (E1.31)
sacn.universe	number	1	Default sACN universe
mtc.enabled	boolean	true	Enable MTC output
mtc.device	string	null	MIDI device for MTC
ui.theme	string	dark	Web UI theme (dark/light)
ui.openOnStart	boolean	true	Open browser on server start

Example Config

{
  "server": {
    "port": 5050,
    "host": "0.0.0.0"
  },
  "osc": {
    "enabled": true,
    "port": 5051
  },
  "ltc": {
    "defaultDevice": "Built-in Audio",
    "volume": 0.8
  },
  "artnet": {
    "enabled": true,
    "interface": "en0"
  },
  "ui": {
    "theme": "dark",
    "openOnStart": true
  }
}

Environment Variables

Environment variables override config file settings:

Variable	Description
BPTIMECODE_PORT	Override server.port
BPTIMECODE_OSC_PORT	Override osc.port
BPTIMECODE_CONFIG	Config file path
BPTIMECODE_LOG_LEVEL	Log level (debug, info, warn, error)

Config File Locations

• Windows: %APPDATA%\BPTimecode\config.json
• macOS: ~/.bptimecode/config.json
• Linux: ~/.bptimecode/config.json

CLI Commands

# Show current config
bptimecode config show

# Show config file path
bptimecode config path

# Reset to defaults
bptimecode config reset