Repository navigation
Releases
Musync v1.1.0: Dev Mode, Terminal Splits & Quality-of-Life
This major release transforms Musync into a true developer tool by adding seamless terminal split-screen orchestration, alongside several highly requested CLI additions and auth fixes.
New Features
Developer Mode (musync dev ): You can now play your music while running terminal commands simultaneously! Wrapping your session in tmux, this mode automatically splits your terminal, showing the interactive music player on top and leaving a flawless bash/zsh shell perfectly sized at the bottom.
Single Song Dev Mode (musync dev-search ): Bypass playlists completely and instantly search for a specific track while launching into split-screen mode.
View Command (musync view ): Instantly fetch and preview all the tracks inside a playlist without launching the player UI.
Tmux Auto-Installer: The setup wizard now intelligently detects if tmux is missing (on Mac/Linux) and will auto-install it using brew or apt the first time you launch Dev Mode.
Fixes & Improvements
Hidden API Credentials: When running the setup wizard, typing your Spotify Client ID and Secret now masks the input with asterisks (***) exactly like a sudo password prompt, protecting your keys if you are streaming or recording.
Auth Exit Fix: Fixed a bug where the terminal would hang after successfully connecting to Spotify because the web browser held the callback socket open. The CLI now forces a clean exit and returns control immediately.
Improved Auth Documentation: Clarified the Redirect URI (/callback) explicitly in both the CLI prompt and the README to make generating Spotify API keys completely foolproof.
Musync v1.0.8: Dev Mode, Terminal Splits & Quality-of-Life
This major release transforms Musync into a true developer tool by adding seamless terminal split-screen orchestration, alongside several highly requested CLI additions and auth fixes.
New Features
Developer Mode (musync dev): You can now play your music while running terminal commands simultaneously! Wrapping your session in tmux, this mode automatically splits your terminal, showing the interactive music player on top and leaving a flawless bash/zsh shell perfectly sized at the bottom.
View Command (musync view): Instantly fetch and preview all the tracks inside a playlist without launching the player by using musync view .
Tmux Auto-Installer: The setup wizard now intelligently detects if tmux is missing (on Mac/Linux) and will auto-install it using brew or apt the first time you launch Dev Mode.
Fixes & Improvements
Auth Exit Fix: Fixed a bug where the terminal would hang after successfully connecting to Spotify because the web browser held the callback socket open. The CLI now forces a clean exit and returns control immediately.
Improved Auth Documentation: Clarified the Redirect URI (/callback) explicitly in both the CLI prompt and the README to make generating Spotify API keys completely foolproof.
v1.0.7 - New 3D Visualizers & UI Improvements
This release brings massive visual upgrades to the Musync terminal experience, featuring brand-new 3D and audio-reactive animations, alongside quality-of-life UI improvements!
What's New:
New 3D Cube Visualizer: Added a rotating 3D wireframe cube that scales, spins, and reacts to the real-time audio volume!
New Starfield Visualizer: Added an immersive ASCII starfield that hits warp speed on heavy bass drops.
New Oscilloscope Visualizer: Added a highly responsive vibrating synthesizer waveform that tracks audio intensity.
Dynamic Speed Indicator: You no longer have to guess what speed your visualizers are running at. The help menu now displays a real-time Speed (1-10) indicator when using the + or - shortcuts.
Improvements & Fixes:
Visualizer Cleanup: Streamlined the default visualizer rotation to only include the absolute best, most performant animations.
Help Menu Updates: Cleaned up the bottom controls display to dynamically show your active speed level.
General code cleanup and stability improvements.
Installation
To update to v1.0.7, download the compiled binary for your operating system from the assets below and replace your existing executable, or run the installer script:
Mac/Linux:
curl -sL https://raw.githubusercontent.com/Saarthak1234/musync/main/install.sh | bash Windows:
irm https://raw.githubusercontent.com/Saarthak1234/musync/main/install.ps1 | iexv1.0.6 - Windows Installation Fixes, Spotify Auth Wizard, & TUI Stability
New Features
- Interactive Spotify Setup Wizard: Users can now connect their own Spotify Developer credentials (
Client IDandClient Secret) directly via a beautiful terminal prompt when runningmusync auth. - Global Configuration: Spotify keys and tokens are now securely stored in your global OS AppData folder. This completely removes the need for local
.envfiles, allowing you to runmusyncfrom any folder on your computer! - Installation Progress Bar (Windows): Added real-time percentage and Megabyte tracking feedback for manual
yt-dlpandffmpegfallback downloads.
Bug Fixes
- Fixed Infinite Hang on Windows Install: Resolved a critical stream destruction bug caused by GitHub HTTP 301/302 redirects during the
.exedownload process. Installations will no longer freeze silently! - Fixed TUI Font Crash: Bundled the
figletASCII fonts directly into the Bun-compiled executables. This prevents theENOENT: no such file or directory (Standard.flf)crash when starting Musync or searching for songs. - Winget Interference: Stopped the terminal spinner from overriding and hiding the native
wingetinstallation progress bar.
To install or update on Windows:
irm https://raw.githubusercontent.com/Saarthak1234/musync/main/install.ps1 | iexFix Windows download hang issue
Musync
Musync is a blazing-fast CLI application that allows you to stream your Spotify playlists completely free by sourcing lyric videos directly from YouTube.
Features
- Zero-Setup Playback: Paste any public Spotify Playlist URL to start playing immediately—no Spotify account or login required!
- Immersive Full-Screen TUI: The player launches into a dedicated "vim-style" alternate screen buffer. Enjoy a gorgeous, minimal music player interface without permanently cluttering up your terminal history.
- Dynamic ASCII Animations: A built-in color-changing animation engine! Watch ASCII cats and developer logos bounce to the music while your song plays.
- Native In-App Search Bar: Instantly open a search bar at the bottom of the screen to jump to a specific track number or type a custom song name to play it mid-playlist—without ever leaving the UI.
- Smarter YouTube Sourcing: The algorithm heavily prioritizes "lyric videos" to prevent long movie dialogues and music video intros from ruining the flow of your playlists.
Installation
Mac & Linux
You can install Musync globally with a single command. Open your terminal and run:
curl -sL [https://raw.githubusercontent.com/Saarthak1234/musync/main/install.sh](https://raw.githubusercontent.com/Saarthak1234/musync/main/install.sh) | bashWindows (v1.0.5+)
You can now install Musync directly via PowerShell. Open your PowerShell terminal and run:
PowerShell
irm https://raw.githubusercontent.com/Saarthak1234/musync/main/install.ps1 | iex(Once installed via either method, you can run musync play from anywhere!)
v1.0.4: The interactive terminal release
Musync
Musync is a blazing-fast CLI application that allows you to stream your Spotify playlists completely free by sourcing lyric videos directly from YouTube.
Features
- Zero-Setup Playback: Paste any public Spotify Playlist URL to start playing immediately—no Spotify account or login required!
- Immersive Full-Screen TUI: The player launches into a dedicated "vim-style" alternate screen buffer. Enjoy a gorgeous, minimal music player interface without permanently cluttering up your terminal history.
- Dynamic ASCII Animations: A built-in color-changing animation engine! Watch ASCII cats and developer logos bounce to the music while your song plays.
- Native In-App Search Bar: Instantly open a search bar at the bottom of the screen to jump to a specific track number or type a custom song name to play it mid-playlist—without ever leaving the UI.
- Smarter YouTube Sourcing: The algorithm heavily prioritizes "lyric videos" to prevent long movie dialogues and music video intros from ruining the flow of your playlists.
Installation
Mac & Linux (Recommended)
You can install Musync globally with a single command. Open your terminal and run:
curl -sL https://raw.githubusercontent.com/Saarthak1234/musync/main/install.sh | bashv1.0.3: The Zero-Auth URL Release 🎶
Welcome to the third official release of Musync! 🚀
Musync is a blazing-fast CLI application that allows you to stream your Spotify playlists completely free by sourcing official audio directly from YouTube.
What's New in v1.0.0:
- Zero-Setup Playback: Paste any public Spotify Playlist URL to start playing immediately—no Spotify account or login required!
- Interactive Playback UI: Perfectly synced progress bars and rich logging.
- Command Mode (
/): Press/during playback to instantly jump to another track or type a custom song name to play it mid-playlist. - Auto-Dependency Wizard: The app automatically installs
yt-dlpandffmpegin the background for you. No manual configuration needed. - Optional Spotify Login: Connect your own Spotify Developer App to securely fetch and play your private playlists by name.
How to Install (No Node.js Required)
- Go to the "Assets" section below.
- Download the executable file for your operating system:
- Mac (M1/M2/M3):
musync-mac-arm - Mac (Intel):
musync-mac-intel - Windows:
musync-windows.exe - Linux:
musync-linux
- Mac (M1/M2/M3):
- Open your terminal, navigate to your Downloads folder, and run the file!
(Note for Mac/Linux users: You may need to runchmod +x <filename>to make the file executable first).
v1.0.2: The Zero-Auth URL Release 🎶
Welcome to the third official release of Musync! 🚀
Musync is a blazing-fast CLI application that allows you to stream your Spotify playlists completely free by sourcing official audio directly from YouTube.
What's New in v1.0.0:
- Zero-Setup Playback: Paste any public Spotify Playlist URL to start playing immediately—no Spotify account or login required!
- Interactive Playback UI: Perfectly synced progress bars and rich logging.
- Command Mode (
/): Press/during playback to instantly jump to another track or type a custom song name to play it mid-playlist. - Auto-Dependency Wizard: The app automatically installs
yt-dlpandffmpegin the background for you. No manual configuration needed. - Optional Spotify Login: Connect your own Spotify Developer App to securely fetch and play your private playlists by name.
How to Install (No Node.js Required)
- Go to the "Assets" section below.
- Download the executable file for your operating system:
- Mac (M1/M2/M3):
musync-mac-arm - Mac (Intel):
musync-mac-intel - Windows:
musync-windows.exe - Linux:
musync-linux
- Mac (M1/M2/M3):
- Open your terminal, navigate to your Downloads folder, and run the file!
(Note for Mac/Linux users: You may need to runchmod +x <filename>to make the file executable first).
v1.0.1: The Zero-Auth URL Release 🎶
Welcome to the first official release of Musync! 🚀
Musync is a blazing-fast CLI application that allows you to stream your Spotify playlists completely free by sourcing official audio directly from YouTube.
What's New in v1.0.0:
- Zero-Setup Playback: Paste any public Spotify Playlist URL to start playing immediately—no Spotify account or login required!
- Interactive Playback UI: Perfectly synced progress bars and rich logging.
- Command Mode (
/): Press/during playback to instantly jump to another track or type a custom song name to play it mid-playlist. - Auto-Dependency Wizard: The app automatically installs
yt-dlpandffmpegin the background for you. No manual configuration needed. - Optional Spotify Login: Connect your own Spotify Developer App to securely fetch and play your private playlists by name.
How to Install (No Node.js Required)
- Go to the "Assets" section below.
- Download the executable file for your operating system:
- Mac (M1/M2/M3):
musync-mac-arm - Mac (Intel):
musync-mac-intel - Windows:
musync-windows.exe - Linux:
musync-linux
- Mac (M1/M2/M3):
- Open your terminal, navigate to your Downloads folder, and run the file!
(Note for Mac/Linux users: You may need to runchmod +x <filename>to make the file executable first).