VulCode

cinnamon-tweaks

Dwa narzędzia GTK w Pythonie dla pulpitu Cinnamon. shortcut-manager zarządza własnymi skrótami klawiszowymi, przechwytuje kombinację i ostrzega o konfliktach, a panel-tweaks przełącza auto-ukrywanie i tryb edycji panelu, ustawia jego wysokość i włącza aplety. Oba zapisują te same klucze co Ustawienia Cinnamona.

TypNarzędzia do pulpitu
JęzykPython 3, GTK 3
PulpitCinnamon
Ustawieniagsettings i dconf
Testyunittest, 18 testów
cinnamon-tweaks

Wprowadzenie

cinnamon-tweaks to dwa małe narzędzia GTK 3 dla pulpitu Cinnamon, które przenoszą często zmieniane ustawienia z kilku ekranów w głąb Ustawień Cinnamona do jednego okna. shortcut-manager wyświetla, dodaje, edytuje i usuwa własne skróty klawiszowe. panel-tweaks przełącza auto-ukrywanie i tryb edycji panelu, ustawia jego wysokość oraz włącza i wyłącza aplety.

Żadne z nich nie ma własnego magazynu ustawień. Oba czytają i zapisują te same klucze gsettings i dconf, których używa Cinnamon, więc każda zmiana działa od razu, zostaje po wylogowaniu i jest widoczna w Ustawieniach Cinnamona. W tle nie działa żaden demon, a każde narzędzie instaluje się osobno.

Co zastępuje każde narzędzie

NarzędzieZastępujeInterfejs
shortcut-managerUstawienia > Klawiatura > Skróty > Własne skrótyokno GTK, wpis w menu
panel-tweaksUstawienia > Panelokno GTK, wpis w menu

shortcut-manager: skróty w jednej tabeli

Okno pokazuje w jednej tabeli nazwę, kombinację klawiszy i polecenie każdego własnego skrótu z listy custom-list Cinnamona, a podwójne kliknięcie otwiera wiersz do edycji. Pole skrótu nagrywa kombinację, którą naciśniesz, zamiast kazać wpisywać <Super><Shift>t. Escape albo Backspace bez modyfikatorów czyści pole, same klawisze modyfikatorów są pomijane, a zapisuje się tylko kombinacja, którą GTK uznaje za poprawny skrót.

W trakcie edycji okno pokazuje każdy inny własny skrót i każdy wbudowany skrót, który używa tej samej kombinacji. Wbudowane skróty są czytane z pięciu schematów gsettings Cinnamona, Muffina i GNOME, a brakujący schemat jest pomijany z ostrzeżeniem. Konflikt to ostrzeżenie, a nie blokada: skrót da się zapisać mimo to.

Kombinacje są porównywane po normalizacji, więc kolejność modyfikatorów, zapisy <Control>, <Ctrl> i <Primary> ani wielkość liter w nazwie klawisza nie ukryją konfliktu.

keybindings.py · python
def normalizeAccelerator(binding):
    if not binding:
        return None
    modifiers = re.findall(r"<([^<>]+)>", binding)
    keyName = re.sub(r"<[^<>]+>", "", binding).strip()
    if not keyName:
        return None
    normalizedModifiers = frozenset(MODIFIER_ALIASES.get(name.lower(), name.lower()) for name in modifiers)
    return normalizedModifiers, keyName.lower()

Gotowe polecenia i porządek w dconf

Okno dodawania podpowiada gotowe polecenia, ale każde tylko wtedy, gdy jego program jest zainstalowany. Wybranie podpowiedzi wpisuje polecenie, a także nazwę, jeśli pole nazwy jest jeszcze puste.

Podpowiadane polecenia

PodpowiedźPolecenie
Terminalgnome-terminal
Menedżer plikównemo
Blokada ekranucinnamon-screensaver-command --lock
Zrzut fragmentu ekranuflameshot gui
Zrzut całego ekranugnome-screenshot
Przeglądarkaxdg-open http://
Wyciszenie dźwiękuamixer -q set Master toggle
Edytor tekstugedit

Nowy skrót dostaje najniższy wolny identyfikator customN, z pominięciem identyfikatorów zostawionych w dconf przez inne narzędzia. Usunięcie skrótu zdejmuje go z custom-list i czyści całą jego ścieżkę w dconf, więc nic nie zostaje osierocone. Przed usunięciem zawsze pada pytanie o potwierdzenie.

panel-tweaks: panel jednym kliknięciem

Drugie okno zbiera ustawienia panelu, które warto mieć pod jednym kliknięciem.

Auto-ukrywanie

włączane i wyłączane jednym przełącznikiem.

Tryb edycji

tryb, w którym aplety da się przeciągać po panelu.

Wysokość

suwak od 20 do 80 pikseli, zmiana widoczna na żywo w trakcie przeciągania.

Aplety

lista apletów panelu z identyfikatorem i strefą każdego, z polem do włączenia albo wyłączenia.

Wszystkie te ustawienia leżą w schemacie org.cinnamon: panels-enabled, panels-autohide, panels-height, panel-edit-mode i enabled-applets.

Instalacja, testy i ograniczenia

Każde narzędzie ma własne install.sh i uninstall.sh. Instalacja kopiuje narzędzie do ~/.local/share/ i dodaje wpis w menu aplikacji, w sekcji ustawień. Odinstalowanie usuwa skopiowane pliki i wpis, a zmienione skróty i ustawienia panelu zostają, bo należą do Cinnamona. Oba narzędzia działają też prosto z katalogu z kodem, bez instalacji i bez budowania.

Logika poza interfejsem ma testy na standardowym unittest, bez dodatkowych zależności: normalizacja skrótów, wyszukiwanie konfliktów, czytanie wbudowanych skrótów i pomijanie brakującego schematu w shortcut-manager oraz czytanie i zapis list id:wartość dla paneli w panel-tweaks. Testy gsettings kompilują jednorazowy schemat i używają backendu w pamięci, więc nigdy nie dotykają prawdziwych ustawień.

Granice są opisane wprost: narzędzia działają tylko w Cinnamonie, panel-tweaks zarządza jednym panelem, pierwszym z listy panels-enabled, a tabela skrótów nie odświeża się sama po zmianach w innym miejscu. Całość jest sprawdzona na Linux Mint 22.2 z Cinnamonem na X11.

Pytania o cinnamon-tweaks

Więcej projektów

Inne realizacje z tej samej kategorii - zobacz, jak podchodzimy do podobnych wyzwań.

Masz podobny projekt?

Napisz do nas - wycena jest bezpłatna i wraca w godzinę.