https://github.com/meskill/steelseries-browser-cinema
extension for steelseries drivers which allow to change profile on browser fullscreen mode
https://github.com/meskill/steelseries-browser-cinema
chrome chrome-extension gh-backup javascript sdk steelseries typescript
Last synced: 6 months ago
JSON representation
extension for steelseries drivers which allow to change profile on browser fullscreen mode
- Host: GitHub
- URL: https://github.com/meskill/steelseries-browser-cinema
- Owner: meskill
- License: gpl-3.0
- Created: 2021-05-15T08:48:09.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-10-08T07:24:55.000Z (about 3 years ago)
- Last Synced: 2025-04-14T21:13:54.574Z (6 months ago)
- Topics: chrome, chrome-extension, gh-backup, javascript, sdk, steelseries, typescript
- Language: TypeScript
- Homepage:
- Size: 1.52 MB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
Awesome Lists containing this project
README
# SteelSeries Browser Cinema Extension
Extension for Chromium-based browsers (Chromium, Chrome, Vivaldi, Edge, Yandex.Browser) that allows to setup reactions for your SteelSeries devices on event when browser enters fullscreen mode.
> Currently it works only with [SteelSeries GG](https://steelseries.com/gg) on Windows
## Why?
Having gaming devices with fancy RGB led feels great, but it might become annoying while you are trying to watch movies or youtube video. This extension just allows to setup your device settings when browsers enters fullscreen mode. When browsers leaves fullscreen your device settings will drop to previous state before fullscreen event.
## Setup
1. Make sure you have installed [Steelseries GG](https://steelseries.com/gg) and configured your device inside [Engine tab](https://steelseries.com/engine)
2. Install `StellSeries Browser Cinema` extension from [Chrome Store](https://chrome.google.com/webstore/detail/steelseries-browser-cinem/mndmnpnegjbnfakegcedmfccfiapdnhc/) or from [github releases page](https://github.com/meskill/steelseries-browser-cinema/releases)
3. Navigate to `chrome://extensions` and click "Details" on the newly installed extension.
4. Scroll down and make sure the "Allow access to file URLs" is enabled.
5. Inside [Engine -> Apps Tab in SteelSeries GG](https://steelseries.com/engine/apps) should appear new game named `Browser Cinema`
6. Go into `Browser Cinema` game
7. Choose `Event in Game -> FULLSCREEN`
8. Here you can setup your device reaction for browser fullscreen mode (I prefer to set it all to single black color that mean led will be turned off completely)
9. Repeat device set up for every of your devices
### Screenshots
## Caveats
- Currently supports only `Windows`
- Only default `SteelSeries GG` installation is supported (inside `C:/ProgramData/SteelSeries/SteelSeries Engine 3/`)
- The extension only works for web pages opened in fullscreen only for browser with enabled extension
## Troubleshooting
### Cannot find game `Browser Cinema`
Try to reinstall extension as game is registered only on extension install
### Device state doesn't reflect browser mode
Make sure `SteelSeries GG` is running and extension is enabled in browser
### No answer on my question
Please create Issue on [GitHub](https://github.com/meskill/steelseries-browser-cinema/issues) with detailed report
## How does it work
### Docs
- [How to write Chrome Extension](https://developer.chrome.com/docs/extensions/mv3/getstarted/)
- [SteelSeries SDK](https://github.com/SteelSeries/gamesense-sdk)
### Internals
1. Extension is trying to load info about running `SteelSeries Plugin Server` from file `C:/ProgramData/SteelSeries/SteelSeries Engine 3/`
2. On installation extension register new game `Browser Cinema` in `SteelSeries Plugin Server`
3. When browser changes its fullscreen mode the extensions send event `Fullscreen` to `SteelSeries Plugin Server`
## Related Projects
- [Mystic Light Browser Cinema](https://github.com/meskill/mystic-light-browser-cinema) - similar extension but only for Mystic Light devices
- [Steelseries Youtube Addon](https://github.com/AeTher97/Steelseries_Youtube_Addon)
## Credits
### Icons
Icons made by [Freepik](https://www.freepik.com) from [www.flaticon.com](https://www.flaticon.com/)
## Donations
### YooMoney
### Webmoney
[Webmoney Site](https://www.web.money/eng/) - you have to be registered in order to send money.
- WMZ: `Z389219879720`
- WMX: `1F1RonGM2SEA6YpfAdZb8fwRhXyi3cHeoa`