Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pineappleionic/borealisos
A SteamOS 3.0 plugin and customisation framework built using NodeJS.
https://github.com/pineappleionic/borealisos
modification nodejs plugin react steam steamdeck steamos
Last synced: 23 days ago
JSON representation
A SteamOS 3.0 plugin and customisation framework built using NodeJS.
- Host: GitHub
- URL: https://github.com/pineappleionic/borealisos
- Owner: PineappleIOnic
- Created: 2022-04-04T12:59:34.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-07-30T09:30:44.000Z (over 2 years ago)
- Last Synced: 2024-10-04T13:32:55.510Z (about 1 month ago)
- Topics: modification, nodejs, plugin, react, steam, steamdeck, steamos
- Language: CSS
- Homepage:
- Size: 277 KB
- Stars: 13
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
BorealisOS
A SteamOS 3.0 plugin and customisation framework built using NodeJS.
DISCLAIMER (READ ME!)
```
BorealisOS is a plugin manager that gives (currently) unrestricted access to SteamOS's JavaScript instance.
Valve binds all SteamOS system functions to this JavaScript instance. Treat installing BorealisOS plugins like installing
apps that require administrator rights because they quite literally can perform administrator actions without you even
knowing.
Make sure you review all plugins you install and DO NOT install any plugins you do not inherently trust. Anything with
obfuscation or not very readable code is a big red flag. It would take not even 20 lines of JavaScript to steal your
account token and factory reset the device.
We are not responsible for any device damage caused by using BorealisOS.
```
Installation
BorealisOS is currently under heavy development and is not suggested for general use.
__BorealisOS requires CEF Debugging to be enabled within the Developer settings__
If you still want to install BorealisOS, you can do so by running the following command:
```sh
curl -s -L https://github.com/borealisOS/borealisOS/raw/main/install.sh | sudo sh
```
This installer installs a service for borealisOS which will make it autolaunch on start up, you can disable this by running the following command:
```sh
sudo systemctl disable borealis
```
You can also uninstall borealisOS by running the following command:
```sh
curl -s -L https://github.com/borealisOS/borealisOS/raw/main/uninstall.sh | sudo sh
```
This installer and uninstaller only supports the Steam Deck, for other platforms clone the repo and run `npm install` followed by `node src/index.js`.
## Developing
We recommend having [VSCode's Remote Explorer extension](https://code.visualstudio.com/docs/remote/ssh) for developing BorealisOS on SteamDeck hardware.
You can also develop on the PUBLIC-PAL build of Steam if you like to keep everything local or don't have a SteamDeck to develop on.
## Credits
BorealisOS would not be possible without the following people:
- [marios8534](https://github.com/marios8543) For creating the initial steamOS UI Inject. This opened my eyes to what was possible using CEF's debugging API and SteamOS.
- [The SteamDeckHomebrew team](https://github.com/SteamDeckHomebrew) For continuing the work from marios8534's initial UI Inject.
- [Jake 'sid' Smith](https://github.com/JakeSidSmith) For his excellent article on monkey patching React.