tsiry-sandratraina.com / rockboxd

2

A modern, network-enabled music player platform built on Rockbox technology. rockboxd.tsiry-sandratraina.com

rust deno navidrome airplay libadwaita zig mpris snapcast mpd rockbox audio subsonic

2

rockboxd / mintlify

10 folders 10 files

at master

Tsiry Sandratraina docs(mintlify): document decoder + stereo balance, add Erlang binding page 13d ago

chore: release 2026.06.29 — Jellyfin-compatible API server Add an audio-only Jellyfin sidecar in `crates/jellyfin/src/server/` gated behind the new `server` cargo feature, spawned alongside Navidrome from `crates/server/src/lib.rs`. Activation is opt-in via `jellyfin_port` in `~/.config/rockbox.org/settings.toml`; omit the key to disable. Reuses `subsonic_username` / `subsonic_password` as the Jellyfin credentials. Spoofs `ProductName: "Jellyfin Server"` + `Version: 10.11.11` so the SDK-generated clients (Finamp, Findroid, Streamyfin, Amcfy Music, Symfonium) treat it as a real Jellyfin server. Tokens are persisted in a new `jellyfin_tokens` table and accepted via `X-Emby-Token`, the `MediaBrowser Token="…"` Authorization header, or `?api_key=` on streaming URLs. Item IDs are deterministic dashed UUIDs derived from the native `Artist/Album/Track` ids, round-tripped via a `jf_guids` lookup table so subsequent requests resolve back to the right row. Discovery runs in two tokio tasks: `_jellyfin._tcp.local.` mDNS plus a UDP listener on port 7359 answering the `"Who is JellyfinServer?"` probe. Album art handler mirrors Navidrome's resolver: HTTP(S) URLs proxied via reqwest, absolute paths read as-is, bare filenames resolved under `~/.config/rockbox.org/covers/`, with the same "fall back to any track in the album" fallback Navidrome already uses. Also bumps deb/rpm packaging to 2026.06.29, documents the new server in CHANGELOG/README, adds it to the mintlify reference (ports table, settings-toml, API intro, index card, nav entry) and a new `api-reference/jellyfin/overview.mdx` covering enabling, discovery, tested clients, endpoint surface, and what's not supported.

3 weeks ago

chore: rename project to "Rockbox Daemon" and repo to tsirysndr/rockboxd Renames the user-facing product name from "Rockbox Zig" to "Rockbox Daemon" and updates every reference to the GitHub repo URL, AUR package (rockbox-zig-bin → rockboxd-bin), macOS pkg identifier, Electron appId, and Gleam SDK repo metadata. Left intentionally unchanged: the published npm scope @rockbox-zig/sdk and the rockboxzig.mintlify.app docs URL.

1 month ago

chore: rename project to "Rockbox Daemon" and repo to tsirysndr/rockboxd Renames the user-facing product name from "Rockbox Zig" to "Rockbox Daemon" and updates every reference to the GitHub repo URL, AUR package (rockbox-zig-bin → rockboxd-bin), macOS pkg identifier, Electron appId, and Gleam SDK repo metadata. Left intentionally unchanged: the published npm scope @rockbox-zig/sdk and the rockboxzig.mintlify.app docs URL.

1 month ago

Switch built-in audio from SDL to CPAL Replace SDL references with CPAL across the docs. Add headless build instructions and CPAL sink details, and update dependency and packaging notes.

2 months ago

docs(mintlify): document decoder + stereo balance, add Erlang binding page Cover the two features that shipped across the FFI but were missing from the docs: the codecs Decoder surface (open a file, pull interleaved-stereo int16 PCM chunk-by-chunk) and the player stereo-balance control. - New bindings/erlang.mdx (+ docs.json nav) documenting rockbox_ffi_nif as the shared BEAM native layer under the Elixir/Gleam wrappers - overview: Three surfaces -> Four (add Decoder + process-wide note), add balance to the Player cards, add Erlang to the language picker - Add "Decode a file to PCM" + balance to all 9 per-language pages

1 week ago

chore: rename project to "Rockbox Daemon" and repo to tsirysndr/rockboxd Renames the user-facing product name from "Rockbox Zig" to "Rockbox Daemon" and updates every reference to the GitHub repo URL, AUR package (rockbox-zig-bin → rockboxd-bin), macOS pkg identifier, Electron appId, and Gleam SDK repo metadata. Left intentionally unchanged: the published npm scope @rockbox-zig/sdk and the rockboxzig.mintlify.app docs URL.

1 month ago

Add Chromecast SVG and update icon path

2 months ago

Add Mintlify documentation and update OpenAPI

2 months ago

