Skip to content

Repository files navigation

logo

Run apps in Borealis using emulated AUR helpers, Flatpak, Git, Python, and GCC for signficantly higher performance than Crostini!

With Steam support ending in 2026, a new project is here!
Run Steam games and apps natively in ChromeOS with GUI, audio, and full GPU acceleration:

https://github.com/shadowed1/Chard/blob/main/README.md

Aurora Requirements:

  • ChromeOS
  • Steam installed and open (log in not required)
  • Steam (Borealis) VM can be enabled in chrome://flags for x86 users if below hardware requirements.

How to install:

  • Run Steam app and keep it open to prevent Borealis VM from shutting down.

  • Open Crosh (ctrl-alt-t) and type in:
    vsh borealis

  • Copy Paste in borealis shell:

bash <(curl -s "https://raw.githubusercontent.com/shadowed1/Aurora/main/aurora_installer.sh?$(date +%s)")

Aurora needs Borealis; it won't work anywhere else.



Features:

  • Fantastic hardware acceleration for all apps; even unsupported web browsers.
  • Steam can be closed entirely as long as an app is running.
  • Borealis shell tabs automatically initiate Flatpak support.
  • Tweak display scaling and cursor size.
  • Change default apps, generate shortcuts and icons, and download + extract tar files.
  • Emulate pacman, yay, pacaur, and paru to download packages from arch repo directly.
  • Uninstaller is able to clean up after itself.



Minecraft Java with Prism Launcher @ 2160p:

logo



How to use:


Commands with examples:

aurora # Show current display and cursor values
aurora display 1.0 # Set display scaling factor (0.25 - 4.0)
aurora cursor 32 # Set cursor size (8 - 200)
aurora help # Show help
aurora version # Check for updates and what version you are on.
aurora_debug # echo a list of paths that flatpak will use
aurora reinstall # Redownload Aurora from Github
aurora uninstall # Launch uninstaller
aurora shortcut # Create desktop shortcuts

starman # Open GUI app launcher
starman refresh # Update app list

starman # Open quick access menu
starman default # Menu to set default apps
starman reset # Remove app entries in quick access menu

pacman https://archlinux.org/packages/extra/x86_64/libvlc/
pacman vlc

flatpak list # Show list of installed apps
flatpak --help # flatpak has a lot of commands!

flatpak search Discord
flatpak install com.discordapp.Discord
flatpak run com.discordapp.Discord

Failed to connect to bus error it must be run like example below:

Visual Studio:
flatpak search visualstudio
flatpak install com.visualstudio.code
flatpak run --command=sh com.visualstudio.code
/app/bin/code --no-sandbox 2>/dev/null

Brave browser:
flatpak search Brave
flatpak install com.brave.Browser
flatpak run --command=sh com.brave.Browser
/app/brave/brave --no-sandbox --no-zygote --disable-gpu-sandbox --disable-features=UsePortal &
Various Options:
--no-sandbox --no-zygote --disable-gpu-sandbox --disable-features=UsePortal

Use ls /app/bin to help find the app in these situations.


  • Apps and their data are saved in ~/opt/bin, /.local/share/flatpak, and Aurora + Flatpak are stored in/opt/.

  • --user argument is built-in for this Flatpak since we lack root access.

  • Some apps will not run the conventional way. Brave or Visual Studio are good examples.

  • Both Brave and Visual Studio run significantly easier without Flatpak by downloading them straight from their websites!

    Appimages

    Appimages are not supported due to fuse mount issues. To bypass, run the .AppImage like this: ~/opt/usr/src/Brave-Web-Browser-stable-1.82.172-x86_64.AppImage --appimage-extract-and-run 2>/dev/null Thanks to DennyL for finding this.

When running VS:

flatpak run --command=sh com.visualstudio.code
/app/bin/code --no-sandbox --no-zygote --disable-gpu-sandbox --disable-features=UsePortal

To install Brave: curl -fsS https://dl.brave.com/install.sh | sh
aurora shortcut

  • To find where a Flatpak app is after opening a shell for the app, run: ls /app/bin

  • 4k DPI scaling is easy to apply. Before starting an app run:

aurora display 2 to set scaling to 2x.
aurora cursor 32 will set the cursor to 32px.

Customize to your liking. Applying changes requires restarting app.

Sharing files (Similar to "Share with Linux")

(optional) create a new folder under "MyFiles" (i.e. Steam_files)

  • Open Crosh (ctrl-alt-t) and type in:
    vmc share borealis [folder path from MyFiles]
  • in my example this would be:
    vmc share borealis Steam_files
  • if you simply want to share the whole downloads folder do:
    vmc share borealis Downloads

How it works:

  • Borealis offers hardware acceleration support that makes Crostini's poor performance untenable.
  • Downloads Flatpak and its required dependencies from Arch's repository.
  • Extracts Flatpak to ~/opt/flatpak and its dependencies to ~/opt/flatpak-deps
  • Adds .bashrc for flatpak commands to actually work.

Changelog:

0.01: Release
0.02: Removed .bashrc file and added append capability. Added check to make sure not to install anywhere but Borealis. Added uninstall and reinstall commands. Thanks to Saragon for the suggestions and teachimg me more about .bashrc.

0.03: Added command to auto-generate shortcuts and icons with pin support. Thanks to Saragon for helping find how to do that. Added starman (steam tar manager) - download and decompress files, quick access menu, and change default apps. Added ability to download AppImages and run them with starman.

0.04: Added quick reinstall option, starman AUR emulation, and shortcut ability from AUR emulation. Added ability to build packages using git, python, gcc.

0.05: Fixed starman bug with link parsing. Added support for yay, paru, pacaur, and pacman to install packages multiple ways. Added version base 10 support.

0.06: Improved shortcut command. Improved scaling support.

0.07: Added bsdtar support for simpler extraction syntax. Improved starman download logic.

0.08: Added permission fix logic for Starman. Fixed severe bug preventing install due to LD_LIBRARY_PATH being assigned too early.

0.09: Fixed segfault issue on fresh install/reinstall. Improved shortcut fallback logic support. Significantly improved starman's ability to read PKGBUILD's for convenient downloading. Added /tmp/ folder support for cleaning up extracting packages. Fixed various syntax errors.

0.10: Updated installer to be compatible with archlinux servers under a perpetual DDOS attack

0.11: Fixed aurora cursor command, fixed reinstall command, introduced source syntax to make it clear how to update in-shell.

0.12: Fixed libostree error affecting some Borealis users. Removed leftover.bashrc entries on reinstall/uninstall.

0.13: Fixed libpcre2 error.

To do list: Convince Google that Steam should remain supported.


Acknowledgments

  • Saragon making great suggestions, educating me about .bashrc, improving readme, finding bugs, and working on making Steam shortcuts a reality: https://github.com/Saragon4005

  • Thanks to DennisLfromGA for finding bugs, making great suggestions, and finding issues to running certain apps: https://github.com/DennisLfromGA


Support

About

Install, run, and compile apps in Borealis for a huge performance boost over Crostini!

Resources

Stars

Watchers

Forks

Contributors

Languages