{"id":15413292,"url":"https://github.com/lidel/google-music-hotkeys","last_synced_at":"2025-04-28T16:29:56.287Z","repository":{"id":25774685,"uuid":"106453507","full_name":"lidel/google-music-hotkeys","owner":"lidel","description":"Browser extension that adds keyboard control to Google / YouTube Music ","archived":false,"fork":false,"pushed_at":"2022-01-01T20:14:23.000Z","size":515,"stargazers_count":33,"open_issues_count":8,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-30T11:23:25.319Z","etag":null,"topics":["chrome-extension","chromium","firefox","firefox-extension","google-music","keyboard","playback-controls","webextension"],"latest_commit_sha":null,"homepage":"https://github.com/lidel/google-music-hotkeys#install","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lidel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-10T18:08:34.000Z","updated_at":"2025-03-14T14:58:12.000Z","dependencies_parsed_at":"2022-07-27T05:32:14.867Z","dependency_job_id":null,"html_url":"https://github.com/lidel/google-music-hotkeys","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lidel%2Fgoogle-music-hotkeys","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lidel%2Fgoogle-music-hotkeys/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lidel%2Fgoogle-music-hotkeys/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lidel%2Fgoogle-music-hotkeys/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lidel","download_url":"https://codeload.github.com/lidel/google-music-hotkeys/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251345618,"owners_count":21574750,"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":["chrome-extension","chromium","firefox","firefox-extension","google-music","keyboard","playback-controls","webextension"],"created_at":"2024-10-01T16:56:25.597Z","updated_at":"2025-04-28T16:29:56.268Z","avatar_url":"https://github.com/lidel.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# YouTube Music Hotkeys\n\n\u003e Browser extension that adds keyboard control to the web version of Google Podcasts or YouTube Music \n\n## Background\n\nI wanted to control background playback of YouTube Music (named Google Music at the time) without switching tabs.\nThat is all :-)\n\n## Install\n\n| Firefox                                                                                                                                                          | Chrome / Chromium                                                                                                                                                                              |\n| -------------                                                                                                                                                    | -------------                                                                                                                                                                                  |\n| [![Get the add-on](https://ipfs.io/ipfs/QmWNa64XjA78QvK3zG2593bSMizkDXXcubDHjnRDYUivqt)](https://addons.mozilla.org/en-US/firefox/addon/google-music-hotkeys-webext/) | [![](https://ipfs.io/ipfs/QmXeTTMAxJVSZLqNcVzBdsAZKhWUpP7w7QAZ8f3Bnmk3Mj)](https://chrome.google.com/webstore/detail/google-music-hotkeys/fgjkdpncbpnlhbdbmelbhmapblgaamkl) |\n\n## Features\n\n- works in Firefox and Chromium-based browsers\n- keyboard-based playback control\n    - toggle playback\n      \u003e default: \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003e8\u003c/kbd\u003e, visual hint: \u003ckbd\u003e*\u003c/kbd\u003e  \n      \u003e windows: \u003ckbd\u003eAlt\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003e8\u003c/kbd\u003e\n    - previous song\n      \u003e default: \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003e9\u003c/kbd\u003e, visual hint: \u003ckbd\u003e(\u003c/kbd\u003e  \n      \u003e windows: \u003ckbd\u003eAlt\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003e9\u003c/kbd\u003e\n    - next song:\n      \u003e default: \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003e0\u003c/kbd\u003e, visual hint: \u003ckbd\u003e)\u003c/kbd\u003e  \n      \u003e windows: \u003ckbd\u003eAlt\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003e0\u003c/kbd\u003e\n- **[option to customize default shortcuts](#how-to-customize-shortcuts)**\n- works with YouTube Music but also supports Google Podcasts (next/previous jump back/forward within current episode)\n- toolbar button\n    - regular click toggles playback\n    - context-click shows menu with other playback controls\n- open and pin YouTube Music if it is not open yet\n- try to build a new playlist when one hasn't been loaded yet\n- support for autoplay of bookmarks with `\u0026autoplay=true` parameter\n\n## How To Customize Shortcuts\n\n### Firefox\n\n\n1. Open `about:addons` → Google / YouTube Music Hotkeys_ → _Preferences_\n   - ..or just right-click the Browser Action:  \n     \u003e ![Right-click on Browser Action](https://user-images.githubusercontent.com/157609/39958925-24e00498-560a-11e8-937e-45bc8fbf43eb.png)\n3. Customize key bindings to your liking:\n   - Supported values are listed [here](https://developer.mozilla.org/en-US/Add-ons/WebExtensions/manifest.json/commands#Shortcut_values). Changes are saved automatically.\n     \u003e ![screenshot with old school shortcuts](https://user-images.githubusercontent.com/157609/39966689-5b7e9dce-56b0-11e8-886c-a98c2c3fef0e.png)\n   - The shortcut may be specified as one of the following media keys:\n     \u003ckbd\u003eMediaPlayPause\u003c/kbd\u003e, \u003ckbd\u003eMediaPrevTrack\u003c/kbd\u003e, \u003ckbd\u003eMediaNextTrack\u003c/kbd\u003e\n     \u003e ![screenshot with media key](https://user-images.githubusercontent.com/157609/39966694-6abf5b02-56b0-11e8-9ad4-ec1cde02bc29.png)\n   - Keep in mind that some shortcuts can be intercepted by regular desktop apps running on your system.\n     For example, on MS Windows \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003e0\u003c/kbd\u003e is hijacked by system itself – see [issue #3](https://github.com/lidel/google-music-hotkeys/issues/3).\n     If something does not work, try a different shortcut.\n   - Customization works in _Firefox 60 or later_. If you are using an older version please see [issue #1](https://github.com/lidel/google-music-hotkeys/issues/1) before reporting a new bug.\n   - Firefox does not provide API for setting _Global_ shortcuts (that work when browser window is not focused) yet: [Bug 1411795 - Add global keyboard shortcut support to commands API](https://bugzilla.mozilla.org/show_bug.cgi?id=1411795).\n4. That is all!\n\n### Chromium\n\nChromium-based browsers provide global UI for managing shortcuts of all extensions.\n\n1. Open `chrome://extensions/configureCommands`\n2. Customize key bindings to your liking\n3. You can optionally switch shortcut scope to _Global_:\n   \u003e ![peek 2017-11-28 19-44](https://user-images.githubusercontent.com/157609/33337860-a03f29f6-d474-11e7-88b9-748739b20725.gif)    \n    _Global_ shortcuts should work even when Chrome isn’t ‘in focus’.    \n    Keep in mind that _Global_ shortcuts can interfere with regular desktop app shortcuts.\n4. That is all!\n\n\n## Development\n\n\n```\nnpm ci\nnpm run build\nnpm run firefox\n```\n\n## License\n\n`Play_music_triangle.png` from https://commons.wikimedia.org/wiki/File:Play_music_triangle.svg\n\n[webextensions-lib-shortcut-customize-ui](https://github.com/piroor/webextensions-lib-shortcut-customize-ui) is [licensed under MIT](https://github.com/piroor/webextensions-lib-shortcut-customize-ui/blob/master/LICENSE)\n\nThe add-on itself is released under [CC0](LICENSE): to the extent possible under law, the author has waived all copyright and related or neighboring rights to this work, effectively placing it in the public domain.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flidel%2Fgoogle-music-hotkeys","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flidel%2Fgoogle-music-hotkeys","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flidel%2Fgoogle-music-hotkeys/lists"}