Headless Mode

Run Microgamma without a graphical desktop — on a server, in Docker, on a Raspberry Pi. The GUI is optional.

1. Authenticate

Run the login command once to associate this device with your Microgamma account. A browser window opens for the OAuth flow. The token is saved locally and reused on subsequent starts.

Microgamma --login

2. Start Streaming

# Minimal start

Microgamma --token

# With persistent device config

Microgamma --token --config --device-name="Living Room" --music-path="/data/music"

3. Docker

Run Microgamma in a container. Mount your music folder, pass your token, and connect from any device on the network.

# Authenticate first (interactive container)

docker run -it --rm microgamma/microgamma-desktop --login

# Start streaming

docker run -d \

--name microgamma \

-v /path/to/music:/data/music \

-e MICROGAMMA_TOKEN=your-token \

-e DEVICE_NAME="Home Server" \

microgamma/microgamma-desktop \

--token --config --music-path=/data/music

CLI Reference

Flag	Description
--login	Open browser for OAuth device authorization. Saves token locally.
--token	Read saved token from local storage. Skips login if already authenticated.
--logout	Clear saved token.
--config	Save device configuration (name, music path) to local storage.
--device-name	Set a human-readable name for this device. Appears in the peer list.
--music-path	Absolute path to your music folder.

You can also set MICROGAMMA_TOKEN as an environment variable to skip the --token flag.