⌨️ keegees

Query and manage GNOME keybindings from the CLI with style

keegees is a comprehensive command-line tool for managing GNOME desktop keybindings with "style".

Featuring schema-based organization, safety mechanisms, and a beautiful terminal interface with subtle animations and 24-bit color support.

📽️ Introduction

⚠️ WARNING

Always use --dry-run before making destructive/mutating changes to your system keybindings, as keegees is in version 0.0.2 and may contain bugs.

✨ Overview

keegees provides a unified interface for GNOME keybinding management from the CLI.

We have made keegees use features available in modern terminals to provide a visually appealing experience.

🎯 Key Features

Schema-Based Architecture - Uses official GNOME keybinding schemas for reliable detection of keybinding entries in gsettings/dconf. However, we only support management of official Gnome keybinding schemas and System Extensions.
Query System Settings - Use the ls subcommand to list all current active keybindings
Complete Reset Functionality - Implements the "Reset All..." settings from GNOME Settings, using gsettings reset-recursively
Safety First - Dry-run mode, interactive confirmations, and comprehensive validation
Beautiful Interface - 24-bit color support, animations, and Unicode icons
POSIX Compliant - Uses bc (basic calculator) for arithmetic and avoids bash's surprising, unexpected behaviors, such as early termination due to result arithmetic---(( ... ))---expressions, and other bashisms.
Professional CLI - Comprehensive help system and intuitive command structure
Schema Organization - Hierarchical display with empty schema filtering
Error Resilience - Graceful handling of missing schemas and invalid configurations

🚀 Installation

# Clone and install
git clone https://github.com/nutthead/keegees.git
cd scripts/sh/keegees
./install.sh

# Or install as symlink for development
./install.sh --symlink

# Verify installation
keegees --help

Dependencies

bash - Script execution
gsettings - System keybinding queries (install with glib2-devel)
bc - POSIX-compliant arithmetic

💻 CLI Usage

🔮                                                                            🔮
╭──────────────────────────────────────────────────────────────────────────────╮
│                                    KEEGEES                                   │
│                        GNOME keybinding management system                    │
│                                  Version 0.0.2                               │
╰──────────────────────────────────────────────────────────────────────────────╯


📖 Usage
  keybind <command> [options]

🚀 Commands
  ls     [--hide-empty-schemas] [--dry-run]        List keybindings
  dump   <filename> [--force] [--dry-run]          Export keybindings to dconf format
  sync   <filename> [--backup] [--dry-run]         Import keybindings from dconf format
  add    [--dry-run]                               Interactively add new keybinding
  reset  [--schema] [--force] [--dry-run]          Reset keybindings to defaults
  del    --schema <schema> --key <key> [options]   Delete existing keybinding
  help   [command]                                 Show help message

⚙️ Global Options
  --verbose             Show additional information
  --dry-run             Show what would be done without making changes
  --help|-h             Show help message

🌟 Examples
  keybind ls --hide-empty-schemas             List system keybindings, hide empty schemas
  keybind dump backup.dconf                   Export keybindings to file
  keybind sync backup.dconf --backup          Import keybindings with backup
  keybind reset                               Reset all system keybindings
  keybind del --schema org.gnome.shell.keybindings --key screenshot

📋 Commands

`ls` - List Keybindings

Display keybindings from live system settings.

Flowchart

flowchart TD
    A[keegees ls] --> B[Initialize Variables]
    B --> C[Parse Arguments Loop]
    C --> D{Argument Type}
    D -->|--dry-run| E[Set dry_run=true]
    D -->|--hide-empty-schemas| F[Set hide_empty_schemas=true]
    D -->|--help / -h| G[Show Help & Exit]
    D -->|Unknown| H[Error: Unknown Argument]
    D -->|No More Args| I[Show Header]

    E --> C
    F --> C
    H --> J[Exit with Error]

    I --> K{gsettings Available?}
    K -->|No| L[Error: gsettings Not Found]
    K -->|Yes| M[Wave Effect Animation]

    M --> N[Query System Settings]
    N --> O[Apply Schema Whitelist Filter]
    O --> P[Parse SECTION and BINDING Lines]
    P --> Q[Collect Schemas & Bindings]

    Q --> R[Sort Schemas Alphabetically]
    R --> S[Separate Empty/Non-Empty Schemas]
    S --> T[Calculate Max Key Length]

    T --> U{hide_empty_schemas?}
    U -->|Yes| V[Skip Empty Schemas]
    U -->|No| W[Display Empty Schemas]

    V --> X[Display Non-Empty Schemas]
    W --> X
    X --> Y[Sort Keybindings Alphabetically]
    Y --> Z[Display with Dynamic Alignment]
    Z --> AA[Show Total Statistics]

