Get the instance description from settings.

Get the instance name from settings.

Get the library sync overview for all known peers.

Retrieve a P2P track by hash, fetching from the origin peer on-demand if not cached. 1. Try the local blob store (fast path). 2. If missing, look up

Get sync status for a single peer.

Get a user's taste vector from the database.

Internal: handle a single protocol message.

Handle an incoming SearchQuery: run a local FTS query and return results.

Check if the plugin exports a function with the given name.

Import a single audio file from storage into the database.

Announce all locally-uploaded tracks to a specific peer using incremental sync when possible (if we have a `last_seen` timestamp for this peer), other

Initialize the theme store: check safe mode, fetch active theme, inject CSS.

Inject a <link> stylesheet for the active theme.

Build the base URL for the given domain, respecting SOUNDTIME_SCHEME env var.

Check if any of the provided identifiers (NodeId, peer name) are blocked.

L2-normalize a vector in place.

GET /api/admin/blocked-domains

Read autoplay preference from localStorage (defaults to false).

Load all enabled plugins from the database. Queries plugins with status "enabled", loads their WASM sandboxes, and registers their event subscription

Load peers from the database (used at startup to restore known peers). All loaded peers are marked offline until pinged.

Load MusicBrainz configuration from instance_settings or fall back to defaults.

Log an error message on behalf of the plugin.

Log an event execution to the `plugin_events_log` table.

Log an info message on behalf of the plugin.

Log a warning message on behalf of the plugin.

Create a new metadata task tracker, initialized to `None` (idle). Called once at server startup in `main.rs` and installed as an Axum `Extension` on

Create a new task tracker.

Normalize a genre string: split compound genres on common separators, take the first segment, trim whitespace, and title-case it.

Parse a human-readable size string like `"2GB"`, `"512MB"`, `"1TB"`, or `"1073741824"`.

Parse a Wikipedia URL into (language_code, article_title). e.g. "https://en.wikipedia.org/wiki/Daft_Punk" → ("en", "Daft_Punk")

Returns the permissions.

Update a remote track's `is_available` and `last_checked_at` in the database. Matches by reconstructing the `remote_uri` pattern `p2p://origin_node/c

PostgreSQL interval string for fallback queries.

Return a standard error when the plugin system is disabled.

Shared logic for processing a single file upload (used by both single and batch).

Rebuild the local Bloom filter search index from all tracks in the database.

Ping all known peers and update their status.

Check availability of all known instances and update remote_tracks accordingly. P2P tracks (instance_domain starting with "p2p://") are skipped — thei

Register Media Session action handlers.

Send a `RequestCatalog` message to a peer, asking them to send us their full catalog via paginated `CatalogSync` messages.

Group track copies by content hash and select the best source for each.

Resolve a Wikidata URL (e.g. https://www.wikidata.org/wiki/Q44190) to a Wikipedia (lang, title) pair via the Wikidata API sitelinks.

Sanitize a string for use as a filesystem directory name.

Persist the entire peer registry to the database. Uses upsert (INSERT … ON CONFLICT UPDATE) so it is safe to call repeatedly. Runs inside a single t

Scrobble a track to Last.fm for a given user (fire-and-forget). Called from `log_listen` via `tokio::spawn`. Errors are logged, never returned to the

Send a search query to a specific peer and wait for results.

Search MusicBrainz for a recording matching title + artist.

Returns true if a tracing target should be captured.

Get a snapshot of all health records for monitoring/reporting.

Called once at startup — spawns a background task that checks weekly

Spawn a background task that periodically sweeps remote tracks. The task runs until the `shutdown_rx` channel receives `true`. Returns the `JoinHandl

Trigger a full library re-sync with a specific peer in the background. Runs through five phases: 1. **Ping** — verify peer connectivity and learn its

Count tracks by health status.

Internal: single attempt to send pre-serialized message bytes to a peer.

Check if a fetch for this hash is already in progress. If not, marks it as in-flight and returns `true` (caller should fetch). If yes, returns `false`

Uninstall a plugin: remove files and DB record.

Uninstall a theme: remove files and DB record. Also clears `active_theme_id` from instance_settings if this was the active theme.

Update the Media Session metadata (lock screen, notification center).

Update an installed plugin by re-cloning and re-validating. The old version is preserved for rollback. If loading the new version fails, the old vers

Update an installed theme by re-cloning and re-validating.

Compute and store a user's taste vector based on their listen history. The taste vector is a weighted average of track embeddings where the weight is

Validate an HTTP host entry. Must be non-empty, contain no spaces, and either be `"*"`, `"localhost"`, or contain at least one dot (basic domain vali

Validate a plugin name against `^[a-z][a-z0-9-]{1,63}$`. The name must start with a lowercase ASCII letter, followed by 1-63 characters that are lowe

Verify is_peer_blocked and is_any_peer_id_blocked exist with correct signatures

Reset all player state. Intended for test isolation.

Manually add a peer by its EndpointAddr and ping it. Returns the PeerInfo if the peer responds.

POST /api/favorites/:track_id (auth required)

POST /api/admin/p2p/peers — add a peer by NodeId (admin only)

POST /api/playlists/:id/tracks (auth required, owner only)