mirror of
https://github.com/hensm/fx_cast.git
synced 2026-06-09 17:19:59 +00:00
66 lines
2.2 KiB
Markdown
66 lines
2.2 KiB
Markdown
# fx_cast
|
|
|
|
Very WIP! Not ready for release. Expect many bugs. Please don't sign builds on AMO with current ID.
|
|
|
|
Credit:
|
|
* [electron-chromecast](https://github.com/GPMDP/electron-chromecast)
|
|
* [node-castv2](https://github.com/thibauts/node-castv2)
|
|
* [chrome-native-messaging](https://github.com/jdiamond/chrome-native-messaging)
|
|
|
|
## Supported platforms
|
|
|
|
* Linux
|
|
* macOS
|
|
* Windows (TODO)
|
|
|
|
Only tested on Linux. mDNS library issue to be fixed. `mdns` only works on Windows, `mdns-js` only works on Linux.
|
|
|
|
|
|
## Building
|
|
|
|
### Requirements
|
|
|
|
* NodeJS
|
|
* `node` binary in path
|
|
* ~~Bonjour SDK (Windows)~~
|
|
|
|
### Instructions
|
|
|
|
````sh
|
|
git clone https://github.com/hensm/caster.git
|
|
npm install
|
|
npm run build
|
|
npm run install-manifest
|
|
````
|
|
|
|
### Testing
|
|
|
|
Testing requires geckodriver (or chromedriver for Chrome parity testing). See [selenium-webdriver](https://www.npmjs.com/package/selenium-webdriver#installation) installation instructions (ignore `npm install`).
|
|
|
|
Chrome doesn't load the media router in a temporary selenium profile, so there's a bundled profile (`test/ChromeProfile.zip`). Extract the folder within as `test/ChromeProfile/`.
|
|
|
|
````sh
|
|
npm run build
|
|
npm test
|
|
SELENIUM_BROWSER=chrome npm test
|
|
````
|
|
|
|
|
|
## Usage
|
|
|
|
Extension can be loaded from `about:debugging` as a temporary extension.
|
|
|
|
Most sites won't load the cast API unless the browser presents itself as Chrome. The plan is to spoof the user agent string for a whitelist of cast-enabled sites, but that isn't implemented yet. You can workaround this by setting it manually or using a [third-party extension](https://addons.mozilla.org/en-US/firefox/search/?q=user+agent).
|
|
|
|
HTML5 media elements have a "Cast..." context menu item that triggers a sender application. Only works on remote (non-local) media that isn't DRM-encumbered.
|
|
|
|
Cast-enabled websites will load the sender API shim and display a cast button as in Chrome, provided there are no bugs/incompatibilities with the shim.
|
|
|
|
|
|
## Video Demos
|
|
|
|
Netflix / HTML5:
|
|
|
|
[<img width="200" src="https://img.youtube.com/vi/Ex9dWKYguEE/0.jpg" alt="fx_cast Netflix" />](https://www.youtube.com/watch?v=Ex9dWKYguEE)
|
|
[<img width="200" src="https://img.youtube.com/vi/16r8lQKeEX8/0.jpg" alt="fx_cast HTML5" />](https://www.youtube.com/watch?v=16r8lQKeEX8)
|