Key Features:

Schema Whitelist - Only shows official GNOME keybinding schemas (no false positives)
System integration - Direct access to live gsettings with reliable detection
Schema-based organization - Visual hierarchy with Unicode icons
Empty schema filtering - Optional --hide-empty-schemas flag
Beautiful color-coded output - 24-bit color support with dynamic alignment
GNOME-compliant - Uses official keybinding schema organization

Official Schemas:

org.gnome.desktop.wm.keybindings (Window manager)
org.gnome.shell.keybindings (Shell-specific)
org.gnome.mutter.keybindings (Compositor)
org.gnome.mutter.wayland.keybindings (Wayland session)
org.gnome.settings-daemon.plugins.media-keys (Media keys)
org.gnome.shell.extensions.tiling-assistant (Ubuntu Tiling Assistant extension)

`dump` - Export Keybindings

Export current GNOME keybinding configurations to a dconf format file for backup, sharing, or version 0.0.2control.

Flowchart

flowchart TD
    A[keegees dump] --> B[Initialize Variables]
    B --> C[Parse Arguments Loop]
    C --> D{Argument Type}
    D -->|--dry-run| E[Set dry_run=true]
    D -->|--force| F[Set force=true]
    D -->|--help / -h| G[Show Help & Exit]
    D -->|Filename| H[Set output_file]
    D -->|Unknown| I[Error: Unknown Argument]
    D -->|No More Args| J{Filename Provided?}

    E --> C
    F --> C
    I --> K[Exit with Error]

    J -->|No| L[Error: Must Specify Filename]
    J -->|Yes| M[Show Header]

    M --> N{dconf Available?}
    N -->|No| O[Error: dconf Not Found]
    N -->|Yes| P{File Exists?}

    P -->|No| Q[Skip Overwrite Check]
    P -->|Yes & force=false| R[Request Overwrite Confirmation]
    P -->|Yes & force=true| Q

    R -->|y/Y/yes| S[User Confirmed Overwrite]
    R -->|Other| T[Operation Cancelled]

    S --> U{Dry Run?}
    Q --> U
    U -->|Yes| V[Show Preview & Exit]
    U -->|No| W[Apply Schema Whitelist]

    W --> X[Filter Available Schemas]
    X --> Y[Show Operation Details]
    Y --> Z[Wave Effect Animation]

    Z --> AA[Create Temp File]
    AA --> BB[Add Header Comment]
    BB --> CC[Loop Through Schemas]

    CC --> DD{Schema Type}
    DD -->|tiling-assistant| EE[Special Tiling Keys Only]
    DD -->|Other| FF[Full dconf dump]

    EE --> GG[gsettings get for Each Key]
    FF --> HH[dconf dump PATH/]

    GG --> II{All Schemas Done?}
    HH --> II
    II -->|No| CC
    II -->|Yes| JJ{Dump Errors?}

    JJ -->|Yes| KK[Remove Temp & Error]
    JJ -->|No| LL[Move Temp to Final]
    LL --> MM[Report Success & Stats]

Key Features:

Native dconf format - Perfect roundtrip compatibility with keegees sync
Schema whitelist filtering - Only exports official GNOME keybinding schemas
Force overwrite - --force flag to overwrite existing files
Dry run support - Preview operations with --dry-run
Comprehensive output - Beautiful formatted export with schema organization
Extension support - Includes Ubuntu Tiling Assistant and other popular extensions

Export Format:

Format: dconf key-file format (native GNOME)
Schemas: Official GNOME keybinding schemas only
Compatibility: Perfect roundtrip with keegees sync
Portability: GNOME-specific (not cross-platform)

`sync` - Import Keybindings

Import keybindings from a dconf format file, applying them to the live GNOME system settings.

Flowchart

