489d99c068
- New src/artwork/ module with iPod Nano 7G cover art support - codecs: RGB565/RGB555/UYVY/JPEG encode/decode via numpy - presets: 50+ iPod artwork format definitions - chunks: ArtworkDB binary parser/writer (MHFD→MHSD→MHLI→MHII→MHNI) - writer: ithmb file generation + ArtworkDB assembly - extractor: cover extraction from audio files (APIC/covr/FLAC pictures) - cache: local JPEG cache for player UI - iTunes-style playback bar with 60x60 cover art display - Scan library now caches cover art by artist+album - iPod Nano7 transfer writes artwork to ArtworkDB + ithmb - FFmpeg conversion preserves embedded cover art (-map 0:t?) - One-time reembed_covers.py script in /tmp - MetadataHandler process_file() fallback to cover_path - Bug fixes: missing read_existing_artwork import, signed PID in Q format
Desktop application for downloading, converting, managing and transferring music to iPod Nano devices. Combines YouTube audio extraction, format conversion, metadata management, local library with playback, and direct device transfer while adhering to iPod Nano's technical specifications.
Features
- Download audio from YouTube videos/playlists
- Convert to iPod-compatible formats (AAC/M4A)
- Automatic metadata handling (title, artist, album art)
- Direct transfer to iPod Nano
- Cross-platform support (Windows, macOS, Linux)
Installation
- Clone this repository:
git clone https://github.com/yourusername/youtube-to-ipod-nano.git
cd youtube-to-ipod-nano
- Install dependencies:
pip install -r requirements.txt
- Install FFmpeg (required for audio conversion):
- macOS:
brew install ffmpeg - Linux:
sudo apt-get install ffmpeg - Windows: Download from FFmpeg website
- macOS:
Usage
GUI Application
Run the application:
python src/main.py
Command Line Interface
python src/cli.py --url "https://www.youtube.com/watch?v=VIDEO_ID" --output-dir "/path/to/ipod"
Options:
--url: YouTube video or playlist URL--output-dir: Output directory (iPod mount point)--format: Audio format (default: m4a)--quality: Audio quality in kbps (default: 256)--video: Enable video download (for compatible iPod models)
Legal Disclaimer
This tool is intended for personal use only. Users are responsible for complying with YouTube's Terms of Service and copyright laws. Please only download content that you have the right to access and use.
License
MIT License