Skip to content

Latest commit

 

History

14 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

syn-settings

System settings: displays and resolution, keyboard and language, date and time, network addresses, Bluetooth, power and sleep, kernels, the AI backend, the screen reader, default applications, and where configuration actually lives.

A window with panes, and a command line that answers each pane as records.

The window

syn-settings gui             # open it
syn-settings gui network     # open it on one pane

Panes: display, region, time, network, bluetooth, power, apps, kernel, ai, assistant, fprint, speech, remote, system.

Reading the same answers from a script

syn-settings --rec display   # connectors: the kernel's state beside what
                             # the compositor is actually driving
syn-settings --rec time      # the clock, and how the desktop writes it
syn-settings --rec apps      # the default app per role, and WHICH file
                             # decided it
syn-settings --rec kernel    # every kernel on offer, installed, running
syn-settings --rec fprint    # the reader, and which fingers are enrolled
syn-settings --rec network   # interfaces, the MAC and addresses of each,
                             # the gateway, nameservers, and the firewall
syn-settings --rec network --reveal    # …with the addresses unmasked

The network pane reports a hardware address per interface, which is what another machine needs in order to wake this one: a magic packet is addressed to a MAC, not an IP. Only a wired card can be woken that way, and the Wi-Fi row says so rather than leaving you to arm something that cannot work.

Addresses are hidden until you ask

Every MAC and IP reads ••:••:••:••:••:•• — in the window and in the record — so a screenshot or a stream does not carry them. The Bluetooth adapter's address and every paired device's are masked the same way.

Reveal addresses, at the top right of the window, shows them; the button reads Hide addresses while they are showing, and moving to another pane hides them again. On the command line, --reveal does the same:

syn-settings --rec network --reveal | column -t -s$'\t'

The apps pane reports which file made each decision, because a deliberate choice and a fallback look identical everywhere else — that is the difference between "nothing is set" and "something set it and you did not".

What it drives

systemd for localectl, timedatectl and systemctl; networkmanager for the network pane; bluez-utils for Bluetooth; wlr-randr and synctl for displays; synpkg and pacman for kernels; fprintd for fingerprints. Each pane says what is missing rather than showing an empty box, and changes that need authorisation go through polkit instead of asking for a root shell.

Install

git clone https://github.com/velle999/syn-settings
cd syn-settings && makepkg -si

makepkg fetches the source for this PKGBUILD's exact version from this repository's releases, so a clone can only ever build the source it was written against. .SRCINFO lists what it needs.

Where this comes from

Developed in the SynapseOS monorepo, in syn-settings/. This repository is generated from it — the PKGBUILD, a generated .SRCINFO and this README — so issues and patches belong there.

syn-settings 0.1.0-52 · GPL-2.0-or-later

About

SynapseOS settings: displays and resolution, keyboard and language, date and time, network, Bluetooth, power and sleep, kernels, and where configuration lives

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages