# Install framework-tool-tui with Homebrew, Nix TUI for controlling and monitoring Framework Computers hardware. Version 0.8.4 via Homebrew; verified 2026-06-30. ## Install ```sh sudo av install brew:framework-tool-tui ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install framework-tool-tui ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#framework-tool-tui ``` Evidence: nixpkgs package indexes: pkgs/by-name/fr/framework-tool-tui/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:framework-tool-tui - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.8.4 - **Source summary:** TUI for controlling and monitoring Framework Computers hardware - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-30T21:30:31Z - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - framework-tool-tui (cli) - framework-tool-tui (alias) ## Dependencies - systemd ## Build dependencies - pkgconf - rust ## Install behavior - Post-install hook: not defined - Bottle: available on x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.8.4 - Package-manager updated: 2026-06-30 - Local data: ok - Upstream repository: https://github.com/grouzen/framework-tool-tui - Upstream latest detected: v0.8.4 (current) ## Project history and usage Framework System TUI is a Rust terminal dashboard for controlling and monitoring Framework laptop hardware. It exposes battery and charge controls, privacy toggles, keyboard and fingerprint brightness, USB-C PD port information, fan RPM, and BIOS/system information through a TUI. ### Project history The GitHub repository was created in August 2025 and the first release, v0.1.0, followed the next day with BIOS display, overview information, README updates, cleanup, and GitHub Actions CI. The project is built with ratatui and crossterm, and its hardware layer uses FrameworkComputer's framework_lib crate. Subsequent early releases added charge-limit control, brightness controls, PD port panels, fan speed information, layout and theme work, screenshots, and a GIF demo. By 2026 the release notes show work on Windows builds, crates.io publishing, official NixOS and Gentoo install instructions, and routine dependency maintenance. ### Adoption history The README documents distribution through GitHub release binaries, Gentoo packages, AUR, archlinuxcn, NixOS packages, Homebrew for Linux, and FreeBSD ports, alongside source installation with Cargo. That broad packaging spread is notable for a hardware-specific TUI launched only in 2025. ### How it is used The tool is run as framework-tool-tui and needs root privileges to access hardware controls. Its architecture polls Framework laptop hardware at intervals, stores a snapshot of hardware data, renders panels in a terminal UI, and dispatches keyboard actions back to hardware mutation methods. ### Why package nerds care Framework System TUI is package-nerd interesting because it packages vendor-specific laptop controls as a terminal-native Rust app rather than a desktop daemon or GUI. It is also a compact example of how a new hardware project can spread quickly across source builds, binary releases, Linux distributions, Homebrew, Nix, and BSD ports. ### Timeline - 2025: Repository created on August 15. - 2025: v0.1.0 released with BIOS display, overview panel, README updates, cleanup, and CI. - 2025: v0.2.0 added charge limit and brightness controls. - 2025: v0.3.0 added PD port panel and screenshots. - 2025: v0.4.0 added fan speed information. - 2026: v0.7.3 release notes describe Windows availability. - 2026: v0.8.0 added NixOS and official Gentoo installation instructions. - 2026: v0.8.4 released with dependency and release-maintenance updates. ### Related projects - The project is related to FrameworkComputer/framework-system and framework_lib for hardware access, ratatui and crossterm for terminal UI, and distro packaging ecosystems including Gentoo, AUR, archlinuxcn, NixOS, Homebrew, and FreeBSD ports. ### Sources - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** framework-tool-tui - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Requirements:** arch, linux - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - framework-tool-tui: normalized package name match | nixpkgs package indexes: pkgs/by-name/fr/framework-tool-tui/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [systemd](https://www.automicvault.com/pkg/brew/systemd/) - Runtime dependency declared by Homebrew. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [nvtop](https://www.automicvault.com/pkg/brew/nvtop/) - Shares av.db curated category or tags: cli, hardware, monitoring, system, tui. - [bottom](https://www.automicvault.com/pkg/brew/bottom/) - Shares av.db curated category or tags: cli, monitoring, rust, system. - [cyme](https://www.automicvault.com/pkg/brew/cyme/) - Shares av.db curated category or tags: cli, hardware, rust, system. - [devcockpit](https://www.automicvault.com/pkg/brew/devcockpit/) - Shares av.db curated category or tags: cli, monitoring, system, tui. - [osx-cpu-temp](https://www.automicvault.com/pkg/brew/osx-cpu-temp/) - Shares av.db curated category or tags: cli, hardware-monitoring, monitoring, system. - [owfs](https://www.automicvault.com/pkg/brew/owfs/) - Shares av.db curated category or tags: cli, hardware, hardware-monitoring, system. - [ansiweather](https://www.automicvault.com/pkg/brew/ansiweather/) - Shares av.db curated category or tags: cli, monitoring, system. - [asitop](https://www.automicvault.com/pkg/brew/asitop/) - Shares av.db curated category or tags: cli, monitoring, system. ## Combined YAML source View the package source record on GitHub. [combined/framework-tool-tui.yml](https://github.com/automic-vault/db/blob/main/combined/framework-tool-tui.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph