todo-app/desktop/install_desktop_entry.sh

#!/bin/bash

# ============================================================================
# Install the todo launcher icon and .desktop entry for the Linux desktop.
#
# The desktop app is a Flutter *web* build shown in a Chrome app window (the
# Linux embedder manages only ~20fps at 4K — see
# docs/desktop-performance-findings.md), so the launcher starts the wrapper,
# which serves the build and opens the browser.
#
# Icon PNGs are pre-rendered and committed under desktop/icons/, so this script
# needs no image tooling at run time. Regenerate them with:
#   PYTHONPATH=~/src/testsAndMisc python3 -m python_pkg.app_icons \
#       generate --app todo --linux-out desktop/icons
# ============================================================================

set -euo pipefail

SCRIPT_NAME="$(basename "$0")"
DESKTOP_DIR_SRC="$(cd "$(dirname "$0")" && pwd)"
REPO_DIR="$(dirname "$DESKTOP_DIR_SRC")"
readonly SCRIPT_NAME DESKTOP_DIR_SRC REPO_DIR
readonly ICON_NAME="todo"
# Chrome sets WM_CLASS from --class, which the wrapper passes explicitly.
# Without it the window would inherit the browser's own class (e.g.
# "Google-chrome"), and the taskbar would show a browser icon for the app.
readonly WM_CLASS="todo"
readonly ICON_SRC_DIR="$DESKTOP_DIR_SRC/icons"
readonly ICON_THEME_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/icons/hicolor"
readonly DESKTOP_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/applications"
# Prefer the packaged launcher; fall back to running straight from the repo so
# the entry also works for a development checkout that was never installed.
LAUNCH_CMD="/usr/bin/todo"
if [[ ! -x "$LAUNCH_CMD" ]]; then
    LAUNCH_CMD="$REPO_DIR/run.sh"
fi
readonly LAUNCH_CMD

usage() {
    echo "Usage: $SCRIPT_NAME"
    echo "Installs the todo icon into the hicolor theme and writes a .desktop entry."
    exit 0
}

validate_requirements() {
    if [[ ! -d "$ICON_SRC_DIR" ]]; then
        echo "Error: $ICON_SRC_DIR is missing; regenerate the icons first" >&2
        exit 1
    fi
}

ensure_theme_index() {
    # A user-local hicolor tree created from scratch has no index.theme, and
    # without it gtk-update-icon-cache refuses to build a cache ("No theme
    # index file"). Seed it from the system theme when one is available.
    local system_index="/usr/share/icons/hicolor/index.theme"
    if [[ ! -f "$ICON_THEME_DIR/index.theme" && -f "$system_index" ]]; then
        install -Dm644 "$system_index" "$ICON_THEME_DIR/index.theme"
    fi
}

install_icons() {
    local size_dir size icon
    for size_dir in "$ICON_SRC_DIR"/*/; do
        size="$(basename "$size_dir")"
        icon="$size_dir$ICON_NAME.png"
        [[ -f "$icon" ]] || continue
        install -Dm644 "$icon" \
            "$ICON_THEME_DIR/${size}x${size}/apps/$ICON_NAME.png"
    done
    # Refresh the theme cache so GTK picks the icon up without a re-login.
    # Harmless if the tool is absent: the icon still resolves, just slower.
    if command -v gtk-update-icon-cache >/dev/null; then
        gtk-update-icon-cache --quiet --force "$ICON_THEME_DIR" || true
    fi
}

install_desktop_entry() {
    mkdir -p "$DESKTOP_DIR"
    # StartupWMClass must match the window's actual WM class, or the taskbar
    # shows a generic icon for the running window even though the launcher
    # entry itself looks right.
    cat > "$DESKTOP_DIR/$ICON_NAME.desktop" <<EOF
[Desktop Entry]
Type=Application
Name=Todo
Comment=Offline-first, CRDT-synced notes
Exec=$LAUNCH_CMD
Icon=$ICON_NAME
Terminal=false
Categories=Utility;TextEditor;
StartupWMClass=$WM_CLASS
EOF
    if command -v update-desktop-database >/dev/null; then
        update-desktop-database "$DESKTOP_DIR" || true
    fi
}

main() {
    validate_requirements
    ensure_theme_index
    install_icons
    install_desktop_entry
    echo "Installed $ICON_NAME icon into $ICON_THEME_DIR"
    echo "Installed $DESKTOP_DIR/$ICON_NAME.desktop"
    if [[ ! -x "$LAUNCH_CMD" ]]; then
        echo "Note: $LAUNCH_CMD does not exist yet."
        echo "      Run ./install_arch.sh to build and install the app."
    fi
}

while [[ $# -gt 0 ]]; do
    case $1 in
        -h|--help)
            usage
            ;;
        *)
            echo "Unknown option: $1" >&2
            exit 1
            ;;
    esac
done

main "$@"