Skip to content

death7654/Chrultrabook-Tools

Repository files navigation

Chrultrabook Tools

shields   shields   shields


Your Chrultrabook, Your Way

image

Features

  • CPU Temperature Monitoring
  • CPU Temperature Graph
  • Keyboard Remap (Windows)
  • RGB Keyboard Controls
  • Fan Speed Monitoring
  • Custom Fan Curves
  • Custom Fan Profiles
  • Fan Speed Graph
  • Start Application in System Tray
  • Start Application on System Boot
  • Start Custom Fan Profiles on System Boot
  • Start Custom RGB Profile on System Boot
  • Create Custom RGB Profiles
  • Change Keyboard Brightness
  • Change Activity Light Colors (on select Chromebooks)
  • System Diagnostics

Install Instructions

Linux


Fedora and Derivatives

Add the Terra repository (if using Ultramarine Linux, Terra is pre-installed).
Instructions can be found here

Install Chrultrabook-Tools:

dnf install chrultrabook-tools

Debian and Derivatives

Add the Chrultrabook Repository

  1. Download and save the repository signing key:
sudo wget https://chrultrabook.sakamoto.pl/repos/debian/chrultrabook-debian-pub.asc -O /etc/apt/trusted.gpg.d/chrultrabook-debian-archive-keyring.asc
  1. Download the source file to sources.list.d:
sudo wget https://chrultrabook.sakamoto.pl/repos/debian/chrultrabook.sources -O /etc/apt/sources.list.d/chrultrabook.sources
  1. Update package lists:
sudo apt-get update

Install ectool and cbmem

sudo apt-get install cbmem chromium-ectool

Install Chrultrabook-Tools

  1. cd to the directory containing the .deb file
  2. Run the following command with the correct version:
sudo apt install ./chrultrabook-tools_3.1.3_amd64.deb

Arch and Derivatives

Install AUR dependencies (example uses paru):

paru -S chromium-ectool cbmem

Download the Arch package from the Releases page, then install:

pacman -U ~/Downloads/chrultrabook-tools-VERSION-pkg.tar.zst

Replace VERSION with the latest version and adjust the file path if needed.


Build from Source

git clone https://github.com/death7654/Chrultrabook-Tools.git
cd Chrultrabook-Tools
npm install
npm run tauri build

Windows

  • Install Coolstar’s latest CROS-EC driver
  • Download the MSI or EXE from the latest release
  • Run the installer
  • Open the application

Windows 11 24H2 and Newer

Enable WMIC:

  1. Open Settings
  2. Navigate to Optional Features
  3. Click View Features
  4. Search for and add WMIC
  5. Reopen the application

macOS

  • Download the ectool binary
  • Move the binary to /usr/bin or /usr/local/bin
  • Download the installer with x86_64 in its name
  • Run the Chrultrabook Tools Installer
  • Drag the Chrultrabook Tools app into the Applications folder
  • Open the app

Built Using

  • Tauri 2.9.5
  • Angular 21
  • Rust 1.92
  • HTML5
  • CSS
  • TypeScript

Authors

👤 Robinson Arysseril


🤝 Contributing

Contributions, issues, and feature requests are welcome.

Issues page

Contributing guide

Feature requests


Show Your Support

Give a ⭐️ if this project helped you!


📝 License

This project is licensed under GPL-3.0:
https://github.com/death7654/Chrultrabook-Tools/blob/3.X.X/LICENSE


Disclaimer

THE SOFTWARE IS PROVIDED “AS IS” AND WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. MISUSE OF THIS SOFTWARE COULD CAUSE SYSTEM INSTABILITY OR MALFUNCTION.

About

User-friendly configuration utility for Chromebooks running an alternate OS

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 9