Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lidel/google-music-hotkeys
Browser extension that adds keyboard control to Google / YouTube Music
https://github.com/lidel/google-music-hotkeys
chrome-extension chromium firefox firefox-extension google-music keyboard playback-controls webextension
Last synced: 2 months ago
JSON representation
Browser extension that adds keyboard control to Google / YouTube Music
- Host: GitHub
- URL: https://github.com/lidel/google-music-hotkeys
- Owner: lidel
- License: cc0-1.0
- Created: 2017-10-10T18:08:34.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2022-01-01T20:14:23.000Z (about 3 years ago)
- Last Synced: 2024-12-13T03:14:38.420Z (2 months ago)
- Topics: chrome-extension, chromium, firefox, firefox-extension, google-music, keyboard, playback-controls, webextension
- Language: JavaScript
- Homepage: https://github.com/lidel/google-music-hotkeys#install
- Size: 503 KB
- Stars: 32
- Watchers: 3
- Forks: 5
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# YouTube Music Hotkeys
> Browser extension that adds keyboard control to the web version of Google Podcasts or YouTube Music
## Background
I wanted to control background playback of YouTube Music (named Google Music at the time) without switching tabs.
That is all :-)
## Install
| Firefox | Chrome / Chromium |
| ------------- | ------------- |
| [](https://addons.mozilla.org/en-US/firefox/addon/google-music-hotkeys-webext/) | [](https://chrome.google.com/webstore/detail/google-music-hotkeys/fgjkdpncbpnlhbdbmelbhmapblgaamkl) |
## Features
- works in Firefox and Chromium-based browsers
- keyboard-based playback control
- toggle playback
> default: Ctrl+Shift+8, visual hint: *
> windows: Alt+Shift+8
- previous song
> default: Ctrl+Shift+9, visual hint: (
> windows: Alt+Shift+9
- next song:
> default: Ctrl+Shift+0, visual hint: )
> windows: Alt+Shift+0
- **[option to customize default shortcuts](#how-to-customize-shortcuts)**
- works with YouTube Music but also supports Google Podcasts (next/previous jump back/forward within current episode)
- toolbar button
- regular click toggles playback
- context-click shows menu with other playback controls
- open and pin YouTube Music if it is not open yet
- try to build a new playlist when one hasn't been loaded yet
- support for autoplay of bookmarks with `&autoplay=true` parameter
## How To Customize Shortcuts
### Firefox
1. Open `about:addons` → Google / YouTube Music Hotkeys_ → _Preferences_
- ..or just right-click the Browser Action:
> 
3. Customize key bindings to your liking:
- Supported values are listed [here](https://developer.mozilla.org/en-US/Add-ons/WebExtensions/manifest.json/commands#Shortcut_values). Changes are saved automatically.
> 
- The shortcut may be specified as one of the following media keys:
MediaPlayPause, MediaPrevTrack, MediaNextTrack
> 
- Keep in mind that some shortcuts can be intercepted by regular desktop apps running on your system.
For example, on MS Windows Ctrl+Shift+0 is hijacked by system itself – see [issue #3](https://github.com/lidel/google-music-hotkeys/issues/3).
If something does not work, try a different shortcut.
- 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.
- 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).
4. That is all!
### Chromium
Chromium-based browsers provide global UI for managing shortcuts of all extensions.
1. Open `chrome://extensions/configureCommands`
2. Customize key bindings to your liking
3. You can optionally switch shortcut scope to _Global_:
> 
_Global_ shortcuts should work even when Chrome isn’t ‘in focus’.
Keep in mind that _Global_ shortcuts can interfere with regular desktop app shortcuts.
4. That is all!
## Development
```
npm ci
npm run build
npm run firefox
```
## License
`Play_music_triangle.png` from https://commons.wikimedia.org/wiki/File:Play_music_triangle.svg
[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)
The 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.