diet-guard/app/desktop/install_desktop_entry.sh

#!/bin/bash

# ============================================================================
# Install the diet_guard_app 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), 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 diet_guard_app --linux-out desktop/icons
# ============================================================================

set -euo pipefail

SCRIPT_NAME="$(basename "$0")"
DESKTOP_SRC_DIR="$(cd "$(dirname "$0")" && pwd)"
readonly SCRIPT_NAME DESKTOP_SRC_DIR
readonly ICON_NAME="diet-guard-app"
# Chrome sets WM_CLASS from --class, which the wrapper passes explicitly.
# Without it the window inherits the browser's own class and the taskbar shows
# a browser icon instead of this app's.
readonly WM_CLASS="diet_guard_app"
readonly ICON_SRC_DIR="$DESKTOP_SRC_DIR/icons"
readonly ICON_THEME_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/icons/hicolor"
readonly DESKTOP_DIR="${XDG_DATA_HOME:-$HOME/.local/share}/applications"
# Installed by install_arch.sh; the repo copy is only used for development.
readonly LAUNCHER="/usr/bin/diet-guard-app"

usage() {
    echo "Usage: $SCRIPT_NAME"
    echo "Installs the diet_guard_app 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=DietGuard
Comment=Diet logging and budget companion
Exec=$LAUNCHER
Icon=$ICON_NAME
Terminal=false
Categories=Utility;
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 "$LAUNCHER" ]]; then
        echo "Note: $LAUNCHER does not exist yet."
        echo "      Run 'bash install_arch.sh' to make the entry launchable."
    fi
}

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

main "$@"