Getting started
1-bit can play music from four places: an SMB share on your home server, a 1-bit bridge companion server (HTTPS, faster, optionally remote-reachable), a UPnP/DLNA media server on your network (a NAS media server or a Chord 2Go's own library, browsed directly with no bridge in the path — new in v1.6), or the on-device library (files you've dropped into the app's Documents folder). You can use any combination — each source shows up in the Sources tab.
Add an SMB share
- Open the Sources tab and tap + → Add SMB Share
-
Enter your server details:
- Host — IP or hostname (e.g.
192.168.1.10orsynology.local) - Share — the share name (e.g.
Music) - Username / Password — your SMB credentials
- Host — IP or hostname (e.g.
- Tap Save. The password is stored in your iPhone's Keychain and never leaves the device.
- Grant Local Network permission when iOS prompts — required to reach servers on your Wi-Fi.
Servers that advertise via Bonjour (_smb._tcp) appear in the
Nearby list — tap one to pre-fill the host.
Add a 1-bit bridge
The 1-bit bridge is a free, open-source companion server you run on a Mac, Windows PC, Linux box, or Raspberry Pi alongside your music library. It serves the iOS app over HTTPS instead of SMB — usually faster, works over Tailscale / WireGuard, and avoids the Samba quirks. The bridge has its own canonical site with full setup and troubleshooting documentation:
- Setup guide — install on macOS, Windows, Linux, or a Raspberry Pi; configure your library; pair your iPhone.
- Troubleshooting — pairing failures, TLS errors, Tailscale gotchas, certificate rotation.
- Full docs — overview, features, downloads, privacy.
The iOS-side pairing flow is the short version: open the bridge's admin console, click
Devices → Pair new device, then on iPhone open
Sources → + → Add 1-bit Bridge and either scan the QR code, tap a
discovered bridge under Discover on network, or open a
bridge:// link. The app probes the bridge, captures its TLS fingerprint, pins
it, and the first manifest sync takes seconds.
Use the on-device library
For listening with no server at all — files you've dropped into the app via the Files app or USB:
- Open Sources → + → Enable On-Device Library.
- Add files: open the Files app on the iPhone, browse to On My iPhone → 1-bit, and drag or paste your music in. Or connect the iPhone to a Mac / PC and drop files into 1-bit via Finder's Files tab.
- Tap Rescan on the on-device source row. Tracks appear in the Library tab once the scan finishes.
Scan your library
- For SMB: open a share and tap Scan (top right of the folder browser)
- For bridge: scanning is automatic — the bridge ships its pre-built manifest in one paginated GET
- For on-device: tap Rescan on the source row in the Sources tab
- SMB scans run in two passes — Pass 1 walks the folder tree, Pass 2 opens each file to read tags, artwork, and duration. The Sources row shows a live status line.
- Switch to Library — albums, artists, and playlists are ready
Rescans are incremental — only folders whose modification time has changed are re-processed. Use Full rescan from the source menu after moving files around. For bridge sources the manifest itself drives change detection, so a regular rescan is enough.
Play
- Tap any track to start
- The Now Playing view gives you scrubbing and skip
- Lock Screen, AirPods, and Apple Watch remote controls work as expected
- CarPlay: a full browse surface — Library / Now Playing / search / tap-to-play — on the head unit (new in v1.4)
- DLNA renderers: play to a Chord 2Go or other DLNA / UPnP renderer on your network from the Now Playing output picker (new in v1.5 — see below)
- Siri: say “play [album, artist, or playlist] on 1-bit” — at home, on the Lock Screen, or in CarPlay (new in v1.7)
- Home mixes: if you run a bridge with Smart Mixes on, the Home tab shows automatic mixes built from your listening history (new in v1.7)
- Background audio survives screen-off and app-switch
Play to a Chord 2Go or DLNA renderer (v1.5)
1-bit can hand a track to a DLNA / UPnP renderer on your network — a Chord 2Go is the headline target, and generic renderers (mconnect, BubbleUPnP, Linn Kazoo) work too. The renderer fetches and plays the audio itself, so the source has to be one it can pull from over the LAN: a 1-bit bridge, or — as of v1.6 — a UPnP/DLNA media server (a Chord 2Go's own library, a NAS media server), in which case the renderer fetches straight from that server. SMB and on-device tracks can't be cast this way — there's no URL for the renderer to fetch from. The bridge walkthrough below is the most common setup.
-
On the bridge, enable the DLNA MediaServer —
dlna.enabled: truein the config or the toggle on the admin Settings page. It's off by default and binds only your local network. - Start playing a bridge track on the iPhone, open Now Playing, and tap the output picker. Renderers discovered on your network (via SSDP) appear in the list.
- Pick the renderer. The app sends it the track's metadata and a link to the file on your bridge; the renderer fetches and plays the audio itself, bit-exact, over your LAN.
DLNA has no authentication, so while the bridge's MediaServer is on, any device on your LAN can browse and stream that library. Leave it off on untrusted shared networks. Full detail is on the bridge page and in the bridge docs.
Settings, explained
A short tour of every Settings section. The defaults work for most people — these are the knobs to know about when something specific isn't doing what you want.