Skip to content

Commit 7720963

Browse files
🎨 Palette: Modernized Welcome App and Keyboard Shortcuts
- Refactored `kiba-welcome` Zenity menu with icons, professional dimensions (450x500), and decoupled logic. - Synchronized advertised keyboard shortcuts with actual system configuration in `kglobalshortcutsrc`. - Backgrounded informational dialogs in the welcome app to prevent UI blocking. - Added accessibility comments to the welcome autostart entry. - Updated shortcuts to Meta+T (Terminal), Meta+S (Search), Meta+W (Overview), and Meta+A (Quick Settings). Co-authored-by: christopherfoxjr <213370400+christopherfoxjr@users.noreply.github.com>
1 parent b226637 commit 7720963

2 files changed

Lines changed: 57 additions & 15 deletions

File tree

‎.Jules/palette.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,3 +9,8 @@
99

1010
**Learning:** For documentation-heavy repositories, the README is the primary UI. Long READMEs (>100 lines) require a "Table of Contents" for better navigability (and to pass CI audits), and hero images must have descriptive alt text to ensure an accessible first impression for screen-reader users.
1111
**Action:** Always include a Table of Contents for READMEs exceeding 100 lines and audit all documentation images for descriptive `alt` attributes instead of generic placeholders like "image".
12+
13+
## 2026-05-11 - [Synchronized Shortcuts and Decoupled Zenity Logic]
14+
15+
**Learning:** Advertising keyboard shortcuts in onboarding UI without backing them up in system configuration creates a "broken promise" UX. In Zenity menus, decoupling user-facing labels from selection logic using hidden tag columns (`--hide-column`) ensures a robust interface where visual refactoring doesn't break the underlying case logic. Backgrounding informational dialogs prevents "UI blocking" and keeps the onboarding flow smooth.
16+
**Action:** Always verify that advertised shortcuts are implemented in `kglobalshortcutsrc` and use hidden tag columns in Zenity `--list` dialogs to separate UI from logic.

‎.github/workflows/kiba.yml‎