chore: release 2026.06.29 — Jellyfin-compatible API server Add an audio-only Jellyfin sidecar in `crates/jellyfin/src/server/` gated behind the new `server` cargo feature, spawned alongside Navidrome from `crates/server/src/lib.rs`. Activation is opt-in via `jellyfin_port` in `~/.config/rockbox.org/settings.toml`; omit the key to disable. Reuses `subsonic_username` / `subsonic_password` as the Jellyfin credentials. Spoofs `ProductName: "Jellyfin Server"` + `Version: 10.11.11` so the SDK-generated clients (Finamp, Findroid, Streamyfin, Amcfy Music, Symfonium) treat it as a real Jellyfin server. Tokens are persisted in a new `jellyfin_tokens` table and accepted via `X-Emby-Token`, the `MediaBrowser Token="…"` Authorization header, or `?api_key=` on streaming URLs. Item IDs are deterministic dashed UUIDs derived from the native `Artist/Album/Track` ids, round-tripped via a `jf_guids` lookup table so subsequent requests resolve back to the right row. Discovery runs in two tokio tasks: `_jellyfin._tcp.local.` mDNS plus a UDP listener on port 7359 answering the `"Who is JellyfinServer?"` probe. Album art handler mirrors Navidrome's resolver: HTTP(S) URLs proxied via reqwest, absolute paths read as-is, bare filenames resolved under `~/.config/rockbox.org/covers/`, with the same "fall back to any track in the album" fallback Navidrome already uses. Also bumps deb/rpm packaging to 2026.06.29, documents the new server in CHANGELOG/README, adds it to the mintlify reference (ports table, settings-toml, API intro, index card, nav entry) and a new `api-reference/jellyfin/overview.mdx` covering enabling, discovery, tested clients, endpoint surface, and what's not supported.

3 weeks ago

chore: rename project to "Rockbox Daemon" and repo to tsirysndr/rockboxd Renames the user-facing product name from "Rockbox Zig" to "Rockbox Daemon" and updates every reference to the GitHub repo URL, AUR package (rockbox-zig-bin → rockboxd-bin), macOS pkg identifier, Electron appId, and Gleam SDK repo metadata. Left intentionally unchanged: the published npm scope @rockbox-zig/sdk and the rockboxzig.mintlify.app docs URL.

1 month ago

Add Mintlify documentation and update OpenAPI

2 months ago

CONTRIBUTING.md

Add Mintlify documentation and update OpenAPI

2 months ago

Add Mintlify documentation and update OpenAPI

2 months ago

chore: rename project to "Rockbox Daemon" and repo to tsirysndr/rockboxd Renames the user-facing product name from "Rockbox Zig" to "Rockbox Daemon" and updates every reference to the GitHub repo URL, AUR package (rockbox-zig-bin → rockboxd-bin), macOS pkg identifier, Electron appId, and Gleam SDK repo metadata. Left intentionally unchanged: the published npm scope @rockbox-zig/sdk and the rockboxzig.mintlify.app docs URL.

1 month ago

configuration.mdx

feat(hls): standalone HLS/DASH player + browser-side CMAF auto-connect Adds a `crates/hls` Rust player that decodes HLS/DASH URLs (m3u8 / mpd) and pushes PCM straight into the active sink via new `pcm_external_write` / `pcm_external_set_freq` firmware hooks — no pcmbuf, no codec dispatcher, so the same audio-output graph (cpal, AirPlay, Snapcast, CMAF, …) reroutes a Rockbox-internal HLS broadcast to any output the user picks. PlayTrack / pause / resume / next / previous / seek / hardStop in `crates/rpc` detect an active HLS session and dispatch locally or forward to the broadcaster over gRPC so peers stay in sync. CMAF sink: encoder now bootstraps with a full SEGMENT_WINDOW of silence so hls.js / dash.js don't fatal on a fresh manifest, and a dedicated silence-pacer thread keeps the manifest live between tracks without ever mixing into real-audio chunks. `pcm_cmaf_start()` is called eagerly from `load_settings` / device connect so the HTTP endpoint binds before the first track plays. Docker / docs: default `audio_output` flips to `cmaf` and port 7882 is exposed — the web UI's new `HlsAutoConnect` attaches `<audio>` to `/hls/master.m3u8` whenever the active device type is cmaf/hls/dash, and `HlsVolumeControl` adds a local browser volume slider. New mintlify page documents the sink, README + ports table + GraphQL `globalSettings.cmafHttpPort` follow.

1 month ago

docs(mintlify): document decoder + stereo balance, add Erlang binding page Cover the two features that shipped across the FFI but were missing from the docs: the codecs Decoder surface (open a file, pull interleaved-stereo int16 PCM chunk-by-chunk) and the player stereo-balance control. - New bindings/erlang.mdx (+ docs.json nav) documenting rockbox_ffi_nif as the shared BEAM native layer under the Elixir/Gleam wrappers - overview: Three surfaces -> Four (add Decoder + process-wide note), add balance to the Player cards, add Erlang to the language picker - Add "Decode a file to PCM" + balance to all 9 per-language pages

