Chrome extension to send "global" (ie. across the browser) hotkeys to various online media players.
It is available on the Chrome Store:
https://chrome.google.com/webstore/detail/streamkeys/ekpipjofdicppbepocohdlgenahaneen?hl=en
- Node.js
Clone the repo and then install dependencies:
$ npm install
Then to build the extension in watch mode, run:
$ npm run develop
In Chrome, load the unpacked extension from build/unpacked-dev/
.
-
npm test
: Run unit tests. -
npm run develop
: Lintscode/*
, runs browserify, copies built code tobuild/unpacked-dev/
andtest/streamkeys-ext/
in watch mode -
npm run grunt:dev
: Lintscode/*
, runs browserify and copies built code tobuild/unpacked-dev/
andtest/streamkeys-ext/
-
npm run grunt:rel
: Lintscode/*
, runs browserify and uglify and copies built code tobuild/unpacked-prod/
andtest/streamkeys-ext/
-
npm run grunt:watch
: Watches for changes to JS files incode/*
, lintscode/*
, runs browserify and copies built code tobuild/unpacked-dev/
-
npm run grunt:lint
: Lintscode/*
This extension works by sending click events to the elements that control the music player. Each music site has an associated controller which contains the css selectors for the play/pause/next/previous/mute buttons (where available). In addition there is a BaseController
module which contains common functions that are shared across all controllers.
The background script routes hotkey presses from the user to the correct tab (ie., the media player(s) tab) if the media player site is enabled.
Adding a new site to the extension is straight forward. There are 3 steps:
Figure out the css selectors for a site's media player buttons and create a new controller in code/js/controllers/
. Naming scheme is {Sitename}Controller.js
. You should copy code from an exisiting controller as a template. Here is an example controller for Fooplayer:
Filename: FooplayerController.js
"use strict";
(function() {
var BaseController = require("BaseController");
new BaseController({
playPause: "#play_btn",
playNext: "#next_btn",
playPrev: "#prev_btn",
mute: "#mute_btn",
playState: "#play_btn.playing",
song: "#song",
artist: "#artist"
});
})();
buttonSwitch
- Used to determine playing state. Set totrue
if a site only shows the pause button when it's playing and only shows the play button when it's paused.playState
- Used to determine playing state. Set to the selector that will returntrue
if the player is playing. Example:playState: "#play_btn.playing"
iframe
- Used when the player is nested inside an iframe. Set to the selector of the iframe containing the player. Example:iframe: "#player-frame"
Note: One of buttonSwitch
or playState
should (almost) always be set. If buttonSwitch
is true then your controller must define both play
and pause
selectors. If a playState
is defined, then you controller might have either a single playPause
selector or both play
and pause
selectors.
Next, add the site to the Sitelist object in code/js/modules/Sitelist.js
.
"fooplay": { name: "Fooplay", url: "https://www.fooplayer.com" }
The object key name is very important. It serves two purposes: constructs the site's controller name as well as builds the regular expression which will be used to check URLs to inject the controller into. It is important that the url is correct, and that the object's key name is contained in the URL.
If it is not possible for the object's key name to be part of the sites URL then you can add the optional alias
array field to the object which will add the array's contents into the regular expression to match URLs. For example, for lastFM:
"last": { name: "LastFm", url: "https://www.last.fm", controller: "LastfmController.js", alias: ["lastfm"] }
the alias here will match URLs: last.* AND lastfm.*
The logic to construct the controller name is: Capitalized object key + "Controller". So, using the above example we should name our LastFM controller: "LastController" based on that key name.
If it is not possible for the controller file to be named according to that scheme then add the optional controller
property to the site object and put the FULL controller name there, for example: "SonyMusicUnlimitedController.js"
There is a Karma test suite that simulates core extension functionality. The automated Travis-CI will trigger on every pull request/push.
To run the tests locally, simply
$ npm test
On Linux you can enable basic MPRIS support in options. Currently, this requires
single player mode
to be enabled. It requires an extra host script to be
installed. The host script currently supports Chromium, Google Chrome and Brave.
To install the host script, run the following commands:
$ extension_id="ekpipjofdicppbepocohdlgenahaneen"
$ installer=$(find $HOME/.config -name "mpris_host_setup.py" | grep ${extension_id})
$ python3 "${installer}" install ${extension_id}
A restart of the browser is necessary to load the changes.
To uninstall the host script, run the following commands:
$ extension_id="ekpipjofdicppbepocohdlgenahaneen"
$ installer=$(find $HOME/.config -name "mpris_host_setup.py" | grep ${extension_id})
$ python3 "${installer}" uninstall
Copyright (c) 2018 Alex Gabriel under the MIT license.