roadmap update

Author: m_igashi

README.md

@@ -22,12 +22,53 @@ mp3rgain adjusts MP3 volume without re-encoding by modifying the `global_gain` f
 
 ## Installation
 
-### Homebrew (macOS)
+### Windows
 
+**Download and extract** (recommended for most users):
+
+1. Download the latest release from [GitHub Releases](https://github.com/M-Igashi/mp3rgain/releases):
+   - `mp3rgain-*-windows-x86_64.zip` (most Windows PCs)
+   - `mp3rgain-*-windows-arm64.zip` (ARM-based Windows devices)
+
+2. Extract the ZIP file to a folder (e.g., `C:\Tools\mp3rgain`)
+
+3. Open PowerShell or Command Prompt and navigate to the folder:
+   ```powershell
+   cd C:\Tools\mp3rgain
+   .\mp3rgain.exe -h
+   ```
+
+4. (Optional) Add to PATH for system-wide access:
+   - Open "Edit environment variables for your account" from Start menu
+   - Edit the `Path` variable and add your folder (e.g., `C:\Tools\mp3rgain`)
+   - Restart your terminal
+
+> **Note:** mp3rgain is a command-line tool, not a GUI application. Double-clicking the executable will briefly open and close a terminal window. Always run it from PowerShell or Command Prompt.
+
+**Using Cargo** (for Rust developers):
+```powershell
+cargo install mp3rgain
+```
+
+### macOS
+
+**Homebrew** (recommended):
 ```bash
 brew install M-Igashi/tap/mp3rgain
 ```
 
+**Download binary:**
+1. Download `mp3rgain-*-macos-universal.tar.gz` from [GitHub Releases](https://github.com/M-Igashi/mp3rgain/releases)
+2. Extract: `tar -xzf mp3rgain-*-macos-universal.tar.gz`
+3. Move to PATH: `sudo mv mp3rgain /usr/local/bin/`
+
+### Linux
+
+**Download binary:**
+1. Download `mp3rgain-*-linux-x86_64.tar.gz` from [GitHub Releases](https://github.com/M-Igashi/mp3rgain/releases)
+2. Extract: `tar -xzf mp3rgain-*-linux-x86_64.tar.gz`
+3. Move to PATH: `sudo mv mp3rgain /usr/local/bin/`
+
 ### Cargo (all platforms)
 
 ```bash
@@ -38,15 +79,7 @@ cargo install mp3rgain
 cargo install mp3rgain --no-default-features
 ```
 
-### Download binary
-
-Download the latest release from [GitHub Releases](https://github.com/M-Igashi/mp3rgain/releases):
-- macOS (Universal): `mp3rgain-*-macos-universal.tar.gz`
-- Linux (x86_64): `mp3rgain-*-linux-x86_64.tar.gz`
-- Windows (x86_64): `mp3rgain-*-windows-x86_64.zip`
-- Windows (ARM64): `mp3rgain-*-windows-arm64.zip`
-
-All binaries include full ReplayGain support.
+All binaries include full ReplayGain support with zero runtime dependencies.
 
 ## Quick Start
 

docs/roadmap.md

@@ -1,66 +1,76 @@
 # mp3rgain Roadmap
 
-## Current Status: v0.1.0
+## Current Status: v1.0.0 (Production Ready)
 
-Core functionality complete:
+All core functionality complete:
 - [x] MP3 frame parsing (MPEG 1/2/2.5 Layer III)
 - [x] Global gain modification
 - [x] ID3v2 tag preservation
 - [x] VBR/CBR support
 - [x] CLI interface (apply/info/undo commands)
+- [x] ReplayGain analysis (track and album gain)
+- [x] AAC/M4A support (ReplayGain tags)
+- [x] Full mp3gain command-line compatibility
+- [x] Cross-platform support (Windows, macOS, Linux)
 
-## Short-term Goals
+## Completed Milestones
 
 ### v0.2.0 - Windows & Stability
 
-- [ ] Windows 11 compatibility verification
-- [ ] Windows ARM64 support
-- [ ] Comprehensive test suite with real MP3 files
-- [ ] Error handling improvements
-- [ ] Homebrew official formula submission
+- [x] Windows 11 compatibility verification
+- [x] Windows ARM64 support
+- [x] Comprehensive test suite with real MP3 files
+- [x] Error handling improvements
+- [x] Homebrew tap formula
 
 ### v0.3.0 - mp3gain Feature Parity
 
-- [ ] ReplayGain analysis (track gain calculation)
-- [ ] Album gain support
-- [ ] `-r` (apply Track gain) flag compatibility
-- [ ] `-a` (apply Album gain) flag compatibility
-- [ ] `-c` (ignore clipping) flag
-- [ ] `-p` (preserve original timestamp) flag
-
-## Medium-term Goals
+- [x] ReplayGain analysis (track gain calculation)
+- [x] Album gain support
+- [x] `-r` (apply Track gain) flag compatibility
+- [x] `-a` (apply Album gain) flag compatibility
+- [x] `-c` (ignore clipping) flag
+- [x] `-p` (preserve original timestamp) flag
 
 ### v0.4.0 - Extended Features
 
-- [ ] Batch processing improvements
-- [ ] Progress bar for large files
-- [ ] JSON output format
-- [ ] Dry-run mode
-- [ ] Undo log file (for exact restoration)
+- [x] Batch processing with recursive directory support
+- [x] Progress bar for large files
+- [x] JSON output format
+- [x] Dry-run mode
+- [x] TSV output format
 
-### v0.5.0 - Additional Formats (Optional)
+### v1.0.0 - AAC/M4A Support
 
-- [ ] AAC/M4A support (like aacgain)
-- [ ] FLAC support (optional)
-- [ ] Ogg Vorbis support (optional)
+- [x] AAC/M4A ReplayGain analysis
+- [x] iTunes freeform tag writing
+- [x] Multi-track audio support (`-i` option)
+- [x] Production-ready release
+
+## Upcoming Goals
+
+### v1.2.0 - Package Manager Expansion
 
-## Long-term Goals
+- [ ] Scoop package (Windows) - *in progress*
+- [ ] winget package (Windows Package Manager)
+- [ ] Homebrew core inclusion
+- [ ] AUR package (Arch Linux)
+- [ ] Nix package
+
+### Future
 
 - [ ] GUI wrapper (optional)
+- [ ] FLAC support (optional)
+- [ ] Ogg Vorbis support (optional)
 - [ ] Library API stabilization
 - [ ] Integration with music players/taggers
-- [ ] Homebrew core inclusion
 
 ## Community Goals
 
 - [ ] Reach 100 GitHub stars
 - [ ] 5+ contributors
-- [ ] Windows user base
-- [ ] Package manager availability (beyond Homebrew)
-  - [ ] Scoop (Windows)
-  - [ ] winget (Windows)
-  - [ ] AUR (Arch Linux)
-  - [ ] Nix
+- [ ] Grow Windows user base
+- [ ] Package availability in major package managers
 
 ---