podhnologic

Convert music libraries to iPod-friendly AAC/ALAC or to FLAC, MP3, Opus, and WAV.

Install

curl -fsSL https://raw.githubusercontent.com/jmonster/podhnologic/main/install.sh | bash

The installer verifies the download checksum and installs podhnologic to ~/.local/bin.

Use

Interactive mode:

podhnologic

Convert a folder:

podhnologic --input ~/Music --output ~/Converted --codec flac

Prepare files for an iPod:

podhnologic --input ~/Music --output ~/iPod --ipod

Use Apple Lossless on iPod:

podhnologic --input ~/Music --output ~/iPod --ipod --codec alac

Preview planned conversions:

podhnologic --input ~/Music --output ~/Converted --codec flac --dry-run

Flags

• --input <dir>: source directory
• --output <dir>: destination directory
• --ipod: use iPod settings; defaults to 256 kbps AAC when no codec is set
• --dry-run: show planned conversions
• --codec <format>: aac, alac, flac, mp3, opus, or wav
• --no-lyrics: drop lyrics metadata
• --interactive: force the terminal UI
• --version: print the version

Settings save to ~/.podhnologic/config.json.

Output

Codec	Settings
AAC	256 kbps
ALAC	Lossless; with --ipod, 16-bit 44.1 kHz
FLAC	Lossless
MP3	High-quality variable bitrate
Opus	128 kbps with libopus
WAV	16-bit PCM

podhnologic keeps title, artist, album, date, track, genre, disc, lyrics unless --no-lyrics is set, and album art. Other metadata is dropped for iPod compatibility.