Izzy allows you to download songs from Tidal, YouTube Music, and JioSaavn with full metadata and album art embedding.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ShubhamPP04/Izzy/llms.txt
Use this file to discover all available pages before exploring further.
Quick start
Download any song with a single click:- Find a song in search, favorites, queue, or playlist
- Click the download button (↓ icon)
- Wait for the download to complete (notification appears)
- Find your song in
~/Downloads/Izzy Music/
Downloads are available everywhere in Izzy - search results, favorites, queue, playlists, and more.
Download location
All downloaded songs are saved to a dedicated folder:File naming
Files are automatically named in the format:Opening downloads folder
Access your downloads folder:- Finder → Go → Downloads
- Open the “Izzy Music” folder
- Or use the download manager in Izzy to open it directly
Quality priority (Tidal)
Tidal downloads automatically select the best available quality:Priority order
- Hi-Res Lossless - 24-bit/192kHz FLAC (if available)
- Hi-Res - 24-bit/96kHz FLAC
- Lossless - 16-bit/44.1kHz FLAC (CD quality)
- High - 320kbps AAC/M4A
- FLAC (Lossless)
- M4A (Compressed)
Best quality - Lossless compressionUsed for:
- Hi-Res Lossless (up to 24-bit/192kHz)
- Hi-Res (24-bit/96kHz)
- Lossless (16-bit/44.1kHz)
- Hi-Res: 100-200 MB per song
- Lossless: 30-50 MB per song
- Bit-perfect audio
- No quality loss
- Supports high sample rates
- Professional archival format
The quality badge shown on each Tidal track indicates what quality will be downloaded. Not all tracks are available in Hi-Res or Lossless.
Metadata embedding
All downloaded songs include full metadata and album art.Embedded information
Track metadata
- Song title
- Artist name
- Album name (uses title if unavailable)
- “Downloaded with Izzy” comment
Album art
- High-resolution cover art
- Embedded directly in audio file
- Shows in iTunes, Music.app, and other players
- Downloaded from original source
FFmpeg integration
Metadata embedding is powered by FFmpeg:- Automatic detection - Izzy finds FFmpeg if installed
- Search paths - Checks
/opt/homebrew/bin,/usr/local/bin,/usr/bin - Graceful fallback - Downloads work without FFmpeg (no metadata)
- Format support - Handles FLAC, M4A, MP3, and more
Installing FFmpeg (optional)
For best results, install FFmpeg via Homebrew:- Embed album art into downloaded files
- Add complete track metadata
- Optimize file format for compatibility
Download process
Understanding what happens when you download a song:Steps
- Stream extraction - Izzy requests the audio stream URL from the music service
- Quality selection - Best available quality is chosen automatically
- Download - Audio file is downloaded to a temporary location
- Album art fetch - Cover art is downloaded (if available)
- Metadata embedding - FFmpeg adds tags and cover art to the file
- File move - Completed file is moved to
~/Downloads/Izzy Music/ - Notification - macOS notification confirms completion
Download states
| State | Description |
|---|---|
| Pending | Download queued, waiting to start |
| Downloading | Actively downloading audio stream |
| Processing | Embedding metadata and album art |
| Completed | Download finished successfully |
| Failed | Download encountered an error |
Progress tracking
Monitor download progress in real-time:- Progress bar - Visual indicator of download state
- Status text - Current step (downloading, processing, etc.)
- Completion notification - macOS notification when done
- Error handling - Clear error messages if download fails
macOS notifications
Get notified when downloads complete.Success notification
Error notification
Enabling notifications
- macOS asks for notification permission on first download
- Click “Allow” to enable notifications
- Or go to System Settings → Notifications → Izzy
Notifications include the song title and artist, so you know exactly which download completed.
Download manager
View and manage active downloads.Features
- Active downloads - See currently downloading tracks
- Progress tracking - Monitor download percentage
- Cancel downloads - Stop a download in progress
- Error retry - Retry failed downloads
- Open folder - Quick access to downloads directory
Accessing download manager
The download manager appears when any download is active:- Shows in a dedicated panel or overlay
- Updates in real-time as downloads progress
- Auto-hides when all downloads complete
Limitations & notes
Service differences
- Tidal
- YouTube Music
- JioSaavn
Best quality available✓ Hi-Res Lossless (24-bit/192kHz FLAC)✓ Lossless (16-bit/44.1kHz FLAC)✓ High (320kbps AAC)✓ Quality badges show available quality✓ Full metadata and album art
DRM considerations
- Izzy downloads DRM-free streams - No copy protection
- Legal - Downloads are for personal use only
- Quality - Limited to what the service provides via their API
- Compatibility - Files work in any music player
File sizes
Typical download sizes:| Quality | Format | Size (per song) |
|---|---|---|
| Hi-Res Lossless | FLAC | 100-200 MB |
| Lossless | FLAC | 30-50 MB |
| High (AAC 320) | M4A | 10-15 MB |
| High (AAC 256) | M4A | 8-12 MB |
| Standard | M4A | 5-8 MB |
Troubleshooting
Download fails immediately
- Check internet connection - Ensure stable connectivity
- Verify music service - Make sure the service is accessible
- Check Console.app - Look for specific error messages
- Retry download - Temporary service issues may resolve
No metadata or album art
- Install FFmpeg - Run
brew install ffmpeg - Verify FFmpeg path - Check
/opt/homebrew/bin/ffmpegexists - Restart Izzy - Reload after installing FFmpeg
- Re-download - Try downloading the song again
Download stuck at “Processing”
- Wait - FFmpeg processing can take 10-30 seconds for Hi-Res files
- Check FFmpeg - Verify FFmpeg is installed and working
- Cancel and retry - Use the download manager to cancel and restart
- Check disk space - Ensure sufficient space for temp files
Files not appearing in folder
- Check folder location - Verify
~/Downloads/Izzy Music/exists - Wait for completion - Notification confirms when file is ready
- Check download status - Look at download manager for errors
- File permissions - Ensure Izzy has write access to Downloads folder