flowchart TD
    A[keegees sync] --> B[Initialize Variables]
    B --> C[Parse Arguments Loop]
    C --> D{Argument Type}
    D -->|--dry-run| E[Set dry_run=true]
    D -->|--force| F[Set force=true]
    D -->|--backup| G[Set create_backup=true]
    D -->|backup path| H[Set backup_path]
    D -->|--help / -h| I[Show Help & Exit]
    D -->|Filename| J[Set input_file]
    D -->|Unknown| K[Error: Unknown Argument]
    D -->|No More Args| L{Filename Provided?}

    E --> C
    F --> C
    G --> M{Next Arg is Path?}
    M -->|Yes| H
    M -->|No| C
    H --> C
    K --> N[Exit with Error]

    L -->|No| O[Error: Must Specify Filename]
    L -->|Yes| P[Show Header]

    P --> Q{dconf Available?}
    Q -->|No| R[Error: dconf Not Found]
    Q -->|Yes| S{Input File Exists?}

    S -->|No| T[Error: File Not Found]
    S -->|Yes| U[Validate dconf Format]

    U -->|Invalid| V[Error: Not dconf Format]
    U -->|Valid| W[Show Operation Details]

    W --> X[Extract dconf Paths]
    X --> Y[Filter Keybinding Paths]
    Y --> Z{Any Paths Found?}

    Z -->|No| AA[Error: No Keybinding Configs]
    Z -->|Yes| BB[Show Paths to Sync]

    BB --> CC{Dry Run?}
    CC -->|Yes| DD[Show Preview & Exit]
    CC -->|No| EE{Force Mode?}

    EE -->|No| FF[Interactive Confirmation]
    EE -->|Yes| GG[Skip Confirmation]

    FF -->|y/Y/yes| HH[User Confirmed]
    FF -->|Other| II[Operation Cancelled]

    HH --> JJ{Create Backup?}
    GG --> JJ
    JJ -->|Yes| KK[Generate Backup Filename]
    JJ -->|No| LL[Wave Sync Animation]

    KK --> MM[Create Temp Backup]
    MM --> NN[Dump Current Settings]
    NN --> OO{Backup Success?}
    OO -->|No| PP[Error: Backup Failed]
    OO -->|Yes| QQ[Report Backup Created]

    QQ --> LL
    LL --> RR[Loop Through Paths]

    RR --> SS[Extract Section for Path]
    SS --> TT[Create Temp Section File]
    TT --> UU[dconf load PATH/]
    UU --> VV{Load Success?}

    VV -->|No| WW[Increment Errors]
    VV -->|Yes| XX[Report Path Success]

    WW --> YY{More Paths?}
    XX --> YY
    YY -->|Yes| RR
    YY -->|No| ZZ{Any Errors?}

    ZZ -->|Yes| AAA[Report Errors]
    ZZ -->|No| BBB[Report Success & Stats]

Key Features:

dconf format support - Imports files created by keegees dump
Automatic backup - Optional backup of current settings before import
Interactive confirmation - User approval before applying changes
Dry run mode - Preview import operations safely
Path validation - Ensures only keybinding paths are imported
Atomic operations - Uses dconf load for reliable imports

`reset` - Reset Keybindings

Reset GNOME keybindings to their default values. Implements the same functionality as GNOME Settings "Reset All..." button.

Flowchart

flowchart TD
    A[keegees reset] --> B[Initialize Variables]
    B --> C[Parse Arguments Loop]
    C --> D{Argument Type}
    D -->|--dry-run| E[Set dry_run=true]
    D -->|--schema| F[Check Schema Value]
    D -->|--force| G[Set force=true]
    D -->|--help / -h| H[Show Help & Exit]
    D -->|Unknown| I[Error: Unknown Argument]
    D -->|No More Args| J[Show Header]

    E --> C
    F --> K{Schema Value Provided?}
    K -->|No| L[Error: Schema Requires Value]
    K -->|Yes| M[Set specific_schema]
    M --> C
    G --> C
    I --> N[Exit with Error]

    J --> O{gsettings Available?}
    O -->|No| P[Error: gsettings Not Found]
    O -->|Yes| Q[Apply Schema Whitelist]

    Q --> R{Specific Schema?}
    R -->|Yes| S[Validate Schema in Whitelist]
    R -->|No| T[Get All Available Schemas]

    S --> U{Schema in Whitelist?}
    U -->|No| V[Error: Schema Not Recognized]
    U -->|Yes| W[Add to schemas_to_reset]

    T --> X[Filter Available by Whitelist]
    X --> Y[Add All to schemas_to_reset]

    V --> Z[Show Available Schemas & Exit]
    W --> AA[Show Operation Details]
    Y --> AA

    AA --> BB{Specific Schema?}
    BB -->|Yes| CC[Show Single Schema Info]
    BB -->|No| DD[Show Multiple Schemas Info]

    CC --> EE[List Target Schema]
    DD --> FF[List All Target Schemas]

    EE --> GG{Dry Run?}
    FF --> GG
    GG -->|Yes| HH[Show Preview & Exit]
    GG -->|No| II{Force Mode?}

    II -->|No| JJ[Show Confirmation Warning]
    II -->|Yes| KK[Skip Confirmation]

    JJ --> LL[Interactive Confirmation]
    LL -->|y/Y/yes| MM[User Confirmed]
    LL -->|Other| NN[Operation Cancelled]

    MM --> OO[Wave Reset Animation]
    KK --> OO
    OO --> PP[Initialize Error Counter]
    PP --> QQ[Loop Through Schemas]

    QQ --> RR[gsettings reset-recursively]
    RR --> SS{Reset Success?}
    SS -->|No| TT[Increment Errors & Log]
    SS -->|Yes| UU[Report Schema Success]

    TT --> VV{More Schemas?}
    UU --> VV
    VV -->|Yes| QQ
    VV -->|No| WW{Any Errors?}

    WW -->|Yes| XX[Report Errors & Exit]
    WW -->|No| YY[Success with Schema Count]

Key Features:

GNOME Settings Compatible - Uses gsettings reset-recursively like official GNOME Settings
System Integration - Works directly with live gsettings to reset keybindings
Selective Reset - --schema option to reset specific keybinding schemas only
Safety Mechanisms - Interactive confirmation, --force override, --dry-run preview
Schema Validation - Only allows official GNOME keybinding schemas
Professional Output - Beautiful animations and progress reporting

`del` - Delete Keybindings

Safely delete individual keybindings with comprehensive validation and backup options.

Flowchart

flowchart TD
    A[keegees del] --> B[Initialize Variables]
    B --> C[Parse Arguments Loop]
    C --> D{Argument Type}
    D -->|--dry-run| E[Set dry_run=true]
    D -->|--schema| F[Check Schema Value]
    D -->|--key| G[Check Key Value]
    D -->|--force| H[Set force=true]
    D -->|--help / -h| I[Show Help & Exit]
    D -->|Unknown| J[Error: Unknown Argument]
    D -->|No More Args| K[Validate Required Args]

    E --> C
    F --> L{Schema Value Provided?}
    L -->|No| M[Error: Schema Requires Value]
    L -->|Yes| N[Set target_schema]
    N --> C
    G --> O{Key Value Provided?}
    O -->|No| P[Error: Key Requires Value]
    O -->|Yes| Q[Set target_key]
    Q --> C
    H --> C
    J --> R[Exit with Error]

    K --> S{Schema Provided?}
    S -->|No| T[Error: Must Specify Schema]
    S -->|Yes| U{Key Provided?}
    U -->|No| V[Error: Must Specify Key]
    U -->|Yes| W[Show Header]

    W --> X{gsettings Available?}
    X -->|No| Y[Error: gsettings Not Found]
    X -->|Yes| Z[Verify Target Exists]

    Z --> AA[gsettings list-keys for Schema]
    AA --> BB{Key in Schema?}
    BB -->|No| CC[Error: Key Not Found]
    BB -->|Yes| DD[gsettings get Current Value]

    DD --> EE{Value Exists?}
    EE -->|No| FF[Error: Keybinding Not Found]
    EE -->|Yes| GG[Set target_exists=true]

    GG --> HH[Display Target Info]
    HH --> II[Show Schema, Key, and Value]
    II --> JJ{Dry Run?}

    JJ -->|Yes| KK[Show Preview & Exit]
    JJ -->|No| LL{Force Mode?}

    LL -->|No| MM[Show Confirmation Warning]
    LL -->|Yes| NN[Skip Confirmation]

    MM --> OO[Interactive Confirmation]
    OO -->|y/Y/yes| PP[User Confirmed]
    OO -->|Other| QQ[Operation Cancelled]

    PP --> RR[Wave Delete Animation]
    NN --> RR
    RR --> SS[delete_system_keybinding Function]
    SS --> TT[gsettings reset Schema Key]
    TT --> UU{Reset Success?}

    UU -->|No| VV[Error: Failed to Delete]
    UU -->|Yes| WW[Success with Details]

