SpytoRec is a powerful, CLI-based tool to record your currently playing Spotify tracks in real-time, automatically split them, embed metadata (title, artist, album, cover art), and organize them in your personal music library.

✅ Intended strictly for personal archival use only.

This tool is for personal, non-commercial use.

Recording copyrighted content from Spotify may violate their Terms of Service or local copyright laws.
You are solely responsible for your usage. The developers of this tool assume no liability.

• 🎵 Real-Time Recording (FLAC or OGG)
• 🎯 Track Splitting via Spotify API
• 🎼 Metadata Embedding: title, artist, album, and cover art
• ⚙️ Background Finalization for smooth capture
• 📁 File Organization: Artist/Album/Track
• 🧹 Audio Header Cleanup
• 🔧 Config File and CLI Argument Support
• 💬 Rich Terminal UI (rich)
• 🖥️ Cross-Platform: Windows, macOS, Linux

1. Install Python 3.7+ from python.org
2. Install FFmpeg:
   • Download from gyan.dev FFmpeg builds
   • Extract it and add the /bin folder to your PATH
3. Install VB-Audio Cable from vb-audio.com
4. Clone the repo and install requirements:

   git clone https://github.com/YOUR_USERNAME/SpytoRec.git
   cd SpytoRec
   pip install -r requirements.txt

5. Set Spotify output to CABLE Input, and run:

   python spytorec.py

1. Install Python 3.7+ (via Homebrew or python.org)
2. Install FFmpeg:

   brew install ffmpeg

3. Install BlackHole (2ch) via BlackHole GitHub
4. Set Spotify output to BlackHole in System Preferences > Sound > Output
5. Clone and install dependencies:

   git clone https://github.com/YOUR_USERNAME/SpytoRec.git
   cd SpytoRec
   pip install -r requirements.txt

6. Run the script:

   python spytorec.py

1. Install Python 3.7+, ffmpeg, and pavucontrol:

   sudo apt update && sudo apt install python3 ffmpeg pavucontrol python3-pip
   pip install spotipy requests mutagen rich

2. Load PulseAudio null sink:

   pactl load-module module-null-sink sink_name=spytorec_sink

3. Set Spotify output to Monitor of spytorec_sink using pavucontrol
4. Clone repo and run:

   git clone https://github.com/YOUR_USERNAME/SpytoRec.git
   cd SpytoRec
   python3 spytorec.py

python spytorec.py [COMMAND] [OPTIONS]

Records and saves current Spotify track with metadata.

Lists FFmpeg-detected audio input devices.

Tests Spotify API credentials and shows current playback info.

python spytorec.py                      # default run with config.ini
python spytorec.py record --format flac --organize
python spytorec.py list-devices
python spytorec.py test-auth

• Tracks saved in chosen format and directory
• FLAC includes embedded album art
• Duplicate checking by track ID and filename
• Metadata includes artist, album, and title
• Rewrites headers using FFmpeg post-recording

Pull requests and stars ⭐ are welcome!
Fork the repo, give it a star, and help build more useful tools for personal music archiving!

This project is licensed under MIT License
See LICENSE for details.

@Darkphoenix
GitHub: github.com/Danidukiyu