1 week ago

Add Mintlify documentation and update OpenAPI

2 months ago

chore: release 2026.06.29 — Jellyfin-compatible API server Add an audio-only Jellyfin sidecar in `crates/jellyfin/src/server/` gated behind the new `server` cargo feature, spawned alongside Navidrome from `crates/server/src/lib.rs`. Activation is opt-in via `jellyfin_port` in `~/.config/rockbox.org/settings.toml`; omit the key to disable. Reuses `subsonic_username` / `subsonic_password` as the Jellyfin credentials. Spoofs `ProductName: "Jellyfin Server"` + `Version: 10.11.11` so the SDK-generated clients (Finamp, Findroid, Streamyfin, Amcfy Music, Symfonium) treat it as a real Jellyfin server. Tokens are persisted in a new `jellyfin_tokens` table and accepted via `X-Emby-Token`, the `MediaBrowser Token="…"` Authorization header, or `?api_key=` on streaming URLs. Item IDs are deterministic dashed UUIDs derived from the native `Artist/Album/Track` ids, round-tripped via a `jf_guids` lookup table so subsequent requests resolve back to the right row. Discovery runs in two tokio tasks: `_jellyfin._tcp.local.` mDNS plus a UDP listener on port 7359 answering the `"Who is JellyfinServer?"` probe. Album art handler mirrors Navidrome's resolver: HTTP(S) URLs proxied via reqwest, absolute paths read as-is, bare filenames resolved under `~/.config/rockbox.org/covers/`, with the same "fall back to any track in the album" fallback Navidrome already uses. Also bumps deb/rpm packaging to 2026.06.29, documents the new server in CHANGELOG/README, adds it to the mintlify reference (ports table, settings-toml, API intro, index card, nav entry) and a new `api-reference/jellyfin/overview.mdx` covering enabling, discovery, tested clients, endpoint surface, and what's not supported.

3 weeks ago

installation.mdx

chore: rename project to "Rockbox Daemon" and repo to tsirysndr/rockboxd Renames the user-facing product name from "Rockbox Zig" to "Rockbox Daemon" and updates every reference to the GitHub repo URL, AUR package (rockbox-zig-bin → rockboxd-bin), macOS pkg identifier, Electron appId, and Gleam SDK repo metadata. Left intentionally unchanged: the published npm scope @rockbox-zig/sdk and the rockboxzig.mintlify.app docs URL.

1 month ago

chore: rename project to "Rockbox Daemon" and repo to tsirysndr/rockboxd Renames the user-facing product name from "Rockbox Zig" to "Rockbox Daemon" and updates every reference to the GitHub repo URL, AUR package (rockbox-zig-bin → rockboxd-bin), macOS pkg identifier, Electron appId, and Gleam SDK repo metadata. Left intentionally unchanged: the published npm scope @rockbox-zig/sdk and the rockboxzig.mintlify.app docs URL.

1 month ago

README.md

Rockbox Daemon — Documentation#

The Mintlify source for https://rockboxzig.mintlify.app.

Layout#

mintlify/
├─ docs.json              # navigation, theme, anchors
├─ index.mdx              # landing page
├─ quickstart.mdx
├─ installation.mdx
├─ configuration.mdx
├─ audio-output/          # builtin / snapcast / airplay / squeezelite / chromecast / upnp
├─ audio-settings/        # EQ, DSP, ReplayGain, crossfade
├─ clients/               # web, desktop, MPD, MPRIS
├─ architecture/          # build system, PCM sinks
├─ reference/             # CLI, ports, settings.toml, troubleshooting, FAQ
├─ api-reference/
│   ├─ introduction.mdx
│   ├─ openapi.json       # synced from crates/server/openapi.json
│   ├─ rest/overview.mdx
│   ├─ graphql/overview.mdx
│   ├─ grpc/overview.mdx
│   └─ mpd/overview.mdx
└─ sdks/                  # TypeScript / Python / Ruby / Elixir / Clojure / Gleam

Local preview#

npm i -g mint
mint dev

The preview lives at http://localhost:3000 and reloads on save.

Keeping the OpenAPI spec in sync#

api-reference/openapi.json mirrors crates/server/openapi.json. After adding or changing an HTTP route, edit crates/server/openapi.json and copy it over:

cp crates/server/openapi.json mintlify/api-reference/openapi.json

Mintlify auto-generates one page per operation under the HTTP REST group on every build.

Validating before pushing#

mint broken-links

Deployment#

The Mintlify GitHub app deploys this directory automatically on push to the default branch. No manual step needed.