https://github.com/legacyo7/aurora
A utility to control RGB keyboard back-light and charging threshold for Asus TUF-gaming laptops
https://github.com/legacyo7/aurora
asus-aura-alternative asus-tuf charge-controler flutter linux-desktop rgb-controller
Last synced: 11 months ago
JSON representation
A utility to control RGB keyboard back-light and charging threshold for Asus TUF-gaming laptops
- Host: GitHub
- URL: https://github.com/legacyo7/aurora
- Owner: legacyO7
- License: mit
- Created: 2022-09-06T07:06:33.000Z (almost 4 years ago)
- Default Branch: stable
- Last Pushed: 2025-07-12T10:40:47.000Z (about 1 year ago)
- Last Synced: 2025-07-12T12:12:37.623Z (about 1 year ago)
- Topics: asus-aura-alternative, asus-tuf, charge-controler, flutter, linux-desktop, rgb-controller
- Language: Dart
- Homepage:
- Size: 2.34 MB
- Stars: 55
- Watchers: 2
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.txt
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Aurora
[](https://choosealicense.com/licenses/mit/)
Aurora serves as an alternative to Aura Sync for GNU/Linux, offering control over keyboard backlight and charging threshold settings. This utility facilitates configuring battery thresholds and adjusting keyboard backlight color, brightness, and modes.
Aurora only targets the ASUS TUF audience, if it worked on any other device, it is just a happy coincidence!.
Aurora provides two modes
- **Mainline** for kernel version 6.1 +
- **Faustus** for kernel version < 6.1
The modes will be auto-selected depending on the kernel version
## Installation
Aurora stable/beta comes with an AppImage and a debian release.
Find the latest release from [here](https://github.com/legacyO7/Aurora/releases).
Aurora stable versions are also available in Fedora copr buildsystem for x86_64 devices
```
sudo dnf copr enable legacy07/aurora
sudo dnf install aurora
```
### Mainline Mode
### Faustus Mode
#### Prerequisites
- [faustus module](https://github.com/hackbnw/faustus)
- If the module is not installed, `dkms openssl mokutil git make cmake` are required for the module installation
#### First Run
Aurora will direct you to the installation screen if the prerequisites are not satisfied on your system.
Aurora also provides an option to choose the faustus module repo. If the device is compatible with the module but isn't supported officially, you can create your own fork that adds support to your device
(Read the [documentation](https://github.com/hackbnw/faustus) for more information on the process and any potential dangers.)
By default, Aurora uses [this fork](https://github.com/legacyO7/faustus.git) that adds support for "FA706IH"
Secureboot enabled devices need to enroll MOK
## Command-Line Arguments
```
usage:
--log - enables logging
--version - displays app version
--with-root - runs with elevated privileges
```
Appimage builds doesnt support ``--with-root`` argument
## Build and Run
##### - Manual
- [Install Flutter SDK](https://docs.flutter.dev/get-started/install/linux)
- Install additional requirements
`libgtk-3-0 libblkid1 liblzma5`
- Enable linux desktop
`flutter config --enable-linux-desktop`
- Run code generator
`dart run build_runner build --delete-conflicting-outputs `
- Run the project
`flutter run`
- Build the project
`flutter build linux`
## [FAQ](./FAQ.md)
## Contributing
Contributions are always welcome!
Feel free to send a PR
## Authors
- [@legacyO7](https://www.github.com/legacyO7)
#### Quires
legacy07.git@gmail.com
## Credits
- [i3](https://github.com/i3) (i3-sensible-terminal)
- [hackbnw](https://github.com/hackbnw) (faustus module)
## Older Versions
- [TUF-Aurora](https://github.com/legacyO7/TUF-Aurora) (abandoned)