Skip to content

2latemc/JustAnotherMusicClient

Repository files navigation

A desktop YouTube Music client built with Tauri, React, and TypeScript for Windows & (experimental) MacOs.

IMPORTANT

This is an independent, unofficial project and is not affiliated with, authorized by, sponsored by, or endorsed by YouTube or Google. The only reason I am making this, is becuase there is no official YouTube music desktop client.

If you like this project, starring it on Github would help A LOT!

About ℹ️

JustAnotherMusicClient brings YouTube Music to the desktop in a focused, native-feeling application. YouTube does not provide an official desktop client, so this project aims to provide a polished alternative that integrates with YouTube Music while keeping the experience fast and familiar.

Contact for legal purposes: team@2late.org



Features ✨

Feature Description
Multiple Tabs Create multiple music tabs, each with its own playback queue, volume, and player state
Caching Playlists, lyrics, and more are cached for significantly faster performance
Recommendations Home Tab with personalized song sugesstions and a "random" shuffle wheel, just like on the mobile client
Synced Lyrics Real-time synced lyrics, not even available on the official client
YouTube Music Integration Browse, search, and play music via an integrated search bar
Account Support Sign in to access your library, playlists, recommendations, and other account features
Song Management Add songs to playlists or queue quickly via Ctrl+S or right-click

Download ⏬

Download the newest available installer from the latest release for either Windows or MacOs. Screenshot

Roadmap 📌

  • Full Linux and MacOS support
  • Better lyrics consistency (some songs still don't have them)
  • Artist Pages with monthly listeners, playlists and popular songs alongside streams amount feature when clicking on the artist name, also integrate into the search results so that one can find artists
  • Liked songs playlist support
  • Discord RCP is coming
  • App Auto-Update so that you don't manually have to check for changes
  • Maximize Button + An option for Windows-style window controls
  • Start App on boot option
  • Raycast support with app specific URLs
  • Fix Windows media player controls sometimes not working
  • Music Video support
  • Add to startup option
  • Space to pause sometimes selects elements instead of pausing / resuming
  • Cap Too long Song names and make them smoothly move vertically

Platform Support 💻

  • Windows is the primary supported platform.
  • macOS support is experimental, currently there are heavy playback issues on MacOS that I am actively working on.
  • Linux support is in the working. This should take a few days until it's implemented!

MacOs Issues

MacOs may prompt you with a Keychain popup asking for permission. The app stores one encryption key in its own Keychain entry. Your YouTube Music session is encrypted with that key before it is saved in the app data directory.

If you do not need signing into YouTube Music you dont need to grant Keychain permissions. If you do it is recommended to click "always allow" in the popup to prevent MacOs from being annoying

Third-Party Services

If anyone from Google reads this: There was no official client, I just wanted a good desktop client. Thats why I made this, please don't sue me! Contact me here: team@2late.org

The application interacts with YouTube and YouTube Music. Access to those services remains governed by their respective terms, policies, availability, and regional restrictions.

JustAnotherMusicClient does not host or claim ownership of music, videos, artwork, metadata, or other content supplied by third parties. Rights in that content remain with their respective owners.

The project is not intended to circumvent access controls, geographic restrictions, advertising, paid service requirements, or content licensing. It is also not intended to enable unauthorized downloading, copying, redistribution, or public performance of third-party content.

YouTube and YouTube Music are trademarks of Google LLC. All other trademarks are the property of their respective owners. References to third-party products are used only to describe compatibility and integration.

For Developers 🛠️

Prerequisites

Install these before running the app:

  • Node.js LTS and npm
  • Rust and Cargo
  • Windows C++ build tools
  • Microsoft Edge WebView2 Runtime

The Tauri CLI is included in the project's development dependencies. A global Tauri installation is not required.

Install

npm install

Run

npm run tauri dev

Build

npm run tauri build

Contributing

Contributions are welcome. Fork the repository, create a branch for your change, test it locally, and open a pull request with a clear description of what you changed and why.

By submitting a contribution, you agree to the Contributor License Agreement. You retain copyright in your contribution while granting the project owner the rights needed to use, modify, distribute, commercialize, and relicense it.

For larger changes, consider opening an issue first so the approach can be discussed before implementation.

Common Issues

Rust is not installed

Install Rust and Cargo from rustup.rs, restart your terminal, and run the command again.

WebView2 is missing

Install the Microsoft Edge WebView2 Runtime, then run the app again.

About

A desktop music client that integrates with YouTube Music for Windows and MacOS. Independent and not affiliated with, endorsed by, or sponsored by YouTube or Google.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors