Framework System TUI

Un panel TUI ágil para controlar y monitorear el hardware de tu Framework Laptop — carga, privacidad, iluminación, puertos USB PD y más.

demo

:octocat: Características

Hardware del Framework Laptop

[x] Estado en vivo de batería y carga con límites y controles de carga
[x] Interruptores de privacidad para micrófono y cámara
[ ] Selector de modo Input Deck (Framework 16)
[x] Controles de brillo del teclado y lector de huellas
[x] Monitoreo de puertos USB PD
[x] RPM del ventilador
[ ] Información térmica: temperaturas CPU/GPU
[x] Información del sistema: detalles del BIOS

Instalación

:dvd: Binarios

Los binarios precompilados para Linux, Windows y FreeBSD están disponibles para descarga en la página de Releases

:memo: Desde el código fuente

Requiere Rust (Edición 2024) y un Framework laptop.

git clone https://github.com/grouzen/framework-tool-tui.git
cd framework-tool-tui
cargo build --release
or via cargo install
cargo install --path .

:penguin: Distribuciones de Linux

#### Gentoo linux

Está disponible a través de los paquetes oficiales de Gentoo o el overlay lamdness

# Official gentoo repository
sudo emerge -av app-laptop/framework-tool-tui
or via lamdness overlay
sudo eselect repository enable lamdness
sudo emaint -r lamdness sync
sudo emerge -av app-laptop/framework-tool-tui

#### Arch linux

Está disponible a través de AUR o archlinuxcn

[yay/paru] -S framework-tool-tui # Install from AUR
sudo pacman -S framework-tool-tui # Install from archlinuxcn

#### NixOS linux

Está disponible a través de los paquetes oficiales de NixOS:

nix-shell -p framework-tool-tui # Install temporarilyAdd to the NixOS configuration or use nix profile to install permanently

#### :beer: Homebrew para Linux

Disponible a través de la fórmula framework-tool-tui

brew install framework-tool-tui

😈 FreeBSD

Está disponible en FreeBSD ports

pkg install framework-tool-tui

Windows

Por ahora, puede instalarlo Desde el código fuente o Desde binarios precompilados

:man: Ejecutar

Debe ejecutarse con privilegios de root para acceder a los controles de hardware.

sudo framework-tool-tui

:pencil: Arquitectura

Consulta ARCHITECTURE.md para un desglose técnico completo.

Sondeo de hardware a través de framework_lib

:handshake: Contribuciones

¡Pull requests bienvenidos! Para reportes de errores o solicitudes de funciones, consulta Issues.

Revisa tu código antes de enviar

Se recomienda ejecutar cargo make check-all antes de hacer commit y push a tu rama de función.

Esto requiere tener instalado en tu sistema el ejecutor cargo make:

cargo install --force cargo-make

Convención de Mensajes de Commit

Este proyecto utiliza Conventional Commits para el versionado automático y la generación de registros de cambios. Por favor, formatea tus mensajes de commit como:

: [optional body]

Tipos comunes:

feat: - Nueva funcionalidad (provoca aumento de versión menor)
fix: - Corrección de errores (provoca aumento de versión de parche)
docs: - Cambios en la documentación
refactor: - Refactorización de código
test: - Añadir o actualizar pruebas
chore: - Tareas de mantenimiento
ci: - Cambios en CI/CD

Ejemplos:

feat: add thermal monitoring support
fix: correct battery percentage calculation
docs: update installation instructions

Para cambios que rompen la compatibilidad, añada ! después del tipo o incluya BREAKING CHANGE: en el pie de página:

feat!: redesign UI layout

Pila técnica

:judge: Licencia

MIT License Copyright (c) 2025 Mykhailo Nedokushev Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Vea LICENSE y Cargo.toml para la licencia y dependencias.

--- Tranlated By Open Ai Tx | Last indexed: 2026-05-09 ---