Skip to content

Library & settings

The History view, the actions on a session, and the settings keys that control logging behavior.

History surfaces in two places: the History entry in the library sidebar, and Settings. This page is the reference for both: what the view shows, the actions on a session, and the keys that control logging.

History view

  • Sidebar History, ordered by started_at desc.
  • Row: title, date, entry count, span (first started_at → last ended_at).
  • Detail: #, started_at, ended_at, duration, deck, title, artist, BPM, key, ISRC (read-only snapshot).
  • Detail rows are selectable and can be dragged onto a deck like library tracks; the logged snapshot itself stays read-only.

Session actions

Action Behavior
Rename session XSPF <title> + index
New session / Resume session See Manual session control
Export… See Export
Save as playlist Sortable Playlist via collection_entries
Delete session Remove XSPF + index row (confirm)
Reveal in folder Opens history/ in file manager

Settings

Add to settings.json / AppSettings:

Key Type Default Description
history_enabled bool true Master toggle
history_session_idle_minutes u32 5 Idle timeout before auto-close / new session
history_min_play_seconds u32 5 Minimum qualifying duration before entry is committed
history_min_deck_volume f32 0.05 Minimum effective output (deck.volume × crossfader_gain) for qualifying play
dim_played_tracks bool true Dim library/drive rows present in the open history session

UI: Settings → Library panel (dim_played_tracks); other history keys live under Settings → Session.

When history_enabled == false, no entries or session files are written; idle/manual session UI is hidden or disabled; played-track dimming is off regardless of dim_played_tracks.