Microgamma is first and foremost a music player you own. This guide walks through the basic setup: install the desktop app, play your local library, then reach that same library from anywhere through play.microgamma.io.
1. Download & launch
Grab the build for your operating system from the Downloads page — macOS (Apple Silicon), Windows, or Linux (x64 / arm64). Unzip it and launch Microgamma like any other desktop app.
2. Log in
On first launch, Microgamma asks you to log in. It shows a URL and a short code — open the URL in any browser, enter the code, and approve. That links this desktop instance to your account, which is how your devices find each other later.
3. Configure
Two things to set, once:
- Device name — e.g.
Living Room. This is the label you'll pick when you connect from another device. - Music folder — point Microgamma at the folder where your music lives. It scans the folder and builds your library.
Both are remembered, so every future launch comes straight up ready to play.
4. Play locally
Your library now appears in the app. Browse, search, build playlists, and play — it all runs on your own machine, no internet connection required. At this point Microgamma is a complete local music player.
5. Play from anywhere
The same desktop instance doubles as your personal streaming server. Open play.microgamma.io on your phone, laptop, or any browser and log in with the same account. Your desktop device shows up in the list, and from there you can:
- Remote-control the desktop — steer playback on the machine at home, like a remote for your home stereo.
- Stream to the current device — pull the audio down to whatever you're holding and listen on the go.
While Microgamma is in beta, we provide free TURN/STUN relays so remote streaming works even through home routers and firewalls — no network setup on your end.
Want to run Microgamma without a GUI — on a server, NAS, or Raspberry Pi? See Headless Mode for the full command-line workflow, or the Docker guide to run it in a container.