Lines changed: 52 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1038,6 +1038,40 @@ jobs:
10381038
Mask=2
10391039
BREEZERC
10401040
1041+
# ── kglobalshortcutsrc — Standard KibaTV shortcuts ─────────────────────
1042+
cat > "$SKEL_KDE/kglobalshortcutsrc" << 'KSHORTCUTS'
1043+
[khotkeys]
1044+
_k_friendly_name=khotkeys
1045+
{d03619b6-9b3c-48cc-9d9c-a2aadb485550}=Meta+T,none,Open Terminal
1046+
1047+
[kwin]
1048+
_k_friendly_name=KWin
1049+
Overview=Meta+W,none,Overview
1050+
ShowDesktopGrid=none,none,Show Desktop Grid
1051+
1052+
[org.kde.krunner.desktop]
1053+
_k_friendly_name=Search
1054+
_launch=Meta+S,Alt+Space,Search
1055+
1056+
[plasma-pa]
1057+
_k_friendly_name=Audio Volume
1058+
toggle_mute=Volume Mute,none,Mute
1059+
1060+
[plasmashell]
1061+
_k_friendly_name=plasmashell
1062+
manage activities=Meta+Q,none,Show Activity Switcher
1063+
next activity=none,none,Next Activity
1064+
previous activity=none,none,Previous Activity
1065+
activate task manager entry 1=Meta+1,none,Activate Task Manager Entry 1
1066+
activate task manager entry 2=Meta+2,none,Activate Task Manager Entry 2
1067+
activate task manager entry 3=Meta+3,none,Activate Task Manager Entry 3
1068+
activate task manager entry 4=Meta+4,none,Activate Task Manager Entry 4
1069+
show-on-mouse-pos=Meta+A,none,Activate Quick Settings
1070+
1071+
[services][org.kde.konsole.desktop]
1072+
_launch=Meta+T,none,Konsole
1073+
KSHORTCUTS
1074+
10411075
# ── plasmashellrc — floating panel ─────────────────────────────────────
10421076
cat > "$SKEL_KDE/plasmashellrc" << 'PLASMASHELLRC'
10431077
[PlasmaViews][Panel 2][Defaults]
@@ -1233,36 +1267,38 @@ jobs:
12331267
CHOICE=$(zenity --list --title="Welcome to KibaOS" \
12341268
--window-icon="/usr/share/kibaos/logo.png" \
12351269
--text="Welcome to KibaOS! What would you like to do?" \
1236-
--column="Action" --column="Description" \
1237-
"Install KibaOS" "Install the system permanently to your disk" \
1238-
"Web Browser" "Browse the internet" \
1239-
"Software Center" "Discover and install new applications" \
1240-
"Keyboard Shortcuts" "View useful desktop shortcuts" \
1241-
"Online Wiki" "Read the technical documentation" \
1242-
--width=500 --height=400 2>/dev/null)
1270+
--column=" " --column="Action" --column="Description" --column="Tag" \
1271+
--image-column=1 --hide-column=4 --print-column=4 \
1272+
"calamares" "Install KibaOS" "Install the system permanently to your disk" "INSTALL" \
1273+
"chromium" "Web Browser" "Browse the internet" "BROWSER" \
1274+
"org.kde.discover" "Software Center" "Discover and install new applications" "STORE" \
1275+
"help-contents" "Keyboard Shortcuts" "View useful desktop shortcuts" "SHORTCUTS" \
1276+
"text-html" "Online Wiki" "Read the technical documentation" "WIKI" \
1277+
--width=450 --height=500 \
1278+
--ok-label="Launch" --cancel-label="Close" 2>/dev/null)
12431279
12441280
[ -z "$CHOICE" ] && break
12451281
12461282
case "$CHOICE" in
1247-
"Install KibaOS")
1283+
"INSTALL")
12481284
sudo calamares &
12491285
break
12501286
;;
1251-
"Web Browser")
1287+
"BROWSER")
12521288
chromium &
12531289
break
12541290
;;
1255-
"Software Center")
1291+
"STORE")
12561292
plasma-discover &
12571293
break
12581294
;;
1259-
"Keyboard Shortcuts")
1260-
zenity --info --title="Keyboard Shortcuts" \
1295+
"SHORTCUTS")
1296+
(zenity --info --title="Keyboard Shortcuts" \
12611297
--window-icon="/usr/share/kibaos/logo.png" \
1262-
--text="<b>Desktop Shortcuts:</b>\n\n • <b>Alt + Space</b>: KRunner (Quick Launch)\n • <b>Ctrl + Alt + T</b>: Open Terminal (Konsole)\n • <b>Meta (Super)</b>: Open Application Launcher\n • <b>Meta + E</b>: Open File Manager (Dolphin)\n • <b>Meta + L</b>: Lock Screen\n • <b>Meta + D</b>: Show Desktop" \
1263-
--width=400 2>/dev/null
1298+
--text="<b>Standard KibaTV Shortcuts:</b>\n\n • <b>Meta + T</b>: Terminal (Konsole)\n • <b>Meta + S</b>: Search (KRunner)\n • <b>Meta + W</b>: Overview (Window Grid)\n • <b>Meta + A</b>: Quick Settings\n\n<b>Other Useful Shortcuts:</b>\n • <b>Meta + E</b>: File Manager (Dolphin)\n • <b>Meta + L</b>: Lock Screen\n • <b>Meta + D</b>: Show Desktop" \
1299+
--width=400 2>/dev/null) &
12641300
;;
1265-
"Online Wiki")
1301+
"WIKI")
12661302
chromium "https://github.com/WolfTech-Innovations/Kiba/blob/main/WIKI.md" &
12671303
break
12681304
;;
@@ -1276,6 +1312,7 @@ jobs:
12761312
[Desktop Entry]
12771313
Type=Application
12781314
Name=Kiba Welcome
1315+
Comment=Explore KibaTV and learn about desktop shortcuts
12791316
Exec=/usr/local/bin/kiba-welcome
12801317
Icon=start-here-kde-symbolic
12811318
Terminal=false

0 commit comments

Comments
 (0)