crabidy/tidaldy/README.md

tidaldy — the Tidal provider

Mounts your Tidal account at /tidal in the crabidy library, using Tidal's web API.

Logging in

On first start the provider runs Tidal's OAuth device login:

1. Start the server. It prints a link.tidal.com verification URL to its stdout — for cbd (which owns the terminal) look in the log file under ~/.local/state/crabidy/ instead.
2. Open the URL in a browser and authorize the device. The server polls meanwhile; the attempt expires after a few minutes, so restart it if you miss the window.
3. The provider finishes logging in by itself. The tokens are written back into tidaly.toml and refreshed automatically from then on — you should not need to log in again.

To switch accounts or recover from an invalidated session, delete the [login] section from tidaly.toml and restart.

Note: a tidaly.toml that exists but cannot be parsed aborts server startup rather than silently dropping your account — unlike every other provider, whose config errors only cost that one subtree.

How it works

The tree offers your playlists, favorite artists (with their albums and tracks), and a search node: press % under /tidal/search to create a search term; the term becomes a persistent child node holding its results (tracks, artists, albums). Terms are renamable (e, re-runs the search) and deletable (d).

Everything queueable is also capturable: w bookmarks a subtree as links, W downloads a subtree's audio into /crabidy/<name>.

Configuration — ~/.config/crabidy/tidaly.toml

The file is rewritten on every server start with the current values (including refreshed tokens), so it contains your credentials — keep it private. All options with their defaults:

# Tidal API endpoints. Change only if you know why.
base_url = "https://api.tidal.com/v1"
hifi_url = "https://api.tidalhifi.com/v1"

# Stream quality: "Low" | "High" | "Lossless" | "HiRes".
audio_quality = "Lossless"

# Managed by the provider: filled in by the device login and refreshed
# automatically. Delete this whole section to force a fresh login.
[login]
# device_code = ...
# user_id = ...
# country_code = ...
# access_token = ...
# refresh_token = ...
# expires_after = ...

# OAuth client identity used for the device flow. Working defaults are
# built in; override only to use your own client registration.
[oauth]
# client_id = ...
# client_secret = ...
base_url = "https://auth.tidal.com/v1/oauth2"

Notes:

• A missing or empty file is fine: defaults are used and the device login runs on the next start.
• If Tidal ever invalidates the session (long offline periods), delete the [login] section and restart.
• Build the server without the tidal cargo feature to leave this provider out of the binary entirely.