中文

Support

Klusto · 自托管服务的统一客户端 · (Chinese: 归流)

Klusto is a private client for self-hosted services. You bring your own server; the app talks to it. If something isn't working, this page should help you get unblocked.

Quick links

Connection guides

Music (Navidrome / Subsonic)

Works with any Subsonic-compatible server: Navidrome, Funkwhale, Airsonic, Gonic, etc.

  1. In Navidrome web UI: create a user (or use an existing one) and note the password.
  2. In the app: Music tab → Add Library → enter your server URL (e.g. https://music.example.com), username, and password.
  3. The app will validate the connection and start indexing your library.

Common gotchas: Server URL must be reachable from your phone's network; self-signed certs require a manual trust in iOS Settings; path prefix is /rest/ on Navidrome but the app handles this automatically.

Video (Emby)

  1. In Emby: Dashboard → Users → New User (or use your existing account).
  2. In the app: Video tab → enter server URL, username, and password.
  3. Sign-in completes once the server returns an access token.

Common gotchas: Emby Server 4.7+ required; reverse proxy must forward the X-Emby-Authorization header; HTTPS strongly recommended.

Notes (Memos)

  1. In Memos web UI: Settings → Access Tokens → Create.
  2. Copy the token.
  3. In the app: Notes tab → paste server URL and token.

Common gotchas: The app talks to Memos 0.18+ via the ConnectRPC interface; if you self-host an older version, please upgrade.

Finance (Firefly III)

  1. In Firefly: Profile → OAuth → Personal Access Tokens → Create Token. Choose scope: readonly (read-only) or full (read+write) — the app needs write access to add/edit transactions.
  2. In the app: Finance tab → enter server URL and paste the token.

Common gotchas: Token URL is https://your-firefly.com/api/v1 in some installations and bare https://your-firefly.com in others — the app accepts both.

FAQ

Does the app send my data anywhere besides my server?

No. See the Privacy Policy for details.

Is there an Android version?

Not yet. iOS is the primary target.

Can I self-host multiple backends (e.g., two Navidrome servers)?

Yes — for Music you can add multiple libraries pointing to different servers. The sidebar entry stays "Music / Navidrome" because that's the product family.

Background audio stopped working / CarPlay won't connect.

Make sure the app is allowed to run in background (iOS Settings → 归流 → Background App Refresh). For CarPlay, ensure the head unit supports the protocol and the iPhone is unlocked on first use.

Why is the app asking me to subscribe?

Free tier covers the core features. Subscriptions unlock advanced conveniences (e.g., offline downloads, multi-library sync). See Settings → Subscription for the exact list. You can use the app indefinitely without subscribing.

I have a feature request / found a bug.

Open an issue on GitHub (link below). Bug reports with a screen recording and your server version get fixed fastest.

Contact