Installation
There are multiple ways to install the asterctl CLI tool. Choose any one of the methods below that best suit your needs.
Please note that only Linux has been tested so far.
Pre-compiled binaries
Executable binaries are available for download on the GitHub Releases page.
Download the binary for your platform (only Linux available at the moment) and extract the archive.
The archive contains the asterctl and aster-sysinfo executables which you can run.
Build from source using Rust
To build the asterctl and aster-sysinfo executables from source, you will first need to install Rust and Cargo.
Follow the instructions on the Rust installation page.
At least Rust version 1.88 is required.
The project contains IDE settings for RustRover (or other JetBrain IDEs with the Rust plugin) to get you up and running in no time. This is not a requirement, everything can be easily built on the command line.
Once you have installed Rust, the following commands can be used to build asterclt and all other binaries:
- On Linux, install required build dependencies (shown for Ubuntu 25.04):
sudo apt install build-essential git pkg-config libudev-dev
- Checkout project:
git clone https://github.com/zehnm/aoostar-rs.git
cd aoostar-rs
- Build
A release build is highly recommended, as it significantly improves graphic rendering performance:
cargo build --release
The binaries will be located in the ./target/release folder.
A Debian package for easy installation is planned for the future!
See Linux systemd Service on how to automatically switch off the LCD at boot up.
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.