Safety Features:

Target validation - Verifies keybinding exists before deletion
Interactive confirmation - User prompts with --force override
Dry-run mode - Safe previewing with --dry-run
System integration - Direct gsettings operations for reliable deletion
Comprehensive error handling - Graceful failure scenarios

`add` - Add Keybindings

Interactively add new keybindings with comprehensive validation, conflict detection, and beautiful step-by-step guidance.

Flowchart

flowchart TD
    A[keegees add] --> B[Initialize Variables]
    B --> C[Parse Arguments Loop]
    C --> D{Argument Type}
    D -->|--dry-run| E[Set dry_run=true]
    D -->|--help / -h| F[Show Help & Exit]
    D -->|Unknown| G[Error: Unknown Option]
    D -->|No More Args| H[Show Header]

    E --> C
    G --> I[Show Help & Exit]

    H --> J[Apply Schema Whitelist]
    J --> K[Query gsettings list-schemas]
    K --> L{Schemas Available?}
    L -->|No| M[Error: No Schemas Available]
    L -->|Yes| N[Filter to Whitelisted Schemas]

    N --> O{Any Whitelisted Schemas?}
    O -->|No| P[Error: No Whitelisted Schemas]
    O -->|Yes| Q[Step 1: Schema Selection]

    Q --> R[Display Numbered Schema List]
    R --> S[Read User Choice]
    S --> T{Valid Number?}
    T -->|No| U[Error: Invalid Selection]
    T -->|Yes| V[Set selected_schema]

    V --> W[Step 2: Key Name Input]
    W --> X[Read Key Name]
    X --> Y{Key Name Empty?}
    Y -->|Yes| Z[Error: Empty Key Name]
    Y -->|No| AA[Check if Key Exists]

    AA --> BB{Key Exists & Has Value?}
    BB -->|Yes| CC[Show Existing Value Warning]
    BB -->|No| DD[Step 3: Key Combination]

    CC --> EE[Overwrite Confirmation]
    EE -->|y/Y/yes| FF[User Confirmed Overwrite]
    EE -->|Other| GG[Operation Cancelled]

    FF --> DD
    DD --> HH[Show Key Combination Examples]
    HH --> II[Read Key Combination]
    II --> JJ{Combination Empty?}
    JJ -->|Yes| KK[Error: Empty Combination]
    JJ -->|No| LL[Validate Format with Regex]

    LL --> MM{Format Valid?}
    MM -->|No| NN[Show Format Warning]
    MM -->|Yes| OO[Step 4: Conflict Detection]

    NN --> PP[Format Confirmation]
    PP -->|y/Y/yes| QQ[User Accepts Format]
    PP -->|Other| RR[Operation Cancelled]

    QQ --> OO
    OO --> SS[Initialize Conflict Variables]
    SS --> TT[Loop Through All Schemas]

    TT --> UU[gsettings list-keys for Schema]
    UU --> VV[Loop Through Schema Keys]
    VV --> WW[gsettings get Value]
    WW --> XX{Value Matches Combination?}

    XX -->|Yes & Different Key| YY[Add to Conflicts]
    XX -->|No| ZZ{More Keys in Schema?}
    YY --> ZZ

    ZZ -->|Yes| VV
    ZZ -->|No| AAA{More Schemas?}
    AAA -->|Yes| TT
    AAA -->|No| BBB{Conflicts Found?}

    BBB -->|Yes| CCC[Display Conflicts List]
    BBB -->|No| DDD[Report No Conflicts]

    CCC --> EEE[Conflict Confirmation]
    EEE -->|y/Y/yes| FFF[User Accepts Conflicts]
    EEE -->|Other| GGG[Operation Cancelled]

    DDD --> HHH[Step 5: Preview Summary]
    FFF --> HHH
    HHH --> III[Show Complete Summary]
    III --> JJJ{Dry Run?}

    JJJ -->|Yes| KKK[Show gsettings Command & Exit]
    JJJ -->|No| LLL[Final Confirmation]

    LLL -->|y/Y/yes| MMM[User Final Confirm]
    LLL -->|Other| NNN[Operation Cancelled]

    MMM --> OOO[Step 6: Execute Addition]
    OOO --> PPP[gsettings set Command]
    PPP --> QQQ{gsettings Success?}

    QQQ -->|No| RRR[Error: Failed to Set]
    QQQ -->|Yes| SSS[Verification gsettings get]

    SSS --> TTT{Verification Success?}
    TTT -->|No| UUU[Warning: Verification Failed]
    TTT -->|Yes| VVV[Success with Details]

Key Features:

6-Step Interactive Workflow - Schema selection → Key name → Combination → Conflicts → Preview → Execution
Comprehensive Validation - Schema existence, key naming, combination format, and conflict detection
Cross-Schema Conflict Detection - Scans all available schemas to detect existing key combinations
Multiple Safety Confirmations - Key overwrite, format warnings, conflict acknowledgment, and final confirmation
Dry-Run Support - Preview mode shows exact gsettings command without execution
Beautiful Step-by-Step UI - Color-coded workflow with clear progress indicators and examples
Error Resilience - Graceful handling of invalid inputs with helpful error messages

Interactive Process:

Schema Selection: Choose from available GNOME keybinding schemas with numbered menu
Key Naming: Enter unique key name with existing key detection and overwrite options
Combination Input: Define key combination with format examples and validation
Conflict Detection: Automatic scanning across all schemas with user-friendly conflict reporting
Preview Summary: Complete overview of what will be added with all details
Execution: gsettings integration with verification and success confirmation

`help` - Show Help Information

Display comprehensive help information for keegees commands with intelligent routing to specific subcommand documentation.

Flowchart

flowchart TD
    A[keegees help] --> B{Arguments Provided?}
    A1[keegees --help / -h] --> C[cmd_help with no args]
    A2[keegees <unknown-command>] --> D[Show Error Message]
    D --> C

    B -->|No Args| C[Show General Help]
    B -->|Has Args| E[Get Subcommand Argument]

    E --> F[Subcommand Routing]
    F --> G{Subcommand Type}

    G -->|ls / list| H[help_ls Function]
    G -->|dump| I[help_dump Function]
    G -->|sync| J[help_sync Function]
    G -->|add| K[help_add Function]
    G -->|reset| L[help_reset Function]
    G -->|del / delete / rm| M[help_del Function]
    G -->|Unknown| N[Log Error Message]

    H --> O[Show ls Help & Return 0]
    I --> P[Show dump Help & Return 0]
    J --> Q[Show sync Help & Return 0]
    K --> R[Show add Help & Return 0]
    L --> S[Show reset Help & Return 0]
    M --> T[Show del Help & Return 0]

    N --> U[Log Available Subcommands]
    U --> V[Return 1 - Error]

    C --> W[show_header Function]
    W --> X[Display Usage Section]
    X --> Y[Display Commands Section]
    Y --> Z[Display Global Options]
    Z --> AA[Display Examples Section]
    AA --> BB[Return 0 - Success]

Key Features:

Multiple Entry Points - Direct command, global flags (--help, -h), and error fallback routing
Intelligent Dispatch - Routes specific subcommand help requests to dedicated help functions
Comprehensive Coverage - General help displays usage, all commands, options, and examples
Alias Support - Handles command aliases (list→ls, delete→del, rm→del)
Error Handling - Unknown subcommands show helpful error messages with available options
Consistent Formatting - Beautiful color-coded output matching the application's visual theme

Help Routing Logic:

General Help: Shows complete command overview when invoked without arguments
Specific Help: Routes help <subcommand> to dedicated help functions (help_ls, help_dump, etc.)
Global Flags: --help and -h flags trigger general help from any context
Error Recovery: Unknown commands automatically display help for user guidance

Help Content Structure:

Usage: Command syntax and argument patterns
Commands: Complete list of available subcommands with descriptions
Options: Global flags and their functionality
Examples: Common usage patterns and real-world scenarios

🎨 Examples

Basic Usage

# List all keybindings from system
keegees ls

# List system keybindings, hiding empty schemas
keegees ls --hide-empty-schemas

# Export current keybindings to file
keegees dump my-keybindings.dconf

# Import keybindings from file with backup
keegees sync my-keybindings.dconf --backup --dry-run

