A Python CLI tool that automates downloading tracks from SoundCloud and importing them into Apple Music on macOS.

The downloaded MP3 files are automatically enriched with SoundCloud metadata (title, artist, album, genre, date) and cover artwork, so Apple Music shows the correct track information after import.

• macOS (Apple Music integration requires macOS)
• Python 3.8+
• yt-dlp (will be installed as dependency)

1. Clone or download the project:

git clone https://github.com/zfl4wless/sc2am.git
cd sc2am

2. Create a virtual environment (recommended):

python3 -m venv venv
source venv/bin/activate

3. Install dependencies:

pip install -r requirements.txt

4. Initialize configuration (optional):

python main.py config init

This creates a default config at ~/.sc2am/config.yaml.

SoundCloud-Links must point to a single track, for example: https://soundcloud.com/artist/track or https://www.soundcloud.com/artist/track.

Download a single track:

python main.py download "https://soundcloud.com/artist/track"

Download and add to playlist:

python main.py download "https://soundcloud.com/artist/track" --playlist "My Playlist"

Don't automatically open Music app:

python main.py download "https://soundcloud.com/artist/track" --no-open

Create a file urls.txt with one URL per line:

https://soundcloud.com/artist/track1
https://soundcloud.com/artist/track2
# This is a comment
https://soundcloud.com/artist/track3

Then process all URLs:

python main.py batch urls.txt

Batch options:

# Add all tracks to a playlist
python main.py batch urls.txt --playlist "My Playlist"

# Continue processing even if a URL fails
python main.py batch urls.txt --continue-on-error

View current configuration:

python main.py config show

Configuration File (~/.sc2am/config.yaml):

download_dir: ~/Downloads/sc2am
music_library_path: null
default_playlist: null
keep_downloads: true
open_music_app: true
log_level: INFO
log_file: null

Environment Variables: Override config file settings with environment variables:

SC2AM_DOWNLOAD_DIR=~/Music/Downloads
SC2AM_PLAYLIST="My Playlist"
SC2AM_LOG_LEVEL=DEBUG
SC2AM_KEEP_DOWNLOADS=false
python main.py download "https://soundcloud.com/artist/track"

Configuration Options:

# Use custom config file
python main.py --config /path/to/config.yaml download "..."

# Set log level
python main.py --log-level DEBUG download "..."

Batch download with logging:

python main.py --log-level DEBUG batch urls.txt --continue-on-error

Download to custom directory:

SC2AM_DOWNLOAD_DIR=~/Music python main.py download "..."

1. Validate - Checks if the provided URL is from a supported platform
2. Download - Uses yt-dlp to download audio as MP3 (192kbps)
3. Tag - Embeds title, artist, album/genre/date and cover artwork into the MP3
4. Open - Launches Apple Music with the tagged MP3 file
5. Add - (Optional) Adds track to specified playlist via AppleScript

pip install yt-dlp --upgrade

• Ensure Music.app is installed (comes with macOS)
• Check your open_music_app setting in config

• Playlist name must exactly match your Music.app playlists
• Ensure the Music.app is not currently playing (can interfere with AppleScript)

• Check that download directory exists and is writable:

mkdir -p ~/Downloads/sc2am
chmod 755 ~/Downloads/sc2am

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-feature)
3. Make your changes
4. Submit a pull request

# Install with dev dependencies
pip install -r requirements-dev.txt

# Code formatting
black sc2am/

# Linting
flake8 sc2am/

MIT License - see LICENSE file for details

• This tool is for personal use to manage legally acquired music
• Respect copyright laws in your jurisdiction
• SoundCloud's terms of service should be respected

For issues, feature requests, or questions:

• Open an issue on GitHub
• Check existing issues first