# rsplayer Project Plan

## Phase 1: Setup & Core
1. Initialize Rust project, add dependencies: `clap` (CLI/autocompletion), `rusqlite` (SQLite), `symphonia`/`cpal` (audio), `directories` (XDG paths), `serde`/`toml` (config), `tokio` (daemon async), `reqwest` (scrobbling).
2. Config stored at `$XDG_CONFIG_HOME/rsplayer/config.toml`: `music_paths` (array of directories to scan), `scan_interval` (optional periodic rescan interval), scrobbling credentials, daemon socket path. Daemon auto-scans configured paths on first run if database is empty/missing.
3. SQLite library schema: `artists`, `albums`, `tracks` tables. Implement `rsp scan` to scan all paths in config's `music_paths`, populate/update database. Support `--force` full rescan, `--paths` override config paths. Auto-scan triggers on first run (if DB empty) and periodically per `scan_interval` config.

## Phase 2: Daemon
1. Unix socket daemon (path: `$XDG_RUNTIME_DIR/rsplayer/daemon.sock`) for IPC.
2. Audio engine: Symphonia decode + CPAL output, support play/pause/stop/volume/seek.
3. Queue: in-memory, `last` (append to end, default), `now` (play immediately, ending current song playback), `next` (insert after current).
4. Shuffle modes: `none` (linear playback), `all` (shuffle all tracks), `album` (shuffle within album).
5. Scrobbling: Last.fm and ListenBrainz support via configured credentials.

## Phase 3: CLI & Completion
1. Clap-based CLI with all subcommands. Generate shell completions for bash/zsh/fish, suggest database artists/albums/tracks, file paths, and config keys/values.
2. `rsp status`: show player state, current track, progress, volume, next 2-3 queue items.
3. `rsp queue`: no arguments display current queue; with arguments add items (default `last` behavior).
4. `rsp settings` subcommands: `get`, `set`, `list`, `unset` config values (music paths, scrobbling credentials, scan interval, etc.) without manual file editing.

## Phase 4: Polish
1. Direct file/folder playback: prioritize database metadata if path matches known artist/album.
2. Logging, systemd service unit, unit tests.
3. Periodic rescan logic per config's `scan_interval`.