settuings/README.md

SetTUIngs

A TUI to manage your Linux system settings like wifi, bluetooth, and more, without leaving the terminal.

• What is Spilltea?
• Legal Disclaimer
• Features
• Installation
• Project Management
• Configuration
  • Per-project configuration
• CLI Flags
• Plugin System
• Vim / Neovim Integration
• Deployment
• Tech Stack

What is SetTUIngs?

SetTUIngs is a keyboard-driven TUI for the everyday Linux system settings you'd otherwise dig through a GUI panel for: WiFi, Ethernet, VPN, Bluetooth, and audio. Every page is a thin, readable wrapper around the CLI tools you already have installed (nmcli, bluetoothctl, and wpctl), so there's no background daemon or D-Bus client library involved, and it always reflects whatever changed things elsewhere (a NetworkManager applet, pavucontrol, another terminal).

Features

• WiFi: Scan, connect, and manage networks, including signal strength, security, saved passwords, and known networks, with the radio toggled on/off in one keystroke.
• Ethernet & VPN: Bring interfaces up or down and connect to VPN profiles from the same Network page.
• Bluetooth: Discover, pair, connect, trust, and forget devices, and power the adapter on/off.
• Audio: Adjust output/input volume, mute, and pick the default speaker or mic; preview a device with a test tone or a live input-level meter; control the volume of individual apps (browser tab, Spotify, etc.) independently.
• Vim-like Navigation: The entire interface is keyboard-driven with Vim-inspired shortcuts. Use h/j/k/l to move, gg/G to jump to the top/bottom, / to search, q to close panels, and more. All keybindings are fully customizable via the config file.

Installation

Go install

go install github.com/anotherhadi/settuings/cmd/settuings@latest

Requires Go 1.22+. The binary will be placed in $GOPATH/bin (or ~/go/bin).

Nix (temporary run, no install)

nix run github:anotherhadi/settuings

NixOS (flake)

Add settuings to your flake inputs:

inputs.settuings.url = "github:anotherhadi/settuings";

Then add the package to your system or home-manager packages:

environment.systemPackages = [ inputs.settuings.packages.${pkgs.system}.default ];

CLI Flags

A minimal, terminal-based HTTP(S) proxy for pentesters and CTF players.

Usage:
  spilltea [flags]

Flags:
      --add-default-config      copy the default config file to the config path and exit
      --add-default-plugins     copy built-in example plugins into the plugins dir and exit
  -c, --config string           path to config file
  -h, --help                    help for spilltea
      --host string             proxy host (overrides config)
      --plugins-dir string      path to plugins dir (overrides config)
  -p, --port int                proxy port (overrides config)
  -P, --project string          project name to open directly, or "tmp" for a temporary session
      --ssl-insecure            skip TLS certificate verification (overrides config)
      --upstream-proxy string   upstream proxy URL, e.g. http://user:pass@host:8888 (overrides config)
  -v, --version                 version for spilltea

Tech Stack

Component	Library
TUI	bubbletea
Styles	lipgloss
Config	viper
Plugins	gopher-lua

---

github | gitlab (mirror) | gitea (mirror)