clusterfuck
/
crabidy
4
1
Fork 0
Code Issues 15 Pull Requests Actions Packages Projects 1 Releases 5 Wiki Activity
crabidy/fsdy
History
Test User 6ca8607586 Persist provider_item_id through fsdy link tomls 
A link/queue/bookmark toml now carries the source track's provider id, so
a later capture of a linked track can de-duplicate by provider id before
downloading instead of falling back to hashing fetched bytes. Empty when
the source has none (e.g. a local /fs file). The scan CLI fills the new
field explicitly.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 		2026-07-22 22:35:39 +02:00
..
src Persist provider_item_id through fsdy link tomls 2026-07-22 22:35:39 +02:00
Cargo.toml Add a filesystem provider for serialized track nodes 2026-07-21 01:58:55 +02:00
README.md Delete captures from disk at any depth, behind a confirmation 2026-07-21 20:34:03 +02:00

README.md

fsdy — the filesystem provider

Mounts a local directory at /fs in the crabidy library. The same engine also powers the server-managed mounts /queues, /bookmarks, and /captures — everything below applies to their on-disk format too.

How it works

The provider walks one configured root directory. Every directory becomes a queueable library node; every file ending in .cbd-track.toml becomes a track; everything else (audio files, covers, hidden entries) is invisible to the library. Listing order is case-insensitive by file name — prefix files with numbers to fix an order (the capture/bookmark writers use 0001-style prefixes for exactly this reason).

A track file carries the track's metadata plus a reference to the playable thing:

title = "We Will Rock You"      # required
artist = "Queen"                # optional
duration = 122                  # optional, seconds

[album]                         # optional
title = "News of the World"
release_date = "1977-10-28"

# Exactly ONE of the following four:
[playable]
file = "we-will-rock-you.flac"  # local audio; absolute, or relative to
                                # this file's directory (relocatable)
# url = "https://example.org/radio.mp3"   # http(s) stream
# link = "/tidal/artists/1/2/3"           # another provider's track
# skipped = true                # no audio: a capture recorded its
                                # source as uncapturable; shown red,
                                # skipped by playback

Malformed track files are skipped with a warning; they never break the listing. link playables resolve exactly one hop (a link to a link fails at play time), which keeps cycles impossible.

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

# Absolute path of the directory to expose under /fs.
# Default: the platform music directory (e.g. ~/Music). When neither is
# available the /fs mount is disabled — the rest of the server runs on.
# root = "/home/me/music"

The server-managed instances

/queues, /bookmarks, and /captures are fsdy instances over ~/.config/crabidy/{queues,bookmarks,captures}/, written by the server (queue persistence, w, W) and readable/editable with any file manager — they are just folders of the track files described above. Their top-level folders can be renamed (e) and deleted (d) from the TUI; /queues/current is the continuously persisted play queue and is protected.

/captures additionally lets d delete anything in its tree — a whole capture, a nested album folder, or a single track (which takes its downloaded audio file with it). Because that removes data from disk that was slow to download, the TUI asks for confirmation first (delete <name>? [y/N]); deletes elsewhere stay unconfirmed.