Before building Izzy Music Player from source, ensure you have the following prerequisites installed on your macOS system.
System requirements
- macOS 14.0 (Sonoma) or later
- Xcode (latest version from the App Store)
- Command Line Tools for Xcode
- Python 3.13 or higher
Xcode
Izzy Music Player is built using Swift 5.9+ and SwiftUI. You’ll need the latest version of Xcode installed.
Install Xcode
Download and install Xcode from the Mac App Store.
Install Command Line Tools
After installing Xcode, install the command line tools: Verify installation
Confirm that Xcode is properly installed:This should output the path to your Xcode installation. Python 3.13+
Python 3.13 or higher is strictly required. The app will not work with earlier Python versions (3.12, 3.11, etc.).
Installing Python
The recommended way to install Python 3.13+ is using Homebrew:
Verify Python version
After installation, verify that Python 3.13+ is installed:
The output should show version 3.13.0 or higher.
Python dependencies
The following Python packages are required and will be installed during setup:
- ytmusicapi (>= 1.7.0) - YouTube Music API integration
- yt-dlp (>= 2023.12.30) - Video/audio stream extraction
- requests (>= 2.31.0) - HTTP requests for JioSaavn and Tidal
FFmpeg
FFmpeg is optional but recommended for the song download feature. It enables embedding album art and metadata into downloaded audio files.
Code signing
If you plan to distribute the app, you’ll need an Apple Developer account and a valid signing certificate. Set the CODESIGN_IDENTITY environment variable to your signing identity.
Next steps
Once you have all prerequisites installed, proceed to Setup to clone the repository and install dependencies.