Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tuxtheastronaut/amdesktop
A simple wrapper for Apple Music webplayer to let you listen to your Apple Music Libary on the Linux Desktop
https://github.com/tuxtheastronaut/amdesktop
apple electron linux-desktop music
Last synced: 18 days ago
JSON representation
A simple wrapper for Apple Music webplayer to let you listen to your Apple Music Libary on the Linux Desktop
- Host: GitHub
- URL: https://github.com/tuxtheastronaut/amdesktop
- Owner: TuxTheAstronaut
- License: gpl-3.0
- Created: 2024-10-02T00:01:49.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-12-17T04:16:47.000Z (22 days ago)
- Last Synced: 2024-12-17T05:21:15.993Z (22 days ago)
- Topics: apple, electron, linux-desktop, music
- Language: JavaScript
- Homepage:
- Size: 511 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🍏 Apple Music Desktop App For Linux 🎵
### listen to your Apple Music library on the Linux desktop
### ❔ How it works ❔
AM Desktop is an Electron-based wrapper that gives the [Apple Music](https://music.apple.com/) web player a face lift,
making it resemble a desktop app and integrating seamlessly into your desktop.
#### System Tray
By default the window closes to the system tray allowing you to keep playing your music in the background.
However not all desktops may support this functionality.
You can disable the tray by setting a environment variable or launch argument:
```bash
# Environment variable
NO_TRAY=true
# Launch argument
--no-tray
```
#### Window Transparency
By default the window is transparent allowing for rounded corners on the window.
However this may cause issues on certain desktops or if running on xwayland.
You can disable this by setting a environment variable or launch argument:
```bash
# Environment variable
NO_TRANSPARENT=true
# Launch argument
--no-transparent
```
#### Wayland
If the app launches under xwayland and you want to use wayland you can set the following environment variable:
```bash
ELECTRON_OZONE_PLATFORM_HINT=wayland
```
### ⚠️ Known Issues ⚠️
* passkey sign-in currently does not work.
* some drop down context menus do not work.
## Developing
To clone and run this repository you'll need [Git](https://git-scm.com) and [Node.js](https://nodejs.org/en/download/) (which comes with [npm](http://npmjs.com)) installed on your computer. From your command line:
```bash
# Clone this repository
git clone https://github.com/TuxTheAstronaut/AMdesktop.git
# Go into the repository
cd AMdesktop
# Install dependencies
npm install
# Run the app
npm start
# Build the app
npm run build