- Config is now in XDG_CONFIG_HOME (~/.config/) for write access in AppImage - Auto-migrates existing config.ini from project root on first run - Creates directory on save() if not exists
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
Description
Languages
Python
98.4%
Shell
1.4%
Batchfile
0.2%