v1.3 - 2025-08-23 (Argument Validation & Error Handling)

This update improves script robustness by adding validation for missing arguments to prevent confusing error messages when running the script without parameters.

🛠 Fixes

• Argument Validation Added:
  Added a check for missing command-line arguments. If no argument is provided, the script now outputs an informative message guiding users to use --genconf, --list, or manually edit apps.conf.
  This prevents errors related to accessing undefined associative array keys and improves user experience.

• User Experience Improvement:
  Clear and friendly messaging on missing arguments avoids sudden termination due to bash array indexing errors.
  Maintains script functionality for helper commands without unwanted errors.

v1.2 - 2025-08-17

v1.2 - 2025-08-17 (Subcommands & Configuration Guidance)

This version introduces helpful guidance in the default configuration file and adds subcommands to inspect open windows, generate suggested configurations, and view usage help.

🚀 Improvements

• Subcommands Added:

  • --genconf generates a suggested configuration template in ~/.config/kraiser/apps.conf including example apps and guidance comments.

  • --list enumerates currently open windows with details such as Window ID, Title, Class, PID, and Process Name. This helps users identify correct APP_NAME_OR_CLASS and APP_PROCESS for their custom configurations.

  • --help displays a usage guide explaining how to launch applications, available subcommands, and an extra tip on redirecting the template to a file:

    ./kraiser.sh --genconf > apps.conf

• Configuration Guidance in apps.conf:

  • Added explanatory comments to guide users:

    # You can generate a suggested template using:
    #   ./kraiser.sh --genconf
    #
    # You can list currently open windows with:
    #   ./kraiser.sh --list
    #
    # You can view usage help with:
    #   ./kraiser.sh --help

  • Preserved all previous examples for simple apps, Electron apps, Chromium and Firefox PWAs, and Flatpaks.

• Improved Readability:

  • Indentation and spacing standardized across the script and --genconf generation block.

  • ANSI color variables (YELLOW, GREEN, RESET) clearly defined and used consistently in the output of --genconf.

• No Functional Changes:

  • All existing application launching and window activation logic remains unchanged.

  • Only comments, subcommand support, and formatting were added for clarity and usability.

v1.1 - 2025-08-17 (Enhanced Window Detection & Flatpak Support)

This version focuses on improving the reliability of window detection, especially for applications like Flatpaks and Firefox PWAs.

🚀 Improvements

• Robust Window Matching:

  • The window search logic (kdotool search | while read id; do ... done)) has been significantly enhanced.

  • It now retrieves both the Window Title and Window Class (WM_CLASS) for each window.

  • The matching condition (if [[ "$WINDOW_TITLE" =~ "$APP_NAME_OR_CLASS" || "$WINDOW_CLASS" =~ "$APP_NAME_OR_CLASS" ]]) now robustly checks APP_NAME_OR_CLASS against either the window's title or its class (which is often more stable for apps like Konsole).

  • Crucially, the script now prioritizes matching the Associated Process Name (APP_PROCESS) first, and then uses the title/class as a secondary confirmation. This is vital for applications where kdotool might return empty window title/class, or for distinguishing between multiple instances of the same process (e.g., several Firefox PWAs).

• Improved Flatpak Compatibility: The refined window detection logic directly addresses issues with Flatpak applications like Chatterino, which previously failed to activate existing instances due to inconsistent window property exposure.

⚙️ Configuration Examples in apps.conf (Updated)

• APP_NAME in the script was renamed to APP_NAME_OR_CLASS to better reflect its flexible use for matching both window titles and classes.

• Added and refined default examples in the create_default_config function to guide users on accurate configuration:

  • Simple Apps: apps["dolphin"]="Dolphin|/usr/bin/dolphin|dolphin" (now using class name for Konsole).

  • Electron Apps: apps["crunchyroll"]="Crunchyroll|/usr/bin/crunchyroll|electron"

  • Chromium PWAs: apps["github"]="Github|/usr/bin/chromium --profile-directory=Default --app-id=hnpfjnhllnonngcglapefqaidbinmjnm|chromium"

  • Firefox PWAs: apps["gmail"]="Gmail|/usr/bin/firefoxpwa site launch <YOUR_PWA_ID>|firefoxpwa" and apps["youtube"]="YouTube|/usr/bin/firefoxpwa site launch <YOUR_PWA_ID>|firefoxpwa"

  • Flatpaks: apps["chatterino"]="Chatterino|flatpak run com.chatterino.chatterino|chatterino".

v1.0 - 2025-08-17 (Initial Release)

This marks the first public release of the kraiser script.

✨ Features

• Core Functionality: Launch an application if it's not running, or bring its existing window to the foreground.

• kdotool Dependency: Leverages kdotool for window manipulation on KDE Plasma.

• In-Memory Cache: Utilizes /dev/shm for fast caching of window IDs, speeding up subsequent activations.

• External Configuration: Application definitions are stored in ~/.config/kraiser/apps.conf for easy customization without modifying the main script.

• KDE Shortcut Guidance: Includes instructions for setting up keyboard shortcuts in KDE Plasma..

• Basic Application Detection: Identifies windows primarily by their title and associated process name.

⚙️ Configuration Examples in apps.conf (Initial)

• apps["dolphin"]="Dolphin|/usr/bin/dolphin|dolphin"

• apps["crunchyroll"]="Crunchyroll|/usr/bin/crunchyroll|electron"

• apps["github"]="Github|/usr/bin/chromium --profile-directory=Default --app-id=hnpfjnhllnonngcglapefqaidbinmjnm|chromium"

• apps["gmail"]="Gmail|/usr/bin/firefoxpwa site launch <YOUR_PWA_ID>|firefoxpwa"