1 files changed, 24 insertions, 0 deletions

diff --git a/PLAN.md b/PLAN.md
new file mode 100644
index 0000000..98bd897
--- /dev/null
+++ b/PLAN.md
@@ -0,0 +1,24 @@
+# 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`.