885a401ad0
- Rename project from 'youtube-to-ipod-nano' to 'neo-pod-desktop' across all files - Update description: 'Desktop application for downloading, converting, managing and transferring music to iPod Nano devices' - Update setup.py: name, description, url, entry_points, author - Update run.py: docstring and argparse description - Update src/__init__.py: module docstring - Update src/main.py: docstring, window title, about label - Update src/cli.py: docstring, class docstring, argparse description - Update README.md: title and project description - Improve duplicate track detection in ipod_nano7_db.py: case-insensitive matching, bulk removal with file cleanup
64 lines
1.7 KiB
Markdown
64 lines
1.7 KiB
Markdown
<!-- # neo-pod-desktop -->
|
|
|
|
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
|
|
|
|
1. Clone this repository:
|
|
|
|
```bash
|
|
git clone https://github.com/yourusername/youtube-to-ipod-nano.git
|
|
cd youtube-to-ipod-nano
|
|
```
|
|
|
|
1. Install dependencies:
|
|
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
1. Install FFmpeg (required for audio conversion):
|
|
- **macOS**: `brew install ffmpeg`
|
|
- **Linux**: `sudo apt-get install ffmpeg`
|
|
- **Windows**: Download from [FFmpeg website](https://ffmpeg.org/download.html)
|
|
|
|
## Usage
|
|
|
|
### GUI Application
|
|
|
|
Run the application:
|
|
|
|
```bash
|
|
python src/main.py
|
|
```
|
|
|
|
### Command Line Interface
|
|
|
|
```bash
|
|
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
|