settings-tui

Settings TUI (settings-tui)

An advanced, terminal-based control center designed specifically for Linux power users seeking simplicity and efficiency. settings-tui eliminates the need for multiple command-line tools, providing a unified interface to manage essential system settings including network, audio, displays, power, Bluetooth, and more—all from your terminal.

Key Features

• Hyper-Lightweight Performance: Built for minimalism, it uses near-zero CPU resources and a small memory footprint, making it ideal for users of tiling window managers.

• Unified TUI Experience: Say goodbye to memorizing commands for various utilities like nmcli, bluetoothctl, and systemctl. Access everything through a single interface without the bloat of heavy GUI applications.

• Transactional Engine: Ensures state changes succeed through verification (READ -> MUTATE -> READBACK -> VERIFY), removing the guesswork from system adjustments.

• Interactive UI Enhancements: Features like password dialogs and a visibility toggle enhance usability, providing a seamless experience when managing network connections.

• Transparent Capability Matrix: Displays exactly which features are supported on your distribution, preventing confusion and ensuring reliability.

Subsystem Breakdown

settings-tui offers a robust feature set:

• Network Management: Real-time Wi-Fi scanning with visual indicators for signal quality, frequency bands, and security protocols.
• Power Analytics: Live battery metrics with power draw readings and time estimates for charging and discharging.
• Sound Control: Manage PipeWire audio sinks and sources with per-application mixing capabilities.
• Display Settings: Supports monitor management, allowing users to change screen resolutions and refresh rates easily.
• Bluetooth Management: Quickly connect, disconnect, and manage Bluetooth devices with ease.
• Service Management: Direct interface with systemd for managing services and system status.
• Customizable Appearance: Toggle between light and dark themes easily, enhancing accessibility and comfort during use.

Keyboard Navigation

Designed for power users, settings-tui supports intuitive keyboard shortcuts, allowing swift navigation using arrow keys or Vim-style bindings. For instance:

• Navigate through lists with ↑ / ↓, activating settings with Enter.
• Use Esc to dismiss dialogs, and type / for instant global search across settings.

Global Search

Easily find settings by typing keywords at any moment, ensuring a fast and fluid user experience. For example:

⚙ Settings  / bright█
  Screen Brightness            Display      Display > Screen Brightness
  Keyboard Backlight           Display      Display > Backlight

Getting Started

Launch the application instantly with npx or install it globally via npm for regular use. It's also easy to build from source if needed.

Community and Contributions

The project welcomes contributions of all kinds, especially in areas such as additional compositor support, package management, and enhancements to audio processing.

For further exploration, check out the companion tool orbit-tui, which serves as an extensible workspace and system telemetry dashboard.

settings-tui is the go-to solution for Linux enthusiasts who prefer a lightweight, keyboard-driven interface to control their systems effectively.