Documentation
¶
Overview ¶
Package cmd implements CLI subcommands for cliamp.
Package cmd implements interactive subcommands invoked from the CLI. setup.go contains the provider onboarding wizard reachable via `cliamp setup`. It walks the user through configuring each remote provider (Navidrome, Plex, Jellyfin, Spotify, Qobuz, NetEase, YouTube Music), validates the connection where possible, and writes the resulting TOML section to ~/.config/cliamp/config.toml.
The UI is a small standalone Bubbletea+Lipgloss program — separate from the main player Model — because setup runs to completion and exits.
Index ¶
- func HistoryClear() error
- func HistoryShow(limit int, jsonOutput bool) error
- func PlaylistAdd(name string, paths []string) error
- func PlaylistBookmark(name string, index int) error
- func PlaylistBookmarks() error
- func PlaylistCreate(name string, paths []string, sshHost string) error
- func PlaylistDedupe(name string) error
- func PlaylistDelete(name string) error
- func PlaylistDoctor(name string, fix bool) error
- func PlaylistEnrich(name string) error
- func PlaylistExport(name, format, output string) error
- func PlaylistImport(path, name string) error
- func PlaylistList() error
- func PlaylistRemove(name string, index int) error
- func PlaylistRename(oldName, newName string) error
- func PlaylistShow(name string, jsonOutput bool) error
- func PlaylistSort(name, by string) error
- func Setup() error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func HistoryShow ¶
HistoryShow prints recently played tracks, newest first. limit <= 0 prints all. When jsonOutput is true, output is a JSON array suitable for scripting.
func PlaylistAdd ¶
PlaylistAdd appends tracks from the given paths to an existing playlist.
func PlaylistBookmark ¶
PlaylistBookmark toggles the bookmark flag on a track by index.
func PlaylistBookmarks ¶
func PlaylistBookmarks() error
PlaylistBookmarks lists all bookmarked tracks across all playlists.
func PlaylistCreate ¶
PlaylistCreate creates a new playlist from the given file and directory paths. If sshHost is non-empty, remote paths are walked via SSH.
func PlaylistDedupe ¶
PlaylistDedupe removes duplicate tracks by exact path, keeping first wins.
func PlaylistDelete ¶
PlaylistDelete deletes an entire playlist.
func PlaylistDoctor ¶
PlaylistDoctor reports missing local files and optionally prunes them.
func PlaylistEnrich ¶
PlaylistEnrich probes duration and derives album metadata for SSH tracks.
func PlaylistExport ¶
PlaylistExport writes a playlist as M3U or PLS.
func PlaylistImport ¶
PlaylistImport converts a local M3U/PLS file into a TOML playlist.
func PlaylistList ¶
func PlaylistList() error
PlaylistList prints all playlists with their track counts.
func PlaylistRemove ¶
PlaylistRemove removes a track by index from the named playlist. The index is 1-based for the user, converted to 0-based internally.
func PlaylistRename ¶
PlaylistRename renames a local playlist.
func PlaylistShow ¶
PlaylistShow displays the tracks in a playlist. If jsonOutput is true, the track list is printed as a JSON array to stdout.
func PlaylistSort ¶
PlaylistSort sorts a playlist in place by one of the supported metadata keys.
Types ¶
This section is empty.