Skip to content

RanRhoads84/apple-music-desktop

 
 

Repository files navigation

Apple Music Desktop  

An Electron app that provides a native Apple Music experience for Linux.

Features

  • Native desktop experience for Apple Music on Linux
  • Tray icon with playback controls (Play/Pause, Next, Previous, Show/Minimize, Quit)
  • Customizable menu with settings for theme, start tab, and more
  • Mini Player mode
  • About window showing app, Electron, Chromium, Node, and V8 versions
  • Logging and configuration management
  • Support for multiple package formats (zip, deb, AppImage, snap, nsis, dmg, etc.)

Screenshot

Screenshot

Installation

See the Releases page for pre-built Linux binaries.

Notes:

  • AppImage: Make the file executable and run it. On most distros: chmod +x apple-music_2.2.0_x86_64.AppImage then ./apple-music_2.2.0_x86_64.AppImage.
  • DEB: Install with your package manager on Ubuntu 25.10 or compatible derivatives.
  • Snap: Install via snap install --dangerous apple-music_2.2.0_amd64.snap or from the Snap Store if available.

Building

Requires Node.js 16 or 18. It is recommended to use nvm for managing Node versions.

git clone https://github.com/Alex313031/apple-music-desktop.git
cd apple-music-desktop
nvm install        # Only if using nvm
npm install        # Install dependencies
npm run start      # Run app in dev mode

Packaging

To build distributable packages:

npm run build      # Build unpacked app
npm run dist       # Build distributable packages

See build.sh for additional build and packaging scripts.

Configuration

  • App settings are stored using electron-store.
  • Configuration file: config.json in the user data directory.
  • Logging is available and can be enabled/disabled via the menu.

License

BSD 3-Clause License Copyright © 2024-2025 Alex313031

See LICENSE.md for details.

Credits

  • Developer: Alex313031
  • Thanks to: ciderapp, sindresorhus, castlabs, electronjs

See humans.txt for more.

TODO

See TODO.txt

About

An Electron app that provides a native Apple Music experience for Linux & Windows.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • JavaScript 84.9%
  • Shell 8.7%
  • HTML 4.6%
  • CSS 1.8%