Reset Operations

# Reset all system keybindings (like GNOME Settings "Reset All...")
keegees reset

# Reset only window manager keybindings
keegees reset --schema org.gnome.desktop.wm.keybindings

# Preview reset changes safely
keegees reset --dry-run

# Reset without confirmation prompts
keegees reset --force

Advanced Operations

# Add a new keybinding interactively
keegees add

# Preview add operation without making changes
keegees add --dry-run

# Delete a specific keybinding
keegees del --schema org.gnome.desktop.wm.keybindings --key close

# Force delete without confirmation
keegees del --schema org.gnome.shell.keybindings --key screenshot --force

# Preview deletion before executing
keegees del --schema org.gnome.desktop.wm.keybindings --key minimize --dry-run

Professional Workflows

# Complete backup and restore workflow
keegees dump "backup-$(date +%Y%m%d_%H%M%S).dconf"
# ... make changes ...
keegees sync "backup-$(date +%Y%m%d_%H%M%S).dconf" --backup

# Selective schema operations
keegees reset --schema org.gnome.desktop.wm.keybindings --dry-run
keegees reset --schema org.gnome.shell.keybindings --force

# Documentation and auditing
keegees ls --hide-empty-schemas > current-keybindings.txt
keegees dump current-state.dconf

🛠️ Development

🧬 Project Structure

keegees/
├── keegees.sh        # Main executable script (1889 lines)
├── install.sh        # POSIX-compliant installation script
├── .shellcheckrc     # ShellCheck configuration for code quality
├── README.md         # This file
└── CLAUDE.md         # Development guidance

🗿 Architecture

Schema-Based Design: Uses official GNOME keybinding schema whitelist for reliable keybinding detection and eliminating false positives from configuration arrays.

System Integration: Works directly with dconf format files and live gsettings queries with consistent parsing and validation.

Safety-First Approach: Implements comprehensive validation, interactive confirmations, dry-run modes, and dconf backup functionality.

Visual Excellence: Uses modern terminal capabilities for a beautiful user experience, and gracefully falls back to a simpler UX on terminals without advanced features.

Features 24-bit color detection, Unicode animations, terminal capability detection, and beautiful formatted output.

🫂 Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Test your changes thoroughly
Commit with conventional commit format (git commit -m 'feat: add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📝 Code Style

Follow POSIX shell standards where possible
Use bc for arithmetic (never bash-specific $((...)))
Maintain consistent indentation (4 spaces)
Add comprehensive error handling
Include help documentation for all commands
Follow schema-based architecture patterns

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

GNOME Project - For the excellent desktop environment and gsettings system
bs.scripts - Part of the broader bs.scripts utility collection
Shell Community - For POSIX compliance guidance and best practices

⭐ Star this project • 🐛 Report Issues • 💡 Request Features

Built with ❤️ and 🤖 for the GNOME community

Name		Name	Last commit message	Last commit date
Latest commit History 14 Commits
.github		.github
.samoyed/scripts		.samoyed/scripts
docs/assets		docs/assets
.gitignore		.gitignore
.markdownlint.json		.markdownlint.json
.shellcheckrc		.shellcheckrc
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
install.sh		install.sh
keegees.sh		keegees.sh
samoyed.toml		samoyed.toml

Uh oh!

License

nutthead/keegees

Folders and files

Latest commit

History

Repository files navigation

⌨️ keegees

📽️ Introduction

⚠️ WARNING

✨ Overview

🎯 Key Features

🚀 Installation

Dependencies

💻 CLI Usage

📋 Commands

ls - List Keybindings

dump - Export Keybindings

sync - Import Keybindings

reset - Reset Keybindings

del - Delete Keybindings

add - Add Keybindings

help - Show Help Information

🎨 Examples

Basic Usage

Reset Operations

Advanced Operations

Professional Workflows

🛠️ Development

🧬 Project Structure

🗿 Architecture

🫂 Contributing

📝 Code Style

📄 License

🙏 Acknowledgments

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 2

Sponsor this project

Uh oh!

Contributors 3

Uh oh!

Languages

`ls` - List Keybindings

`dump` - Export Keybindings

`sync` - Import Keybindings

`reset` - Reset Keybindings

`del` - Delete Keybindings

`add` - Add Keybindings

`help` - Show Help Information