{"id":13588403,"url":"https://github.com/xzzz9097/Muse","last_synced_at":"2025-04-08T03:33:52.983Z","repository":{"id":68402357,"uuid":"75010511","full_name":"xzzz9097/Muse","owner":"xzzz9097","description":"An open-source Spotify controller with TouchBar support","archived":false,"fork":false,"pushed_at":"2019-07-02T16:29:39.000Z","size":23012,"stargazers_count":636,"open_issues_count":35,"forks_count":41,"subscribers_count":30,"default_branch":"master","last_synced_at":"2025-04-05T17:05:50.634Z","etag":null,"topics":["applescript","itunes","music","remote","spotify","swift","touchbar","vox"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xzzz9097.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-11-28T20:15:16.000Z","updated_at":"2025-03-30T13:53:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"5774a13d-8902-4791-9fe3-3fe53e47b0b2","html_url":"https://github.com/xzzz9097/Muse","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xzzz9097%2FMuse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xzzz9097%2FMuse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xzzz9097%2FMuse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xzzz9097%2FMuse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xzzz9097","download_url":"https://codeload.github.com/xzzz9097/Muse/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247772891,"owners_count":20993627,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["applescript","itunes","music","remote","spotify","swift","touchbar","vox"],"created_at":"2024-08-01T15:06:41.641Z","updated_at":"2025-04-08T03:33:52.928Z","avatar_url":"https://github.com/xzzz9097.png","language":"Swift","funding_links":[],"categories":["Swift","Applications","Table of Contents:","Touch Bar"],"sub_categories":["Touch Bar","Audio","Productivity:","Text","📦 Touch Bar (6)"],"readme":"## \u003cimg src=Muse/Resources/Assets.xcassets/AppIcon.appiconset/icon-512@2x.png width=\"32\"\u003e Muse\n\nAn open-source Spotify, iTunes and Vox controller with TouchBar support, system-wide TouchBar controls (à la iTunes) and Spotify account integration.\n\n### Download and screenshots\n[Website](https://xzzz9097.github.io)\n\n### Control strip integration\nMuse 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.\n\n### Installation\nThe app is not code signed, so after trying to open it unsuccessfully (because of GateKeeper) head to System Preferences -\u003e Security \u0026 Privacy and manually grant it permission.\nAt 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.\n\n### Usage\nSummon it with \u003ckbd\u003econtrol\u003c/kbd\u003e + \u003ckbd\u003ecommand\u003c/kbd\u003e + \u003ckbd\u003es\u003c/kbd\u003e\nYou'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 \u003ckbd\u003ecommand\u003c/kbd\u003e + \u003ckbd\u003eq\u003c/kbd\u003e or \u003ckbd\u003eesc\u003c/kbd\u003e to quit the app.\nSystem-wide now playing controls are also accessible from the leftmost button of the control strip, just like iTunes and Safari ones.\nSpotify, 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.\n\n### Keyboard shortcuts\nSeveral handy shortcuts are provided when the popup window is open:\n\n|                Keystroke                |        Action         |\n|:---------------------------------------:|:---------------------:|\n|    \u003ckbd\u003es\u003c/kbd\u003e and \u003ckbd\u003espace\u003c/kbd\u003e    |   toggle play/pause   |\n| \u003ckbd\u003ea\u003c/kbd\u003e and \u003ckbd\u003eleft arrow\u003c/kbd\u003e  |    previous track     |\n| \u003ckbd\u003ed\u003c/kbd\u003e and \u003ckbd\u003eright arrow\u003c/kbd\u003e |      next track       |\n|              \u003ckbd\u003ew\u003c/kbd\u003e               | focuses player window |\n|              \u003ckbd\u003er\u003c/kbd\u003e               |   toggles repeating   |\n|              \u003ckbd\u003ex\u003c/kbd\u003e               |   toggles shuffling   |\n|              \u003ckbd\u003el\u003c/kbd\u003e               |      likes track      |\n|              \u003ckbd\u003ei\u003c/kbd\u003e               |      shows title      |\n|              \u003ckbd\u003e1\u003c/kbd\u003e               |   controls Spotify    |\n|              \u003ckbd\u003e2\u003c/kbd\u003e               |    controls iTunes    |\n|              \u003ckbd\u003e3\u003c/kbd\u003e               |     controls Vox      |\n\n### Build\nThe project is not code-signed, just clone the repository, install the pods and open the workspace file.\n```\ngit clone https://github.com/xzzz9097/Muse \u0026\u0026 cd Muse/ \u0026\u0026 pod install \u0026\u0026 open Muse.xcworkspace\n```\n\n### Libraries\n- [SpotifyKit](https://github.com/xzzz9097/SpotifyKit) by @xzzz9097\n- [NSImageColors](https://github.com/xzzz9097/NSImageColors) by @jathu\n- [DDHotKey](https://github.com/davedelong/DDHotKey) by @davedelong\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxzzz9097%2FMuse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxzzz9097%2FMuse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxzzz9097%2FMuse/lists"}