Overview
ShellBeats is a lightweight command‑line utility that lets you pull tracks from your existing music collection and add them to YouTube playlists on the fly. It bridges the gap between local libraries and online streaming without the need to rebuild playlists manually.
How It Works
The tool scans your specified music folder, matches tracks with YouTube search results, and appends the best match to a target playlist. All actions happen inside the terminal, keeping you in a focused workflow.
- Specify a source directory containing MP3, FLAC, or OGG files.
- Provide a YouTube playlist ID or let ShellBeats create a new one.
- Run a single command to add one or multiple tracks.
Key Benefits
- Speed: No need to open a browser or drag‑and‑drop files.
- Consistency: Leverages the music you already own, preserving your personal curation.
- Portability: Works on any Linux distribution with a Bash shell.
- Open Source: Free to use and modify via the GitHub repository.
Getting Started
1. Visit the ShellBeats website or its GitHub page to download the latest release.
2. Install dependencies (curl, jq, youtube‑dl/yt‑dlp).
3. Configure your music path in ~/.shellbeatsrc.
4. Run shellbeats add "My Favorite Song" --playlist MYPLAYLISTID to add a track.
Related Terminal Tools
If you enjoy extending terminal functionality, check out these companions:
- yt-dlp: Powerful YouTube downloader and metadata fetcher.
- ranger: Console file manager for quick navigation.
- ncdu: Disk usage analyzer to keep your music library tidy.
Community Feedback
Users praise ShellBeats for its simplicity and the way it “keeps the terminal alive” when handling media tasks. The project welcomes contributions, bug reports, and feature requests via the GitHub Issues tracker.