Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xzzz9097/Muse
An open-source Spotify controller with TouchBar support
https://github.com/xzzz9097/Muse
applescript itunes music remote spotify swift touchbar vox
Last synced: about 1 month ago
JSON representation
An open-source Spotify controller with TouchBar support
- Host: GitHub
- URL: https://github.com/xzzz9097/Muse
- Owner: xzzz9097
- Created: 2016-11-28T20:15:16.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-07-02T16:29:39.000Z (over 5 years ago)
- Last Synced: 2024-10-30T10:07:05.783Z (about 1 month ago)
- Topics: applescript, itunes, music, remote, spotify, swift, touchbar, vox
- Language: Swift
- Size: 21.9 MB
- Stars: 636
- Watchers: 31
- Forks: 41
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- open-source-mac-os-apps - Muse - Spotify controller with TouchBar support. ![swift_icon] (Applications / Touch Bar)
- open-source-mac-os-apps - Muse - Spotify controller with TouchBar support. ![swift_icon] (Applications / Touch Bar)
- awesome-swift-macos-apps - Muse - Spotify controller with TouchBar support. (Touch Bar / Text)
- awesome-swift-macos-apps - Muse - Spotify controller with TouchBar support. (Touch Bar / Text)
README
## 
Muse
An open-source Spotify, iTunes and Vox controller with TouchBar support, system-wide TouchBar controls (à la iTunes) and Spotify account integration.
### Download and screenshots
[Website](https://xzzz9097.github.io)
### Control strip integration
Muse appends a permanent button to the control strip (right tray bar) of the TouchBar, displaying album art and playback time. You can tap it to reveal the full control bar, long press it to toggle play/pause and swipe on it to jump to next or previous track.
### Installation
The app is not code signed, so after trying to open it unsuccessfully (because of GateKeeper) head to System Preferences -> Security & Privacy and manually grant it permission.
At first start you'll be prompted to log into your Spotify account. It's not strictly necessary but it allows adding/removing favourites to your library.
### Usage
Summon it with control + command + s
You'll be greeted with an album art window in the middle of the screen, and the playback controls on your TouchBar. Pressing the hotkey one more time makes them both disappear, and they also auto-hide when you focus another application. Bring up the window and press command + q or esc to quit the app.
System-wide now playing controls are also accessible from the leftmost button of the control strip, just like iTunes and Safari ones.
Spotify, iTunes and Vox are currently supported. The app automatically guesses the right player to control basing on availability and playback notifications, but you can manually toggle them with the shortcuts described below.
### Keyboard shortcuts
Several handy shortcuts are provided when the popup window is open:
| Keystroke | Action |
|:---------------------------------------:|:---------------------:|
| s and space | toggle play/pause |
| a and left arrow | previous track |
| d and right arrow | next track |
| w | focuses player window |
| r | toggles repeating |
| x | toggles shuffling |
| l | likes track |
| i | shows title |
| 1 | controls Spotify |
| 2 | controls iTunes |
| 3 | controls Vox |
### Build
The project is not code-signed, just clone the repository, install the pods and open the workspace file.
```
git clone https://github.com/xzzz9097/Muse && cd Muse/ && pod install && open Muse.xcworkspace
```
### Libraries
- [SpotifyKit](https://github.com/xzzz9097/SpotifyKit) by @xzzz9097
- [NSImageColors](https://github.com/xzzz9097/NSImageColors) by @jathu
- [DDHotKey](https://github.com/davedelong/DDHotKey) by @davedelong