Fix Shadow Line translation line endings

Show the actual guidance in a single acknowledgement dialog instead of a generic OK prompt, and update alert-based installer instructions to use the new helper contract.

.gitignore

@@ -1,2 +1,3 @@
 *.x.c
 *.x
+music/

.includes/bottle.sh

@@ -0,0 +1,270 @@
+#!/usr/bin/env bash
+
+get_bottle() {
+    # Simple rule: wine64 for everything, wine32 only for speech APIs
+    local architecture="${1:-win64}"
+    architecture="${architecture/win/}"
+    export WINEPREFIX="$HOME/.local/wine${architecture}"
+    
+    # Set wine executables based on architecture - FOR LAUNCHER
+    if [[ "$architecture" == "32" ]] && [[ -n "$wine32" ]]; then
+        # Set environment variables for winetricks compatibility
+        export WINE="$wine32"
+        export WINESERVER="$wine32server"
+        # Also prepend to PATH for regular wine calls
+        export PATH="${wine32%/*}:$PATH"
+        # Keep WINEARCH for compatibility
+        echo "DEBUG: Using managed wine32 for LAUNCHER (WINE=$WINE, PATH updated)"
+    else
+        # Clear wine variables for system wine but preserve WINEARCH if set
+        unset WINE WINESERVER
+        echo "DEBUG: Using system wine for LAUNCHER (architecture $architecture)"
+    fi
+}
+
+# Set wine environment for installation (called from install_wine_bottle)
+set_wine_env() {
+    local architecture="$1"
+    if [[ "$architecture" == "32" ]] && [[ -n "$wine32" ]]; then
+        export WINE="$wine32"
+        export WINESERVER="$wine32server" 
+        export PATH="${wine32%/*}:$PATH"
+        # Don't unset WINEARCH - preserve it for proper architecture selection
+        echo "DEBUG: Set wine32 environment for INSTALLATION (WINE=$WINE, WINEARCH=$WINEARCH)"
+    else
+        unset WINE WINESERVER
+        # Don't unset WINEARCH - preserve it for proper architecture selection
+        echo "DEBUG: Set system wine environment for INSTALLATION (WINEARCH=$WINEARCH)"
+    fi
+}
+
+# Note: install_wine function removed - we now use system wine with simplified bottle management
+
+winetricks() {
+    # Report used packages to the winetricks maintainer so he knows they are being used.
+    if ! [[ -e "${XDG_CACHE_HOME:-$HOME/.cache}/winetricks/track_usage" ]]; then
+        mkdir -p "${XDG_CACHE_HOME:-$HOME/.cache}/winetricks/"
+        echo "1" > "${XDG_CACHE_HOME:-$HOME/.cache}/winetricks/track_usage"
+    fi
+    # Temporary work around for winetricks git bugs. Requires winetricks be installed from package manager.
+    /usr/bin/winetricks "$@"
+    return
+    # Download or update agm's copy of winetricks
+    if [[ ! -e "${winetricksPath}/winetricks" ]]; then
+        checkWinetricksUpdate="true"
+        download "https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks"
+        mv "${cache}/winetricks" "${winetricksPath}"
+        chmod 755 "${winetricksPath}/winetricks"
+    else
+        if [[ "$checkWinetricksUpdate" != "true" ]]; then
+            checkWinetricksUpdate="true"
+            ${winetricksPath}/winetricks --self-update
+        fi
+    fi
+    # Run the requested winetricks parameters
+    if command -v FEXLoader &> /dev/null ; then
+        WINE="" FEXLoader -- ${winetricksPath}/winetricks "$@"
+    else
+        ${winetricksPath}/winetricks "$@"
+    fi
+}
+
+install_rhvoice() {
+    if [[ -d "${WINEPREFIX}/drive_c/Program Files/Olga Yakovleva/" ]]; then
+        return
+    fi
+    if [[ "$norh" == "true" ]]; then
+        # Try to prevent the user from breaking speech
+        # Also useful for games that do not work with RHVoice
+        if [[ "${defaultVoice}" == "RHVoice" ]]; then
+            unset defaultVoice
+        fi
+        return
+    fi
+    declare -A RHVoice=(
+        [alan]="https://github.com/RHVoice/alan-eng/releases/download/4.0/RHVoice-voice-English-Alan-v4.0.2016.21-setup.exe"
+        [bdl]="https://github.com/RHVoice/bdl-eng/releases/download/4.1/RHVoice-voice-English-Bdl-v4.1.2016.21-setup.exe"
+        [clb]="https://github.com/RHVoice/clb-eng/releases/download/4.0/RHVoice-voice-English-Clb-v4.0.2016.21-setup.exe"
+        [lyubov]="https://rhvoice.eu-central-1.linodeobjects.com/RHVoice-voice-English-Lyubov-v4.0.2008.15-setup.exe"
+        [slt]="https://github.com/RHVoice/slt-eng/releases/download/4.1/RHVoice-voice-English-Slt-v4.1.2016.21-setup.exe"
+    )
+    voiceName="${voiceName:-bdl}"
+    voiceName="${voiceName,,}"
+    if [[ "${RHVoice[${voiceName}]}" == "" ]]; then
+        echo "Invalid RHVoice name specified, defaulting to Bdl."
+        voiceName="bdl"
+    fi
+    local voiceFile="${RHVoice[${voiceName}]##*/}"
+    download "${RHVoice[${voiceName}]}"
+    winetricks -q win8 | agm_progressbox "RHVoice Setup" "Preparing Windows environment for RHVoice..."
+    echo "Installing RHVoice ${voiceName^}..."
+    wine "${cache}/${voiceFile}" &
+    sleep 20 | agm_progressbox "RHVoice Setup" "Installing RHVoice ${voiceName^} voice..."
+    wineserver -k
+}
+
+install_wine_bottle() {
+    # Simplified - bottles are now pre-created with dependencies
+    # Just set up the wine environment for game installation
+
+    # Determine architecture from WINEARCH or dependency requirements
+    # Preserve existing WINEARCH if already set by game installer
+    if [[ -z "$WINEARCH" ]]; then
+        # All games use wine64 now (wine32 eliminated 2025-12-06)
+        # SAPI support is provided by wine64 with WINETRICKS_FORCE=1
+        export WINEARCH="win64"
+        echo "DEBUG: Auto-selected wine64 (default - wine32 eliminated)"
+    else
+        echo "DEBUG: Using pre-set WINEARCH=$WINEARCH from game installer"
+    fi
+    
+    # Set architecture for WINEPREFIX path
+    local architecture
+    if [[ "$WINEARCH" == "win32" ]]; then
+        architecture=32
+    else
+        architecture=64
+    fi
+    
+    export WINEPREFIX="$HOME/.local/wine${architecture}"
+    
+    # Set wine environment
+    set_wine_env "$architecture"
+    
+    echo "Using pre-configured wine${architecture} bottle at $WINEPREFIX"
+    
+    # Store winVer for per-app setting in add_launcher (don't set globally)
+    if [[ -n "$winVer" ]]; then
+        export gameWinVer="$winVer"
+    fi
+
+    # Install any additional game-specific dependencies if specified
+    if [[ $# -gt 0 ]]; then
+        # Filter out dependencies that are already installed in bottle creation
+        local depsToInstall=()
+        local alreadyInstalled="speechsdk sapi corefonts isolate_home"
+
+        for dep in "$@"; do
+            # Skip dependencies already installed during bottle creation
+            # Also skip winVer patterns - handled separately above
+            if [[ ! " $alreadyInstalled " =~ " $dep " ]] && [[ ! "$dep" =~ ^win(7|8|10)$ ]]; then
+                depsToInstall+=("$dep")
+            fi
+        done
+
+        if [[ ${#depsToInstall[@]} -gt 0 ]]; then
+            # Separate speechsdk (needs FORCE) from other deps
+            local regularDeps=()
+            local needsSpeechsdk=false
+            for dep in "${depsToInstall[@]}"; do
+                if [[ "$dep" == "speechsdk" ]]; then
+                    needsSpeechsdk=true
+                else
+                    regularDeps+=("$dep")
+                fi
+            done
+
+            # Install regular deps without FORCE
+            if [[ ${#regularDeps[@]} -gt 0 ]]; then
+                echo "Installing additional dependencies: ${regularDeps[*]}"
+                {
+                    env WINE="$WINE" WINESERVER="$WINESERVER" DISPLAY="${DISPLAY:-:0}" winetricks -q isolate_home "${regularDeps[@]}" ${winetricksSettings}
+                } | agm_progressbox "Wine Setup" "Installing additional dependencies..."
+            fi
+
+            # Install speechsdk with FORCE if needed
+            if [[ "$needsSpeechsdk" == "true" ]]; then
+                echo "Installing speechsdk with WINETRICKS_FORCE=1"
+                {
+                    env WINE="$WINE" WINESERVER="$WINESERVER" DISPLAY="${DISPLAY:-:0}" WINETRICKS_FORCE=1 winetricks -q speechsdk
+                } | agm_progressbox "Wine Setup" "Installing Speech SDK..."
+            fi
+        fi
+    fi
+}
+
+# Set Windows version for a specific executable (per-app, not global)
+# This allows different games to use different Windows versions in the same bottle
+set_app_winver() {
+    local exePath="$1"
+    local winVersion="$2"
+
+    if [[ -z "$exePath" ]] || [[ -z "$winVersion" ]]; then
+        return
+    fi
+
+    # Extract just the exe filename from path (handles both / and \ separators)
+    local exeName="${exePath##*\\}"
+    exeName="${exeName##*/}"
+
+    echo "Setting Windows version $winVersion for $exeName"
+    cat > /tmp/app_winver.reg << EOF
+REGEDIT4
+
+[HKEY_CURRENT_USER\\Software\\Wine\\AppDefaults\\${exeName}]
+"Version"="${winVersion}"
+EOF
+    wine regedit /tmp/app_winver.reg
+    rm /tmp/app_winver.reg
+}
+
+add_launcher() {
+    # Determine architecture from WINEPREFIX path instead of WINEARCH variable
+    local architecture="win64"  # default
+    if [[ "$WINEPREFIX" =~ wine32 ]]; then
+        architecture="win32"
+    fi
+
+    # Set per-app Windows version if specified
+    if [[ -n "$gameWinVer" ]]; then
+        set_app_winver "$1" "$gameWinVer"
+        unset gameWinVer
+    fi
+
+    local launchSettings="${architecture}|${1}|${game}"
+    shift
+    while [[ $# -gt 0 ]]; do
+        launchSettings+="|$1"
+        shift
+    done
+    if ! grep -F -q -x "${launchSettings}" "${configFile}" 2> /dev/null ; then
+        echo "${launchSettings}" >> "${configFile}"
+        sort -t '|' -k3,3f -o "${configFile}" "${configFile}"
+        # Remove .lnk files because they don't work.
+        find ~/Desktop -type f -iname '*.lnk' -exec bash -c '
+            for f ; do
+                mimeType="$(file -b "$f")"
+                mimeType="${mimeType%%,*}"
+                if [[ "$mimeType" == "MS Windows shortcut" ]]; then
+                    rm -v "$f"
+                fi
+            done' _ {} +
+        if [[ "${noCache}" == "true" ]]; then
+            rm -f "${cache}/${1##*\\}"
+        fi
+    fi
+}
+# Install the Discord RPC bridge
+install_discord_rpc_bridge() {
+    echo "Installing Discord RPC bridge for Wine compatibility..."
+    download "https://github.com/EnderIce2/rpc-bridge/releases/download/v1.4.0.1/bridge.zip"
+    if [[ -f "${cache}/bridge.zip" && ! -f "${cache}/bridge.exe" ]]; then
+        # the package is on the system, but not extracted just yet.
+        unzip "${cache}/bridge.zip" -d "${cache}"
+    fi
+
+    if [[ -f "${cache}/bridge.exe" ]]; then
+        wine "${cache}/bridge.exe" --install 2>&1 | grep -v "fixme:" || echo "Discord bridge installation attempted"
+
+        # Copy required bridge.sh script to Wine prefix
+        if [[ -f "${cache}/bridge.sh" ]]; then
+            cp "${cache}/bridge.sh" "${WINEPREFIX}/drive_c/windows/"
+            echo "Copied bridge.sh to Wine prefix"
+        else
+            echo "WARNING: bridge.sh not found in cache!"
+        fi
+    else
+        echo "ERROR: bridge.exe not found after extraction!"
+        return 1
+    fi
+}

.includes/checkup.sh

@@ -0,0 +1,117 @@
+#!/usr/bin/env bash
+
+declare -a errorList
+declare -a packageList
+if [[ $# -eq 0 ]]; then
+    echo "Checking your system..."
+    echo
+fi
+if command -v wine &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "Wine is installed."
+else
+    errorList+=("Critical: Wine is not installed. You will not be able to play any games.")
+fi
+packageList+=("wine")
+if command -v umu-run &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "umu-launcher is installed."
+else
+    errorList+=("Warning: umu-launcher is not installed. Games that require Proton/UMU will not install or launch.")
+fi
+packageList+=("umu-launcher")
+if command -v curl &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "Curl is installed."
+else
+    errorList+=("Critical: Curl is not installed. Critical functionality will not work.")
+fi
+packageList+=("curl")
+if command -v dialog &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "Dialog is installed."
+else
+    errorList+=("Critical: Dialog is not installed. You will not be able to install, launch, or remove any games.")
+fi
+packageList+=("dialog")
+for i in 7z cabextract unzip xz ; do
+    if command -v $i &> /dev/null ; then
+        [[ $# -eq 0 ]] && echo "${i^} is installed."
+    else
+        errorList+=("Critical: ${i^} is not installed. You will not be able to install some games or their components.")
+    fi
+    packageList+=("$i")
+done
+if command -v gawk &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "Gawk is installed."
+else
+    errorList+=("Warning: gawk is not installed. Game removal with -r will not work.")
+fi
+packageList+=("gawk")
+if command -v ocrdesktop &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "Ocrdesktop is installed."
+else
+    errorList+=("Warning: ocrdesktop is not installed. It can help if the installer gets stuck to figure out what is happening.")
+fi
+packageList+=("ocrdesktop")
+if command -v qjoypad &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "Qjoypad is installed."
+else
+    errorList+=("Warning: qjoypad is not installed. Qjoypad allows you to play keyboard only games with a gamepad.")
+fi
+packageList+=("qjoypad")
+if command -v sox &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "Sox is installed."
+else
+    errorList+=("Warning: Sox is not installed. Audio will not work.")
+fi
+packageList+=("sox")
+if command -v trans &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "Translate-shell is installed."
+else
+    errorList+=("Warning: translate-shell is not installed. Games that require translation will not be translated.")
+fi
+packageList+=("translate-shell")
+if command -v sqlite3 &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "Sqlite3 is installed."
+else
+    errorList+=("Warning: sqlite is not installed. Required for games that need to be translated.")
+fi
+if command -v perl &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "Perl is installed."
+else
+    errorList+=("Warning: perl is not installed. Required for games that need to be translated.")
+fi
+packageList+=("perl")
+packageList+=("sqlite")
+if command -v w3m &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "W3m is installed."
+else
+    errorList+=("Warning: w3m is not installed. W3m is used to view game documentation.")
+fi
+packageList+=("w3m")
+if command -v xclip &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "Xclip is installed."
+else
+    errorList+=("Warning: Xclip is not installed. Some games may not speak or register properly.")
+fi
+packageList+=("xclip")
+if command -v xdotool &> /dev/null ; then
+    [[ $# -eq 0 ]] && echo "Xdotool is installed."
+else
+    errorList+=("Warning: Xdotool is not installed. Some installers may not work or may need manual intervention.")
+fi
+packageList+=("xdotool")
+# Show the results
+if [[ $# -ne 0 ]]; then
+    for i in "${packageList[@]}" ; do
+        echo "$i"
+    done | sort
+    exit 0
+fi
+if [[ ${#errorList[@]} -eq 0 ]]; then
+    echo "No problems found, you are good to go."
+    exit 0
+fi
+echo "Errors detected, here is a list along with the severity."
+echo "Note that errors marked critical mean that you will not be able to install and play games until they are resolved."
+for i in "${errorList[@]}" ; do
+    echo "$i"
+done
+exit 0

.includes/desktop.sh

@@ -0,0 +1,35 @@
+# Create desktop launcher file
+desktop_launcher() {
+    local desktopFile="${HOME}/audiogame-manager.desktop"
+    if [[ -e "${desktopFile}" ]]; then
+        echo "the file ${desktopFile} exists. Cannot create the launcher."
+        exit 1
+    fi
+    local dotDesktop
+    local terminal
+    # Try to find an accessible terminal
+    for i in mate-terminal lxterminal terminator gnome-terminal ; do
+        if command -v $i &> /dev/null ; then
+            terminal="$i"
+            break
+        fi
+    done
+    dotDesktop=('[Desktop Entry]'
+        'Name=Audiogame manager'
+        'GenericName=Audiogame Manager'
+        'Comment=Play audio games'
+        "Exec=${terminal} -t \"Audiogame Manager\" -e \"/usr/bin/bash -c 'nohup $(readlink -e "$0") 2> /dev/null'\""
+        'Terminal=false'
+        'Type=Application'
+        'StartupNotify=false'
+        'Keywords=game;'
+        'Categories=Game;'
+    'Version=1.0')
+    for i in "${dotDesktop[@]}" ; do
+        echo "$i" >> "${desktopFile}"
+    done
+    desktop-file-install --dir "${HOME}/.local/share/applications" -m 755 "${desktopFile}"
+    xdg-desktop-icon install ~/.local/share/applications/audiogame-manager.desktop
+    rm "${desktopFile}"
+    exit 0
+}

.includes/dialog-interface.sh

@@ -0,0 +1,537 @@
+#!/usr/bin/env bash
+
+# Dialog interface wrapper for audiogame-manager
+# Automatically switches between dialog (console) and yad (GUI) based on DISPLAY environment
+# This provides better accessibility for GUI environments while maintaining console functionality
+
+# Note: dialogType is now detected in the main script before DISPLAY is modified
+# This ensures console detection works correctly when AGM sets DISPLAY=":0"
+# If dialogType is not set (e.g., when called from standalone scripts), detect it
+if [[ -z "$dialogType" ]]; then
+    if [[ -z "$DISPLAY" ]]; then
+        dialogType="dialog"
+    elif command -v yad &> /dev/null; then
+        dialogType="yad"
+    else
+        dialogType="dialog"
+    fi
+fi
+
+# Wrapper function for menu selection
+# Usage: agm_menu "title" "backtitle" "text" option1 "description1" option2 "description2" ...
+agm_menu() {
+    local title="$1"
+    local backTitle="$2" 
+    local text="$3"
+    shift 3
+    
+    if [[ "$dialogType" == "yad" ]]; then
+        # Build yad list format: Display only, then map back to value
+        local yadList=""
+        declare -A valueMap
+        while [[ $# -gt 0 ]]; do
+            local option="$1"
+            local description="$2"
+            valueMap["$description"]="$option"
+            if [[ -n "$yadList" ]]; then
+                yadList="$yadList\n"
+            fi
+            yadList="${yadList}${description}"
+            shift 2
+        done
+        
+        local selectedDescription
+        selectedDescription=$(echo -e "$yadList" | yad --list \
+            --title="$title" \
+            --text="$text" \
+            --column="Option" \
+            --no-headers \
+            --selectable-labels \
+            --search-column=1 \
+            --height=400 \
+            --width=600)
+        
+        # Strip trailing pipes and return the mapped value
+        if [[ -n "$selectedDescription" ]]; then
+            selectedDescription="${selectedDescription%|}"
+            echo "${valueMap["$selectedDescription"]}"
+        fi
+    else
+        # Build dialog menu format with mapping (same approach as yad)
+        local dialogArgs=()
+        declare -A valueMap
+        while [[ $# -gt 0 ]]; do
+            local option="$1"
+            local description="$2"
+            valueMap["$description"]="$option"
+            dialogArgs+=("$description" "$description")
+            shift 2
+        done
+        
+        local selectedDescription
+        selectedDescription=$(dialog --backtitle "$backTitle" \
+               --title "$title" \
+               --no-tags \
+               --menu "$text" 0 0 0 \
+               "${dialogArgs[@]}" \
+               --stdout)
+        
+        # Return the mapped value
+        if [[ -n "$selectedDescription" ]]; then
+            echo "${valueMap["$selectedDescription"]}"
+        fi
+    fi
+}
+
+# Specialized game launcher menu with "Read Documentation" button
+# Usage: agm_game_menu "title" "backtitle" "text" option1 "description1" option2 "description2" ...
+# Returns: exit code 0=Launch, 1=Cancel, 2/3=Documentation (yad/dialog)
+agm_game_menu() {
+    local title="$1"
+    local backTitle="$2"
+    local text="$3"
+    shift 3
+
+    if [[ "$dialogType" == "yad" ]]; then
+        # Use custom buttons to match dialog behavior (launch/doc/cancel)
+        local yadList=""
+        declare -A valueMap
+        while [[ $# -gt 0 ]]; do
+            local option="$1"
+            local description="$2"
+            valueMap["$description"]="$option"
+            if [[ -n "$yadList" ]]; then
+                yadList="$yadList\n"
+            fi
+            yadList="${yadList}${description}"
+            shift 2
+        done
+
+        local selectedDescription
+        selectedDescription=$(echo -e "$yadList" | yad --list \
+            --title="$title" \
+            --text="$text" \
+            --column="Option" \
+            --no-headers \
+            --selectable-labels \
+            --search-column=1 \
+            --height=400 \
+            --width=600 \
+            --button="Launch:0" \
+            --button="Read Documentation:2" \
+            --button="Cancel:1")
+        local menuCode=$?
+
+        # Strip trailing pipes and return the mapped value
+        if [[ -n "$selectedDescription" ]]; then
+            selectedDescription="${selectedDescription%|}"
+            echo "${valueMap["$selectedDescription"]}"
+        fi
+        return $menuCode
+    else
+        # Build dialog menu format with mapping (same approach as yad)
+        local dialogArgs=()
+        declare -A valueMap
+        while [[ $# -gt 0 ]]; do
+            local option="$1"
+            local description="$2"
+            valueMap["$description"]="$option"
+            dialogArgs+=("$description" "$description")
+            shift 2
+        done
+
+        local selectedDescription
+        selectedDescription=$(dialog --backtitle "$backTitle" \
+               --title "$title" \
+               --extra-button \
+               --extra-label "Read Documentation" \
+               --no-tags \
+               --menu "$text" 0 0 0 \
+               "${dialogArgs[@]}" \
+               --stdout)
+        local menuCode=$?
+
+        # Return the mapped value
+        if [[ -n "$selectedDescription" ]]; then
+            echo "${valueMap["$selectedDescription"]}"
+        fi
+        return $menuCode
+    fi
+}
+
+# Wrapper function for checklist selection
+# Usage: agm_checklist "title" "backtitle" "text" option1 "description1" "status1" option2 "description2" "status2" ...
+agm_checklist() {
+    local title="$1"
+    local backTitle="$2"
+    local text="$3"
+    shift 3
+    
+    if [[ "$dialogType" == "yad" ]]; then
+        local yadList=""
+        while [[ $# -gt 0 ]]; do
+            local option="$1"
+            local description="$2" 
+            local status="$3"
+            local checked="FALSE"
+            [[ "$status" == "on" ]] && checked="TRUE"
+            
+            if [[ -n "$yadList" ]]; then
+                yadList="$yadList\n"
+            fi
+            yadList="${yadList}${checked}|${description}|${option}"
+            shift 3
+        done
+        
+        echo -e "$yadList" | yad --list \
+            --title="$title" \
+            --text="$text" \
+            --checklist \
+            --column="Select:CHK" \
+            --column="Option" \
+            --column="Value:HD" \
+            --hide-column=3 \
+            --print-column=3 \
+            --no-headers \
+            --selectable-labels \
+            --height=400 \
+            --width=600 \
+            --separator=" "
+    else
+        local dialogArgs=()
+        while [[ $# -gt 0 ]]; do
+            dialogArgs+=("$1" "$2" "$3")
+            shift 3
+        done
+        
+        dialog --backtitle "$backTitle" \
+               --title "$title" \
+               --checklist "$text" 0 0 0 \
+               "${dialogArgs[@]}" \
+               --stdout
+    fi
+}
+
+# Wrapper function for input dialog
+# Usage: agm_inputbox "title" "backtitle" "text" "default_value"
+agm_inputbox() {
+    local title="$1"
+    local backTitle="$2"
+    local text="$3"
+    local defaultValue="$4"
+    
+    if [[ "$dialogType" == "yad" ]]; then
+        yad --entry \
+            --title="$title" \
+            --text="$text" \
+            --entry-text="$defaultValue" \
+            --selectable-labels \
+            --width=400
+    else
+        dialog --backtitle "$backTitle" \
+               --title "$title" \
+               --inputbox "$text" 0 0 "$defaultValue" \
+               --stdout
+    fi
+}
+
+# Wrapper function for message box
+# Usage: agm_msgbox "title" "backtitle" "text"
+agm_msgbox() {
+    local title="$1"
+    local backTitle="$2"
+    local text="$3"
+    
+    if [[ "$dialogType" == "yad" ]]; then
+        echo -e "$text" | yad --text-info \
+            --title="$title" \
+            --show-cursor \
+            --button="OK:0" \
+            --width=600 \
+            --height=400
+    else
+        dialog --backtitle "$backTitle" \
+               --title "$title" \
+               --msgbox "$text" 0 0
+    fi
+}
+
+# Wrapper function for yes/no dialog
+# Usage: agm_yesno "title" "backtitle" "text" ["yes_label"] ["no_label"]
+agm_yesno() {
+    local title="$1"
+    local backTitle="$2"
+    local text="$3"
+    local yesLabel="${4:-Yes}"
+    local noLabel="${5:-No}"
+
+    if [[ "$dialogType" == "yad" ]]; then
+        echo -e "$text" | yad --text-info \
+            --title="$title" \
+            --show-cursor \
+            --button="$yesLabel:0" \
+            --button="$noLabel:1" \
+            --width=600 \
+            --height=400
+    else
+        # dialog --yesno doesn't support custom labels, use menu instead
+        if [[ "$yesLabel" != "Yes" ]] || [[ "$noLabel" != "No" ]]; then
+            # Custom labels requested, use menu
+            local choice
+            choice=$(dialog --backtitle "$backTitle" \
+                   --title "$title" \
+                   --no-tags \
+                   --menu "$text" 0 0 0 \
+                   "1" "$yesLabel" \
+                   "2" "$noLabel" \
+                   --stdout)
+            [[ "$choice" == "1" ]]
+        else
+            # Default Yes/No
+            dialog --backtitle "$backTitle" \
+                   --title "$title" \
+                   --yesno "$text" 0 0
+        fi
+    fi
+}
+
+# Wrapper function for info box (non-blocking message)
+# Usage: agm_infobox "title" "backtitle" "text"
+agm_infobox() {
+    local title="$1"
+    local backTitle="$2"
+    local text="$3"
+    
+    if [[ "$dialogType" == "yad" ]]; then
+        # For yad, we'll use a notification since infobox is non-blocking
+        yad --notification \
+            --text="$text" \
+            --timeout=3
+    else
+        dialog --backtitle "$backTitle" \
+               --title "$title" \
+               --infobox "$text" 0 0
+    fi
+}
+
+# Wrapper function for progress box
+# Usage: command | agm_progressbox "title" "text"
+agm_progressbox() {
+    local title="$1"
+    local text="$2"
+    
+    if [[ "$dialogType" == "yad" ]]; then
+        # Start audio feedback for accessibility
+        local beepPid
+        local yadPid
+        
+        # Cleanup function for traps
+        cleanup_progress() {
+            [[ -n "$beepPid" ]] && kill "$beepPid" 2>/dev/null
+            [[ -n "$yadPid" ]] && kill "$yadPid" 2>/dev/null
+        }
+        
+        # Set trap to ensure cleanup on interruption
+        trap cleanup_progress EXIT INT TERM
+        
+        if command -v sox >/dev/null 2>&1; then
+            {
+                while true; do
+                    # Generate a short, pleasant progress beep (440Hz for 0.1s)
+                    sox -q -n -d synth 0.1 sine 440 vol 0.3 2>/dev/null
+                    sleep 2  # Beep every 2 seconds
+                done
+            } &
+            beepPid=$!
+        fi
+        
+        # Start visual progress dialog with auto-close, redirect stdin to prevent conflicts
+        yad --progress \
+            --title="$title" \
+            --text="$text" \
+            --auto-close \
+            --pulsate \
+            --width=400 \
+            --height=100 </dev/null &
+        yadPid=$!
+        
+        # Pass through all input completely unchanged
+        cat
+        
+        # Clean up background processes
+        cleanup_progress
+        trap - EXIT INT TERM  # Remove traps
+    else
+        dialog --title "$title" \
+               --progressbox "$text" 20 70
+    fi
+}
+
+# Simple progress box that just shows the operation is running (no command output)
+# Usage: command | agm_simple_progressbox "title" "text"
+agm_simple_progressbox() {
+    local title="$1"
+    local text="$2"
+    
+    if [[ "$dialogType" == "yad" ]]; then
+        # Start audio feedback for accessibility
+        local beepPid
+        local yadPid
+        
+        # Cleanup function for traps
+        cleanup_simple_progress() {
+            [[ -n "$beepPid" ]] && kill "$beepPid" 2>/dev/null
+            [[ -n "$yadPid" ]] && kill "$yadPid" 2>/dev/null
+        }
+        
+        # Set trap to ensure cleanup on interruption
+        trap cleanup_simple_progress EXIT INT TERM
+        
+        if command -v sox >/dev/null 2>&1; then
+            {
+                while true; do
+                    # Generate a short, pleasant progress beep (440Hz for 0.1s)
+                    sox -q -n -d synth 0.1 sine 440 vol 0.3 2>/dev/null
+                    sleep 2  # Beep every 2 seconds
+                done
+            } &
+            beepPid=$!
+        fi
+        
+        # Show progress dialog with pulsating
+        yad --progress \
+            --title="$title" \
+            --text="$text" \
+            --auto-close \
+            --pulsate \
+            --width=400 \
+            --height=100 &
+        yadPid=$!
+        
+        # Read from stdin and discard, but keep dialogs open until command finishes
+        cat > /dev/null
+        
+        # Clean up background processes
+        cleanup_simple_progress
+        trap - EXIT INT TERM  # Remove traps
+    else
+        dialog --title "$title" \
+               --progressbox "$text" 20 70
+    fi
+}
+
+# Alternative status box for simple operations without meaningful progress
+# Usage: agm_statusbox "title" "text" & statusPid=$!; command; kill $statusPid 2>/dev/null
+agm_statusbox() {
+    local title="$1"
+    local text="$2"
+    
+    if [[ "$dialogType" == "yad" ]]; then
+        # Show a simple status message that screen readers can access
+        yad --form \
+            --title="$title" \
+            --field="$text:LBL" \
+            --selectable-labels \
+            --no-buttons \
+            --timeout=0 \
+            --width=400 \
+            --height=100
+    else
+        # Use infobox for console
+        dialog --title "$title" \
+               --infobox "$text" 5 50
+    fi
+}
+
+# Real progress bar with percentage updates (for operations that can report progress)
+# Usage: agm_progress_with_percent "title" "text" 
+# Then send "percentage" or "#status text" to the returned file descriptor
+agm_progress_with_percent() {
+    local title="$1"
+    local text="$2"
+    
+    if [[ "$dialogType" == "yad" ]]; then
+        # Start audio feedback for accessibility
+        local beepPid
+        local yadPid
+        
+        # Cleanup function for traps
+        cleanup_percent_progress() {
+            [[ -n "$beepPid" ]] && kill "$beepPid" 2>/dev/null
+            [[ -n "$yadPid" ]] && kill "$yadPid" 2>/dev/null
+        }
+        
+        # Set trap to ensure cleanup on interruption
+        trap cleanup_percent_progress EXIT INT TERM
+        
+        if command -v sox >/dev/null 2>&1; then
+            {
+                while true; do
+                    # Generate a short, pleasant progress beep (440Hz for 0.1s)
+                    sox -q -n -d synth 0.1 sine 440 vol 0.3 2>/dev/null
+                    sleep 2  # Beep every 2 seconds
+                done
+            } &
+            beepPid=$!
+        fi
+        
+        # Create a true progress dialog that accepts percentage updates with tee for cleanup
+        {
+            cat
+            cleanup_percent_progress
+            trap - EXIT INT TERM
+        } | yad --progress \
+            --title="$title" \
+            --text="$text" \
+            --auto-close \
+            --width=400 \
+            --height=150
+    else
+        # For dialog, we'll simulate with a gauge
+        dialog --title "$title" \
+               --gauge "$text" 6 50 0
+    fi
+}
+
+# Wrapper function for file selection
+# Usage: agm_fselect "title" "backtitle" "default_path"
+agm_fselect() {
+    local title="$1"
+    local backTitle="$2"
+    local defaultPath="$3"
+    
+    if [[ "$dialogType" == "yad" ]]; then
+        yad --file \
+            --title="$title" \
+            --filename="$defaultPath" \
+            --width=600 \
+            --height=400
+    else
+        dialog --backtitle "$backTitle" \
+               --title "$title" \
+               --fselect "$defaultPath" 0 0 \
+               --stdout
+    fi
+}
+
+# Wrapper function for directory selection
+# Usage: agm_dselect "title" "backtitle" "default_path"
+agm_dselect() {
+    local title="$1"
+    local backTitle="$2"
+    local defaultPath="$3"
+    
+    if [[ "$dialogType" == "yad" ]]; then
+        yad --file \
+            --directory \
+            --title="$title" \
+            --filename="$defaultPath" \
+            --width=600 \
+            --height=400
+    else
+        dialog --backtitle "$backTitle" \
+               --title "$title" \
+               --dselect "$defaultPath" 0 0 \
+               --stdout
+    fi
+}

.includes/functions.sh

@@ -0,0 +1,253 @@
+#!/usr/bin/env bash
+# shellcheck disable=SC2034,SC2154  # sourced by audiogame-manager with shared globals and exported state
+
+# Source IPFS game URLs
+source "${BASH_SOURCE[0]%/*}/ipfs.sh"
+
+# Alerts, for when user needs to read something.
+alert() {
+    local title="Alert"
+    local backTitle=""
+    local message="Press OK to continue."
+
+    if [[ $# -eq 1 ]]; then
+        message="$1"
+    elif [[ $# -eq 2 ]]; then
+        title="$1"
+        backTitle="$1"
+        message="$2"
+    elif [[ $# -ge 3 ]]; then
+        title="$1"
+        backTitle="$2"
+        shift 2
+        message="$*"
+    fi
+
+    play -qnV0 synth 3 pluck D3 pluck A3 pluck D4 pluck F4 pluck A4 delay 0 .1 .2 .3 .4 remix - chorus 0.9 0.9 38 0.75 0.3 0.5 -t
+    echo
+    agm_msgbox "${title}" "${backTitle}" "${message}"
+}
+
+check_requirements() {
+    # Make sure this is not ran as root
+    if [[ "$(whoami)" == "root" ]]; then
+            echo "Please do not run ${0##*/} as root."
+            return 1
+    fi 
+
+    # Make sure the minimum dependencies are installed
+    if [[ "$(uname -m)" == "aarch64" ]]; then
+        minimumDependencies=("FEXLoader")
+        wine="FEXLoader -- /usr/bin/wine"
+    else
+        minimumDependencies=(
+            "curl"
+            "dialog"
+            "sox"
+            "wine"
+        )
+    fi
+    for i in "${minimumDependencies[@]}" ; do
+        if ! command -v "$i" &> /dev/null ; then
+            echo "Please install $i before continuing."
+            return 1
+        fi
+    done
+    return 0
+}
+
+clear_cache() {
+    if [[ ! -d "${cache}" ]]; then
+        agm_msgbox "Clear Cache" "" "No cache found at ${cache}."
+        return
+    fi
+    
+    if ! agm_yesno "Clear Cache" "" "This will delete all contents of ${cache}. Are you sure you want to continue?"; then
+        return
+    fi
+    
+    # All safety checks done. Delete the cache.
+    rm -rfv "${cache}" | agm_progressbox "Clear Cache" "Deleting cache files..."
+    agm_msgbox "Clear Cache" "" "Cache deleted."
+}
+
+download() {
+   local source=("$@")
+   for i in "${source[@]}" ; do
+       local dest="${i##*/}"
+       dest="${dest//%20/ }"
+       dest="${dest#*\?filename=}"
+       dest="${dest%\?*}"
+       # Remove the destination file if it is empty.
+       [[ -s "${cache}/${dest}" ]] || rm -f "${cache}/${dest}" 2> /dev/null
+       if [[ "${redownload}" == "true" ]] && [[ -e "${cache}/${dest}" ]]; then
+           rm -v "${cache}/${dest}"
+       fi
+       # Skip if the item is in cache.
+       [[ -e "${cache}/${dest}" ]] && continue
+       if [[ "$dialogType" == "yad" ]]; then
+           # Use curl's progress bar with better parsing for yad
+           if ! {
+               curl -L4 -C - --retry 10 --progress-bar --output "${cache}/${dest}" "${i}" 2>&1 | \
+               stdbuf -oL grep -o '[0-9]*%' | \
+               stdbuf -oL sed -u 's/%$//' | \
+               while read -r percent; do
+                   echo "$percent"
+                   echo "# Downloading $dest - ${percent}%"
+               done
+           } | agm_progress_with_percent "Audio Game Manager" "Downloading \"$dest\"..."; then
+               agm_infobox "Audio Game Manager" "Audio Game Manager" "Could not download \"$dest\". Installation cannot continue."
+               exit 1
+           fi
+       else
+           # Use the original method for dialog (console)
+           if ! curl -L4 -C - --retry 10 --output "${cache}/${dest}" "${i}" 2>&1 | agm_progressbox "Audio Game Manager" "Downloading \"$dest\"..."; then
+               agm_infobox "Audio Game Manager" "Audio Game Manager" "Could not download \"$dest\". Installation cannot continue."
+               exit 1
+           fi
+       fi
+       local downloadError=1
+       case "${dest##*.}" in
+           "pk3"|"zip")
+               unzip -tq "${cache}/${dest}"  | agm_progressbox "Audio Game Manager" "Validating ${dest##*.} file"
+                   downloadError=$?
+           ;;
+           "7z")
+               7z t "${cache}/${dest}" | agm_progressbox "Audio Game Manager" "Validating 7z file"
+                   downloadError=$?
+           ;;
+           "exe")
+               # Check if it's a valid Windows executable by looking at the MZ header
+               hexdump -n 2 -v -e '/1 "%02X"' "${cache}/${dest}" | grep -q "4D5A"
+                   downloadError=$?
+           ;;
+           "wad")
+               if [[ "$(file -b --mime-type "${cache}/${dest}")" != "application/octet-stream" ]]; then
+                   downloadError=0
+               fi
+           ;;
+           *)
+               # Add HTML check for other file types
+               if file -b "${cache}/${dest}" | grep -q "HTML document" ; then
+                   echo "File not found: \"$i\" (HTML document probably 404)"
+                   downloadError=1
+               else
+                   downloadError=0
+               fi
+           ;;
+       esac
+       if [[ $downloadError -ne 0 ]]; then
+           rm -fv "${cache}/${dest}"
+                   alert "Audio Game Manager" "Audio Game Manager" "Error downloading \"${dest}\". Installation cannot continue."
+                   exit 1
+       fi
+   done
+}
+
+get_installer() {
+        trap "exit 0" SIGINT
+        # If the file is in cache nothing else needs to be done.
+        if [[ -f "${cache}/$1" ]]; then
+            return
+        fi
+        # Create message for dialog.
+        local message="Make sure $1 is available in either your Downloads or Desktop directory and press enter to continue."
+        if [[ -n "$2" ]]; then
+            message+="\n\nThe last good known URL for $game is:"
+            message+="\n$2"
+        fi
+        if echo "$2" | xclip -selection clipboard 2> /dev/null ; then
+            message+="\n\nThe URL has been copied to the clipboard."
+        fi
+        alert "Audiogame Manager" "Audiogame Manager" "$message"
+        # Search the Desktop and Downloads directories for the installation file
+        for i in ~/Downloads ~/Desktop ; do
+            find "$i" -type f -name "$1" -exec cp -v {} "${cache}/" \;
+        done
+        # If the file is still not available abort.
+        if [[ ! -f "${cache}/$1" ]]; then
+            echo "couldn't find $1. Please download the file and try again."
+            exit 1
+        fi
+}
+
+get_steam() {
+    # Arguments: $1 id of item for download, $2 url for game
+    trap "exit 0" SIGINT
+    alert "Audiogame Manager" "Audiogame Manager" "Manual intervention required."
+    agm_yesno "Audiogame Manager" "Audiogame Manager" "To install the game manually, place files in \"${WINEPREFIX}/drive_c/Program Files/${game}\". Continue with Steam installation?"
+    case $? in
+        0) echo "The next steps will install through steamcmd." ;;
+        1)
+            mkdir -p "${WINEPREFIX}/drive_c/Program Files/${game}"
+            agm_msgbox "Audiogame Manager" "Audiogame Manager" "Place game files in  \"${WINEPREFIX}/drive_c/Program Files/${game}\" and press enter to continue."
+        return
+        ;;
+        *) exit 0 ;;
+    esac
+    # Check for steamcmd
+    if ! command -v steamcmd &> /dev/null ; then
+        agm_infobox "Audiogame Manager" "Audiogame Manager" "This installer requires steamcmd. Please install steamcmd and try again."
+        exit 1
+    fi
+    # Create message for dialog.
+    local message="Make sure ${game} is available in your Steam library and press enter to continue. The URL for ${game} is $2"
+    if echo "$2" | xclip -selection clipboard 2> /dev/null ; then
+        message+="\n\nThe URL has been copied to the clipboard."
+    fi
+    agm_msgbox "Audiogame Manager" "Audiogame Manager" "$message"
+    # Get Steam user name.
+    steamUser="$(agm_inputbox "Audiogame Manager" "Audiogame Manager" "Please enter your Steam user name:" "")"
+    # Download the game
+    mkdir -p "${WINEPREFIX}/drive_c/Program Files/${game}"
+    steamcmd +@sSteamCmdForcePlatformType windows +force_install_dir "${WINEPREFIX}/drive_c/Program Files/$game" +login "$steamUser" +app_update "$1" +quit || { agm_infobox "Audiogame Manager" "Audiogame Manager" "Something went wrong. Please make sure you have a stable internet connection, and if the problem persists, contact audiogame-manager's developers."
+        exit 1; }
+}
+
+# Function to open urls across OS.
+open_url() {
+    if [[ "$(uname)" == "Darwin" ]]; then
+        open "${*}" 2> /dev/null
+    else
+        xdg-open "${*}" 2> /dev/null
+    fi
+}
+
+unix2dos() {
+    if [[ $# -eq 0 ]]; then
+        echo "Usage: unix2dos file(s)."
+        exit 1
+    fi
+    for file in "$@"; do
+        sed -i 's/\r\{0,\}$/\r/' "$file"
+    done
+}
+
+# Progress wrapper for game installation operations
+install_with_progress() {
+    local operation="$1"
+    local message="$2"
+    shift 2
+    
+    case "$operation" in
+        "unzip")
+            # Always overwrite without prompting to prevent invisible terminal prompts
+            unzip -o "$@" | agm_progressbox "Game Installation" "$message"
+            ;;
+        "7z")
+            # Always overwrite without prompting for 7z as well
+            7z -y "$@" | agm_progressbox "Game Installation" "$message"
+            ;;
+        "cp"|"copy")
+            # Always force overwrite to prevent invisible prompts in GUI mode
+            cp -fv "$@" | agm_progressbox "Game Installation" "$message"
+            ;;
+        "find")
+            find "$@" | agm_progressbox "Game Installation" "$message"
+            ;;
+        *)
+            # Default: run command with progress box
+            "$operation" "$@" | agm_progressbox "Game Installation" "$message"
+            ;;
+    esac
+}

.includes/help.sh

@@ -0,0 +1,191 @@
+#!/usr/bin/env bash
+# shellcheck disable=SC2154  # Sourced by audiogame-manager with shared globals.
+
+documentation() {
+    if [[ "$2" == "Become a Patron" ]]; then
+        return
+    fi
+    if [[ "$2" == "Donate" ]]; then
+        return
+    fi
+
+    # Extract architecture from first parameter (format: "win64|path")
+    local wineArch="${1%%|*}"
+    if [[ "$wineArch" == "umu" ]]; then
+        local launcherLine=""
+        local docFlag=""
+        local umuGameId=""
+        local -a documentationGame=()
+        launcherLine="$(grep -F -m1 "${1}|" "$configFile" 2> /dev/null || true)"
+        IFS='|' read -ra documentationGame <<< "$launcherLine"
+        for docFlag in "${documentationGame[@]:3}" ; do
+            if [[ "$docFlag" =~ ^export\ [a-zA-Z_][a-zA-Z0-9_]*=\'?.*\'?$ ]]; then
+                eval "$docFlag"
+            fi
+        done
+        if [[ -z "$umuGameId" ]]; then
+            echo "Unable to find UMU game id for documentation lookup."
+            return
+        fi
+        get_umu_bottle "$umuGameId"
+    else
+        get_bottle "$wineArch"
+    fi
+
+    echo "Loading documentation, please wait..."
+
+    # Try to find documentation based on common naming conventions.
+    local gamePath
+    if [[ "$wineArch" == "umu" ]]; then
+        gamePath="$(umu_windows_path_to_unix "$2")"
+    else
+        gamePath="$(winepath -u "$2" 2> /dev/null)"
+    fi
+    gamePath="${gamePath%/*}"
+    local gameDoc=""
+    local isUrl="false"
+
+    gameDoc="$(find "$gamePath" -type f -iname 'user_manual.htm*' -or -iname 'user manual.htm*' -or -iname '*user guide.htm*' | head -1)"
+    # Game name specific docs, add the name to the for loop.
+    if [[ -z "$gameDoc" ]]; then
+        for i in "troopanum.txt" "superdeekout.txt" scw.html ; do
+            gameDoc="$(find "$gamePath" -type f -iname "$i" -or -iname 'manual.htm' | head -1)"
+        done
+    fi
+    if [[ -z "$gameDoc" ]]; then
+        gameDoc="$(find "$gamePath" -type f -path '*/Manual/index.html' | head -1)"
+    fi
+    if [[ -z "$gameDoc" ]]; then
+        gameDoc="$(find "$gamePath" -type f -iname '[A-Z]*Help.htm' -or -iname '[A-Z]*Help.html' | head -1)"
+    fi
+    if [[ -z "$gameDoc" ]]; then
+        gameDoc="$(find "$gamePath" -type f -iname 'manual.html' -or -iname 'manual.htm' | head -1)"
+    fi
+    if [[ -z "$gameDoc" ]]; then
+        gameDoc="$(find "$gamePath" -type f -iname 'en.html' -or -iname 'en.htm' | head -1)"
+    fi
+    if [[ -z "$gameDoc" ]]; then
+        gameDoc="$(find "$gamePath" -type f -iname 'readme.html' -or -iname 'readme.htm' | head -1)"
+    fi
+    if [[ -z "$gameDoc" ]]; then
+        gameDoc="$(find "$gamePath" -type f -iname 'manual.txt' | head -1)"
+    fi
+    if [[ -z "$gameDoc" ]]; then
+        gameDoc="$(find "$gamePath" -type f -iname 'readme.txt' -or -iname 'help.txt' | head -1)"
+    fi
+    if [[ -z "$gameDoc" ]]; then
+        gameDoc="$(find "$gamePath" -type f -iname '*.url' -exec grep -i 'url=' {} \; | grep -iv 'score' | head -1)"
+        gameDoc="${gameDoc#*=}"
+        gameDoc="${gameDoc//[[:cntrl:]]/}"
+        [[ -n "$gameDoc" ]] && isUrl="true"
+    fi
+
+    # Display documentation if available
+    if [[ -n "$gameDoc" ]]; then
+        if [[ "$isUrl" == "true" ]]; then
+            # URL extracted from .url file - open in browser
+            open_url "$gameDoc"
+        elif [[ "$dialogType" == "yad" ]]; then
+            # GUI mode: use appropriate viewer
+            if [[ "${gameDoc,,}" =~ \.(html?)$ ]]; then
+                # HTML files: use xdg-open for default browser
+                xdg-open "$gameDoc" 2>/dev/null &
+            else
+                # Text files: use yad text-info for accessibility
+                yad --text-info \
+                    --title="Game Documentation" \
+                    --filename="$gameDoc" \
+                    --width=800 \
+                    --height=600 \
+                    --button="Close:0"
+            fi
+        else
+            # Console mode: use w3m or fallback
+            if command -v w3m &> /dev/null; then
+                w3m "$gameDoc"
+            elif [[ "${gameDoc,,}" =~ \.(html?)$ ]]; then
+                echo "Install w3m to view HTML documentation in console mode."
+                echo "Documentation location: $gameDoc"
+                read -rp "Press Enter to continue..."
+            else
+                less "$gameDoc"
+            fi
+        fi
+    else
+        if [[ "$dialogType" == "yad" ]]; then
+            agm_msgbox "Documentation" "" "No documentation found for this game."
+        else
+            echo "No documentation found."
+            read -rp "Press Enter to continue..."
+        fi
+    fi
+    exit 0
+}
+
+help() {
+    echo "${0##*/}"
+    echo "Released under the terms of the Common Public Attribution License Version 1.0"
+    echo -e "This is a Stormux project: https://stormux.org\n"
+    echo -e "Usage:\n"
+    echo "With no arguments, open the game launcher."
+    for i in "${!command[@]}" ; do
+        echo "-${i/:/ <parameter>}: ${command[${i}]}"
+    done | sort
+    echo
+    echo "Some settings that are often used can be stored in a settings.conf file."
+    echo "If wanted, place it at the following location:"
+    echo "${configFile%/*}/settings.conf"
+    echo "The syntax is variable=\"value\""
+    echo
+    echo "ipfsGateway=\"https://ipfs.stormux.org\" # Gateway to be used for ipfs downloads."
+    echo "noCache=\"true\" # Do not keep downloaded items in the cache."
+    echo "noqjoypad=\"true\" # Do not launch qjoypad."
+    echo "norh=\"true\" # Do not install RHVoice."
+    echo "redownload=\"true\" # Redownload sources, do not use the version stored in cache."
+    echo "voiceName=\"voicename\" # Select the voice to be installed (default Bdl)."
+    echo "defaultVoice=\"voicename\" # Select the default voice to use for the bottle, e.g. MSMike or RHVoice."
+    echo "defaultRate=\"Default voice rate for the bottle, default 7, may not work in all games. Values 1-9 or A."
+    echo "winedebug=\"flag(s)\" # Set wine debug flags, useful for development."
+    exit 0
+}
+
+license() {
+    cat << EOF
+    ■The contents of this file are subject to the Common Public Attribution
+    License Version 1.0 (the ■License■); you may not use this file except in
+    compliance with the License. You may obtain a copy of the License at
+    https://opensource.org/licenses/CPAL-1.0. The License is based on the Mozilla Public License Version
+    1.1 but Sections 14 and 15 have been added to cover use of software over a
+    computer network and provide for limited attribution for the Original
+    Developer. In addition, Exhibit A has been modified to be consistent with
+    Exhibit B.
+
+    Software distributed under the License is distributed on an ■AS IS■ basis,
+    WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+    for the specific language governing rights and limitations under the
+    License.
+
+    The Original Code is audiogame manager.
+
+    The Original Developer is not the Initial Developer and is . If
+    left blank, the Original Developer is the Initial Developer.
+
+    The Initial Developer of the Original Code is Billy "Storm Dragon" Wolfe. All portions of
+    the code written by Billy Wolfe are Copyright (c) 2020, 2024. All Rights
+    Reserved.
+
+    Contributor Michael Taboada.
+
+    Attribution Copyright Notice: Audiogame manager copyright 2020 Storm Dragon. All rights reserved.
+
+    Attribution Phrase (not exceeding 10 words): A Stormux project
+
+    Attribution URL: https://stormgames.wolfe.casa
+
+    Graphic Image as provided in the Covered Code, if any.
+
+    Display of Attribution Information is required in Larger
+    Works which are defined in the CPAL as a work which combines Covered Code
+    or portions thereof with code not governed by the terms of the CPAL.
+EOF
+}

.includes/ipfs.sh

@@ -0,0 +1,63 @@
+# shellcheck shell=bash
+# Central repository for IPFS game download URLs
+# This file is sourced by functions.sh
+
+declare -Ag ipfs=(
+    # Core System Files
+    [nvdaControllerClient32]="${ipfsGateway}/ipfs/QmTrRrT4QFKSkZ8ivfUawA6iJ6adEyyogccE3nLDTfSK8u?filename=nvdaControllerClient32.dll"
+    [nvdaControllerClient64]="${ipfsGateway}/ipfs/QmaYE7RFDtwHCiXCVLcuA3esfFx6E7koidtvrck9AwPuuN?filename=nvdaControllerClient64.dll"
+    [nvda2speechd]="${ipfsGateway}/ipfs/QmPxhoNsoFoJC7bCfioBBCcK8tEoSoYpm342z6u7KjFsVz?filename=nvda2speechd"
+
+    # Games (alphabetical order)
+    [BG 15 Puzzle]="${ipfsGateway}/ipfs/QmQiocMpMXoxejDftKKvmrR5xxpj1qcWcgkhBBwTcyijXg?filename=FPB32Setup10a.exe"
+    [BG 2048]="${ipfsGateway}/ipfs/QmPNt3c78UBgEMrTH3eJ5eD2mCMdth6jwes1iDKGW24Uj5?filename=BG204832Setup10a.exe"
+    [BG Aces Up Solitaire]="${ipfsGateway}/ipfs/QmTshtHBEV9dh7wFtaQpNUEYHZ3fBpuhSRZqc7k8HwmtPM?filename=ASB32Setup10.exe"
+    [BG Alchemy]="${ipfsGateway}/ipfs/Qma76HXBhmKgMDeHH1XLePsaWzzzLsBS2HRL3c7MVwDokg?filename=BAC32Setup10.exe"
+    [BG Battleship]="${ipfsGateway}/ipfs/Qmaq9P9fxdLTEFMGg4mhHrRuUbPg6HgU3eYVJNqZUimHjo?filename=BGB32Setup10.exe"
+    [BG Boggle]="${ipfsGateway}/ipfs/QmQwWiJw9hDiPdfwDyL4XepeoD66ztVRi3HwbSjFFP4CNg?filename=BGB32Setup10a.exe"
+    [BG Boxes]="${ipfsGateway}/ipfs/QmRn21tREXxXVSaDe9i54zEPzPSespjJAFBqu4DWocuagD?filename=BXB32Setup10.exe"
+    [BG Brainiac]="${ipfsGateway}/ipfs/QmWEdmTkQsjSqBgWUgnDajMf8QvQBbEF4Nxo6mhkXYzBtQ?filename=BRN32Setup10a.exe"
+    [BG Chess Challenge]="${ipfsGateway}/ipfs/QmT2yBpU5Jqna18FxYtyWzi4xMGAY9PyJWStAskxCHqBDw?filename=BGC32Setup10d.exe"
+    [BG Code Breaker]="${ipfsGateway}/ipfs/QmU486SssAdM7kPKwDyAKDLQs3Z92bG6wFjaLhzqDZCxAF?filename=BCB32Setup10.exe"
+    [BG Cribbage]="${ipfsGateway}/ipfs/QmeFud3EPHy7wQe8UENgvh96HdAazEkwqA2AutCNkYvB3t?filename=BGC32Setup12e.exe"
+    [BG Cribbage Solitaire]="${ipfsGateway}/ipfs/QmbRUiknnNcibWD3NwK4DFZGNHWswBgsFidUzU1TFGJ5Ra?filename=BCS32Setup10.exe"
+    [BG Crossword Puzzle]="${ipfsGateway}/ipfs/QmZQGY9CeATEiWrSqsKBz4AN6jPgQuvbBZSpQoLiMjoDr2?filename=BGX32Setup10h.exe"
+    [BG Draw Dominoes]="${ipfsGateway}/ipfs/QmZQGY9CeATEiWrSqsKBz4AN6jPgQuvbBZSpQoLiMjoDr2?filename=BDD32Setup.exe"
+    [BG Elevens Solitaire]="${ipfsGateway}/ipfs/QmWWZByYL5CsDSi6gQLGcMyBL7zqD5hWXbPXJr3shRt5AQ?filename=ESB32Setup10.exe"
+    [BG Fives Dominoes]="${ipfsGateway}/ipfs/QmSZt6dz7WQkNrFBmYq9n4WdYrrZyQAebTBPo46uHqCuNi?filename=BFD32Setup10.exe"
+    [BG Free Cell Solitaire]="${ipfsGateway}/ipfs/QmVfQMMnqTD9Zm8Xwv7rGrUTdS9FXToq7Fv6wtQQVgbQGR?filename=BGF32Setup20.exe"
+    [BG Golf Solitaire]="${ipfsGateway}/ipfs/QmfAp9EYou1pndLwYSdpYdUCHBv2DR94oFccQh1ii9JVLD?filename=GSB32Setup10a.exe"
+    [BG Hangman]="${ipfsGateway}/ipfs/QmXTPMmvw7JE2eLuPBLGSpkZqUn12TX7QEQZbX8qtp7GBx?filename=HMB32Setup10.exe"
+    [BG Hearts]="${ipfsGateway}/ipfs/QmdU5ag1PRjvG28wNX7aNuJqZSVxaqEEKjgG6GoRoDT8k4?filename=BGH32Setup10b.exe"
+    [BG Klondike Solitaire]="${ipfsGateway}/ipfs/QmctBDvhQWwER94LvgauR7sMDxv9D1mS9cToV47orTCdzU?filename=BGK32Setup10b.exe"
+    [BG LAP]="${ipfsGateway}/ipfs/Qma5WeCC9B2P5abRGX9nGYV8Zi9F8vfCCr4ehejP2bgmNm?filename=LAP32Setup10.exe"
+    [BG Master Mind]="${ipfsGateway}/ipfs/QmP6cwMbirbBqAaG9JLfNRnD2dvJfh6nq74kfwxs5hN2RQ?filename=BMM32Setup10.exe"
+    [BG Mine Sweeper]="${ipfsGateway}/ipfs/QmRa54HroWjwxHYfKr6hdmP34sHW5G3ecuzcjMA5UBBVKa?filename=MSB32Setup10.exe"
+    [BG Nomination Whist]="${ipfsGateway}/ipfs/Qmb7eGTMDgiaDC9muMW9n8bHoistGcNm1VgHc6sr7dRyHU?filename=BNW32Setup10a.exe"
+    [BG Penguin Solitaire]="${ipfsGateway}/ipfs/QmXKvQ6WNNSnDiSyYmvAhZXVdALnuhUGK7dSMQVkQNReJr?filename=BPS32Setup10c.exe"
+    [BG Poker Solitaire]="${ipfsGateway}/ipfs/QmPLv74LiDgVGuiGhu9HuPhx3uoMm9QyCYk6jgeFUHjj3S?filename=BPS32Setup10.exe"
+    [BG Pyramid Solitaire]="${ipfsGateway}/ipfs/QmaqXaBKD3xY2smhU2LcejXRTPnWZHqaTW9se8yRepLsHu?filename=PSB32Setup10a.exe"
+    [BG Scorpion Solitaire]="${ipfsGateway}/ipfs/QmSxJs2MiLQ61Fgx6vCpSD7GmQziLiCEU3sZ3mgWc7RsJ8?filename=BSS32Setup10.exe"
+    [BG Scrabble]="${ipfsGateway}/ipfs/QmVrwyPdJBnmc4wLW7oT2hexxXnXxs8bA7gfiqbnJsWJ16?filename=BGS32Setup20.exe"
+    [BG Simon]="${ipfsGateway}/ipfs/QmXtBCqB6VCFPaDYuLaFNP1BDtJSLCJdJZzgm61zMtrsQt?filename=BGS32Setup10.exe"
+    [BG Spider Solitaire]="${ipfsGateway}/ipfs/QmdWBaDnLVbKCJSpiqF675ew6nJ6KHUVXA5FEH3t3E7UAu?filename=SPB32Setup10b.exe"
+    [BG Sudoku]="${ipfsGateway}/ipfs/QmXCAHEVRGZBc8t45Jgn2vkxicwF9Aox6yz9XrQBdkv7WY?filename=SDB32Setup10a.exe"
+    [BG Tablic Solitaire]="${ipfsGateway}/ipfs/QmYoiFQ6JuSXfZfZXT3SQDsYzMWLBu9rW9yivi1xiPjqZx?filename=SDB32Setup10a.exe"
+    [BG Tri-Peaks Solitaire]="${ipfsGateway}/ipfs/QmWJGvSR6iaQfMHM3XuGCkWxx285jkzSDdNSvvk3bSCH8S?filename=TPB32Setup10a.exe"
+    [BG Twenty 20 Cricket]="${ipfsGateway}/ipfs/QmWAk2TMHMvW6Kjc1sZBEPsxmCNHfY3nF1K723PCqaTa57?filename=T20B32Setup10.exe"
+    [BG Uno]="${ipfsGateway}/ipfs/QmVsfPkebSoTDwYSXF1n7y4P9eGJTgTcGXdrEjpcV8A3Dv?filename=BGU32Setup11a.exe"
+    [BG Word Builder]="${ipfsGateway}/ipfs/QmXtR49EZShyj15Tc9CXQpBYVmKNfZpp4515Epm16bviuH?filename=BWB32Setup10.exe"
+    [BG Word Candy]="${ipfsGateway}/ipfs/QmfTgfRzd4JMRqKSfDiz76iMorkaG19BqH1K7nRCCDwo4H?filename=WCB32Setup10a.exe"
+    [BG Word Jumble]="${ipfsGateway}/ipfs/QmYQWZZifzKJSuVRCC1SabwRmEDz95GdFvbzRvsBMmTt6e?filename=BWJ32Setup10.exe"
+    [BG Word Maze]="${ipfsGateway}/ipfs/QmXPtj5PkVZjXpU3m6FAfm8MwVL6bQCvhEDoR385u6FGTL?filename=BWM32Setup10.exe"
+    [BG Word Solitaire]="${ipfsGateway}/ipfs/QmZp73ARDPqgnCz7zxfKeBHjNoHrgZSgg2NdQZR2sMyZGD?filename=WSB32Setup10.exe"
+    [BG Word Target]="${ipfsGateway}/ipfs/QmWWZFXVHNtmNkH55oermWWtrMcQ8qVqL687B7kGFyeezq?filename=WTB32Setup10a.exe"
+    [BG Word Yahtzee]="${ipfsGateway}/ipfs/QmdicAVDegDktY3euVAC2PPn4YBGz96KedxYXNe4WDQaoq?filename=BWY32Setup10.exe"
+    [BG Yahtzee]="${ipfsGateway}/ipfs/QmZebvkKgFAADnb1cgW6Bz7wTYdUh82X61QdtW66KcvmpF?filename=BGY32Setup10a.exe"
+    [Bloodshed]="${ipfsGateway}/ipfs/QmcTCTMep4zp5zTw8ZaXYpjtu9inNPn8bNzwhW6cX97egw?file=bloodshed.exe"
+    [Chopper Challenge]="${ipfsGateway}/ipfs/QmY1jmwVkmwEcqBs84i4mpancD3R1W4Vu6w1RdcrFUnbGx?filename=chopper%20challenge.zip"
+    [Christmas Chaos]="${ipfsGateway}/ipfs/QmYx11vsMDBgjPd1coZPGHxMXf2qtf4icqmB3Q9iUazyQv?filename=ChristmasChaos.zip"
+    [Kitchensinc Games]="${ipfsGateway}/ipfs/QmdkLPig6Kp3AZTwKAhjrhhsEuvhFCFhm6SHLUQVeNNYCb?filename=kitchen.tar.xz"
+    [Oh Shit]="${ipfsGateway}/ipfs/QmQnAJJrt5uABFziQc7enXYrJ74J9GKQSMi8Ry8ebsxfPV?filename=OhShit.zip"
+    [Villains From Beyond]="${ipfsGateway}/ipfs/QmWx271xuk3Mv9XTBoVu5BDJvXFZdasawC2nhtV21WAaUU?filename=villains_en.zip"
+)

.includes/proton.sh

@@ -0,0 +1,119 @@
+#!/usr/bin/env bash
+# shellcheck disable=SC2034,SC2154  # Sourced by audiogame-manager and installers with shared globals.
+
+require_umu() {
+    if command -v umu-run &> /dev/null; then
+        return 0
+    fi
+    local message="This game requires umu-launcher. Please install umu-launcher and try again."
+    if declare -F agm_msgbox &> /dev/null; then
+        agm_msgbox "Audio Game Manager" "Audio Game Manager" "$message"
+    else
+        echo "$message" >&2
+    fi
+    return 1
+}
+
+get_umu_bottle() {
+    local gameId="$1"
+    if [[ -z "$gameId" ]]; then
+        echo "get_umu_bottle requires a game id." >&2
+        return 1
+    fi
+
+    export umuGameId="$gameId"
+    export WINEPREFIX="${XDG_DATA_HOME:-$HOME/.local/share}/audiogame-manager/protonBottles/${gameId}"
+    export GAMEID="$gameId"
+    export STORE="${umuStore:-none}"
+    export DISPLAY="${DISPLAY:-:0}"
+    mkdir -p "$WINEPREFIX"
+}
+
+install_proton_bottle() {
+    local gameId="$1"
+    shift || true
+    require_umu || return 1
+    get_umu_bottle "$gameId" || return 1
+
+    if [[ ! -f "${WINEPREFIX}/system.reg" ]]; then
+        umu-run ""
+    fi
+
+    if [[ $# -gt 0 ]]; then
+        umu-run winetricks "$@"
+    fi
+}
+
+umu_windows_path_to_unix() {
+    local windowsPath="$1"
+    local relativePath=""
+    if [[ "$windowsPath" =~ ^[cC]:\\ ]]; then
+        relativePath="${windowsPath:3}"
+        relativePath="${relativePath//\\//}"
+        printf '%s/drive_c/%s\n' "$WINEPREFIX" "$relativePath"
+        return 0
+    fi
+    winepath -u "$windowsPath"
+}
+
+run_umu_game() {
+    local windowsPath="$1"
+    local exePath=""
+    require_umu || return 1
+    if [[ -z "${umuGameId:-}" ]]; then
+        echo "UMU game id is not set for ${game[2]:-selected game}." >&2
+        return 1
+    fi
+    get_umu_bottle "$umuGameId" || return 1
+    exePath="$(umu_windows_path_to_unix "$windowsPath")"
+    if [[ ! -f "$exePath" ]]; then
+        echo "UMU executable not found: $exePath" >&2
+        return 1
+    fi
+    pushd "${exePath%/*}" > /dev/null || return 1
+    umu-run "$exePath"
+    popd > /dev/null || return 1
+}
+
+add_umu_launcher() {
+    local gameId="$1"
+    local windowsPath="$2"
+    shift 2
+    local launchSettings="umu|${windowsPath}|${game}|export umuGameId=${gameId}"
+
+    while [[ $# -gt 0 ]]; do
+        launchSettings+="|$1"
+        shift
+    done
+
+    if ! grep -F -q -x "$launchSettings" "$configFile" 2> /dev/null; then
+        echo "$launchSettings" >> "$configFile"
+        sort -t '|' -k3,3f -o "$configFile" "$configFile"
+    fi
+}
+
+set_umu_reg_value() {
+    local key="$1"
+    local valueName="$2"
+    local valueData="$3"
+    wine reg add "$key" /v "$valueName" /t REG_SZ /d "$valueData" /f
+}
+
+set_umu_app_winver() {
+    local exeName="$1"
+    local winVersion="$2"
+    set_umu_reg_value "HKCU\\Software\\Wine\\AppDefaults\\${exeName}" "Version" "$winVersion"
+}
+
+install_crlf_file() {
+    local sourceFile="$1"
+    local destFile="$2"
+    mkdir -p "${destFile%/*}"
+    perl -pe 's/\r?\n/\r\n/' "$sourceFile" > "$destFile"
+}
+
+stop_umu_bottle() {
+    if command -v wineserver &> /dev/null; then
+        wineserver -k 2> /dev/null || true
+    fi
+}

.includes/update.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+
+# Check for latest news
+check_news() {
+    # For use by update scripts that want to source functions in this file.
+    [[ "$agmNoLaunch" == "true" ]] && return
+    trap return INT
+    # url for news file
+    local newsFile="https://stormgames.wolfe.casa/media/agm.ogg"
+    local newsPath="${configFile%/*.conf}/.news"
+    local newsTag="$(curl --connect-timeout 5 -sI "$newsFile" | grep -i '^etag: "' | cut -d '"' -f2)"
+    if [[ -z "${newsTag}" ]]; then
+        return
+    fi
+    local newsOldTag="$(cat "$newsPath" 2> /dev/null)"
+    if [[ "$newsTag" != "$newsOldTag" ]]; then
+        agm_yesno 'Audiogame Manager News' 'Audiogame Manager News' 'Audiogame manager news is available. Would you like to play it now?' || return
+        sox -qV0 "$newsFile" -d  &> /dev/null
+        echo -n "$newsTag" > "$newsPath"
+    fi
+}
+
+# Automatic update function
+# Automatic update function
+update() {
+    if ! [[ -d ".git" ]]; then
+        return
+    fi
+    # Check if we're in a detached HEAD state
+    if ! git symbolic-ref -q HEAD &> /dev/null; then
+        return
+    fi
+    local url="$(git ls-remote --get-url)"
+    if [[ "$url" =~ ^ssh://|git@|gitea@ ]] || [[ -z "$url" ]]; then
+        return
+    fi
+    git remote update &> /dev/null
+    local upstream='@{u}'
+    local home="$(git rev-parse @)"
+    local remote="$(git rev-parse "$upstream")"
+if [[ "$home" == "$remote" ]]; then
+    return
+fi
+    agm_yesno "Audiogame Manager" "Audiogame Manager" "Updates are available. Would you like to update now?" || return
+    
+    # Perform git pull quietly, then show only the important changes
+    local updateResult
+    git pull --quiet >/dev/null 2>&1
+    updateResult=$?
+    
+    # Get the important information: commit messages and summary
+    local changesSummary
+    changesSummary=$({
+        echo "UPDATE COMPLETED"
+        echo
+        echo "Recent changes:"
+        git log '@{1}..' --pretty=format:'• %an: %s' | tac
+        echo
+        echo "Update summary:"
+        git diff --stat '@{1}..' | tail -1
+    } 2>/dev/null)
+    
+    # Show only the meaningful update information
+    agm_msgbox "Update Complete" "Audiogame Manager" "$changesSummary"
+    
+    exit $updateResult
+}

.install/A Hero's Call.sh

@@ -0,0 +1,9 @@
+download "https://blindgamers.com/downloads/a-heros-call-freeware.zip" "https://stormgames.wolfe.casa/downloads/nvdaControllerClient32.dll"
+export winVer="win7"
+export winetricksSettings="vd=1024x768"
+install_wine_bottle
+# Dotnet is evil. That is all.
+LC_ALL=C DISPLAY="" winetricks -q dotnet462 xna40
+wineserver -k # Really!
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files" "${cache}/a-heros-call-freeware.zip"
+add_launcher "c:\Program Files\a-heros-call\A Hero's Call.exe"

.install/Adrian's Doom.sh

@@ -0,0 +1,4 @@
+download "https://agarchive.net/games/mt/adrian's%20doom.exe"
+install_wine_bottle
+wine "${cache}/adrian's doom.exe" /silent
+add_launcher "c:\Program Files (x86)\Two Caring Citizens\Adrian's Doom!\adrian.exe"

.install/Adventurers At C.sh

@@ -0,0 +1,5 @@
+download "http://www.vgstorm.com/aac/aac.zip" "https://www.agarchive.net/games/vg/adventure%20at%20c%20stages.7z"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/aac" "${cache}/aac.zip"
+install_with_progress 7z "Extracting game files..." x -o"$WINEPREFIX/drive_c/Program Files/aac/stages" "${cache}/adventure at c stages.7z"
+add_launcher "c:\Program Files\aac\aac.exe"

.install/Alien Outback.sh

@@ -0,0 +1,12 @@
+download "http://download.dracoent.com/Windows/classic/AOSetup.exe"
+# Uses standard wine path based on architecture (win32/win64)
+export winVer="win7"
+install_wine_bottle vb6run dx8vb quartz
+cp -fv "${cache}/AOSetup.exe" "$WINEPREFIX/drive_c/windows/temp/"
+wine "c:/windows/temp/AOSetup.exe" /sp- /silent
+rm -fv "$WINEPREFIX/drive_c/windows/temp/AOSetup.exe"
+# warning warning warning: Do not change location, or installer will not function.
+# FIXME: Hacky, but it works. Install dotnet20 by itself so it actually doesn't hang.
+winetricks -q dotnet20
+wineserver -k # Damn you, dotnet.
+add_launcher "c:\Program Files (x86)\Draconis Entertainment\Alien Outback\ao.exe"

.install/Angel Gift.sh

@@ -0,0 +1,4 @@
+download "https://agarchive.net/games/other/AngelGift.zip"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/Angel Gift" "$cache/AngelGift.zip"
+add_launcher 'c:\Program Files\Angel Gift\ag.exe'

.install/AudioDisc.sh

@@ -0,0 +1,4 @@
+download "https://agarchive.net/games/other/audiodisc.zip"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files" "${cache}/audiodisc.zip"
+add_launcher "c:\Program Files\audiodisc\disco.exe"

.install/AudioQuake.sh

@@ -0,0 +1,8 @@
+# shellcheck shell=bash disable=SC2154  # cache and WINEPREFIX are set by audiogame-manager
+download "https://github.com/matatk/agrip/releases/download/2020.0-beta1/AudioQuake+LDL_2020.0-beta1_Windows.zip" "https://stormgames.wolfe.casa/downloads/quake.zip"
+export winVer="win7"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files" "${cache}/AudioQuake+LDL_2020.0-beta1_Windows.zip"
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/AudioQuake/id1" "${cache}/quake.zip"
+add_launcher "c:\Program Files\AudioQuake\AudioQuake.exe"
+alert "After you launch the game, press tab then enter and it should begin speaking."

.install/Axel Pong.sh

@@ -0,0 +1,4 @@
+download "https://axelek.pl/index/axel_pong.7z"
+install_wine_bottle
+install_with_progress 7z "Extracting game files..." x -o"$WINEPREFIX/drive_c/Program Files/Axel Pong" "${cache}/axel_pong.7z"
+add_launcher "c:\Program Files\Axel Pong\axel_pong.exe"

.install/BG 15 Puzzle.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG 15 Puzzle]}"
+install_wine_bottle
+wine "${cache}/FPB32Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\FifteenB\FifteenB.exe"

.install/BG 2048.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG 2048]}"
+install_wine_bottle
+wine "${cache}/BG204832Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\BG2048B\BG2048.exe"

.install/BG Aces Up Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Aces Up Solitaire]}"
+install_wine_bottle
+wine "${cache}/ASB32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\AcesUpB\AcesUpB.exe"

.install/BG Alchemy.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Alchemy]}"
+install_wine_bottle
+wine "${cache}/BAC32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\AlchemyB\AlchemyB.exe"

.install/BG Battleship.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Battleship]}"
+install_wine_bottle
+wine "${cache}/BGB32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\BattleshipB\BGBattleship.exe"

.install/BG Boggle.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Boggle]}"
+install_wine_bottle
+wine "${cache}/BGB32Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\BoggleB\BoggleB.exe"

.install/BG Boxes.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Boxes]}"
+install_wine_bottle
+wine "${cache}/BXB32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\BoxesB\BoxesB.exe"

.install/BG Brainiac.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Brainiac]}"
+install_wine_bottle
+wine "${cache}/BRN32Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\BrainiacB\BrainiacB.exe"

.install/BG Chess Challenge.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Chess Challenge]}"
+install_wine_bottle
+wine "${cache}/BGC32Setup10d.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\ChessB\BGChess.exe"

.install/BG Code Breaker.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Code Breaker]}"
+install_wine_bottle
+wine "${cache}/BCB32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\CodeBreakerB\BGCodeBreaker.exe"

.install/BG Cribbage Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Cribbage Solitaire]}"
+install_wine_bottle
+wine "${cache}/BCS32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\CribSolB\CribSolB.exe"

.install/BG Cribbage.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Cribbage]}"
+install_wine_bottle
+wine "${cache}/BGC32Setup12e.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\CribbageB\CribbageB.exe"

.install/BG Crossword Puzzle.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Crossword Puzzle]}"
+install_wine_bottle
+wine "${cache}/BGX32Setup10h.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\CrosswordB\CrosswordB.exe"

.install/BG Draw Dominoes.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Draw Dominoes]}"
+install_wine_bottle
+wine "${cache}/BDD32Setup.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\DrawDominoesB\DrawDominoesB.exe"

.install/BG Elevens Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Elevens Solitaire]}"
+install_wine_bottle
+wine "${cache}/ESB32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\ElevensB\ElevensB.exe"

.install/BG Fives Dominoes.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Fives Dominoes]}"
+install_wine_bottle
+wine "${cache}/BFD32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\FivesDominoesB\FivesDominoesB.exe"

.install/BG Free Cell Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Free Cell Solitaire]}"
+install_wine_bottle
+wine "${cache}/BGF32Setup20.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\FreecellB\FreecellB.exe"

.install/BG Golf Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Golf Solitaire]}"
+install_wine_bottle
+wine "${cache}/GSB32Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\GolfSolitaireB\GolfSolitaireB.exe"

.install/BG Hangman.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Hangman]}"
+install_wine_bottle
+wine "${cache}/HMB32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\HangmanB\HangmanB.exe"

.install/BG Hearts.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Hearts]}"
+install_wine_bottle
+wine "${cache}/${BGH32Setup10b.exe}" /silent
+add_launcher "c:\Program Files (x86)\Games\HeartsB\HeartsB.exe"

.install/BG Klondike Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Klondike Solitaire]}"
+install_wine_bottle
+wine "${cache}/BGK32Setup10b.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\KlondikeB\KlondikeB.exe"

.install/BG LAP.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG LAP]}"
+install_wine_bottle
+wine "${cache}/LAP32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\LAP\LAP.exe"

.install/BG Master Mind.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Master Mind]}"
+install_wine_bottle
+wine "${cache}/BMM32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\MastermindB\BGMasterMind.exe"

.install/BG Mine Sweeper.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Mine Sweeper]}"
+install_wine_bottle
+wine "${cache}/MSB32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\MinesweeperB\MinesweeperB.exe"

.install/BG Nomination Whist.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Nomination Whist]}"
+install_wine_bottle
+wine "${cache}/BNW32Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\NomWhistB\NomWhistB.exe"

.install/BG Penguin Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Penguin Solitaire]}"
+install_wine_bottle
+wine "${cache}/BPS32Setup10c.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\PenguinB\PenguinB.exe"

.install/BG Poker Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Poker Solitaire]}"
+install_wine_bottle
+wine "${cache}/BPS32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\PokerSolB\PokerSolB.exe"

.install/BG Pyramid Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Pyramid Solitaire]}"
+install_wine_bottle
+wine "${cache}/PSB32Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\PyramidB\PyramidB.exe"

.install/BG Scorpion Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Scorpion Solitaire]}"
+install_wine_bottle
+wine "${cache}/BSS32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\ScorpionB\ScorpionB.exe"

.install/BG Scrabble.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Scrabble]}"
+install_wine_bottle
+wine "${cache}/BGS32Setup20.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\ScrabbleB\ScrabbleB.exe"

.install/BG Simon.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Simon]}"
+install_wine_bottle
+wine "${cache}/BGS32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\SimonB\SimonB.exe"

.install/BG Spider Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Spider Solitaire]}"
+install_wine_bottle
+wine "${cache}/SPB32Setup10b.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\SpiderB\SpiderB.exe"

.install/BG Sudoku.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Sudoku]}"
+install_wine_bottle
+wine "${cache}/SDB32Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\SudokuB\SudokuB.exe"

.install/BG Tablic Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Tablic Solitaire]}"
+install_wine_bottle
+wine "${cache}/SDB32Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\TabSolB\BGTabSol.exe"

.install/BG Tri-Peaks Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Tri-Peaks Solitaire]}"
+install_wine_bottle
+wine "${cache}/TPB32Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\TriPeaksB\TriPeaksB.exe"

.install/BG Twenty 20 Cricket.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Twenty 20 Cricket]}"
+install_wine_bottle
+wine "${cache}/T20B32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\T20CricketB\CricketB.exe"

.install/BG Uno.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Uno]}"
+install_wine_bottle
+wine "${cache}/BGU32Setup11a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\UnoB\UnoB.exe"

.install/BG Word Builder.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Word Builder]}"
+install_wine_bottle
+wine "${cache}/BWB32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\WordBuilderB\WordBuilderB.exe"

.install/BG Word Candy.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Word Candy]}"
+install_wine_bottle
+wine "${cache}/WCB32Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\WordCandyB\WordCandyB.exe"

.install/BG Word Jumble.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Word Jumble]}"
+install_wine_bottle
+wine "${cache}/BWJ32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\WordJumbleB\WordJumbleB.exe"

.install/BG Word Maze.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Word Maze]}"
+install_wine_bottle
+wine "${cache}/BWM32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\WordMazeB\WordMazeB.exe"

.install/BG Word Solitaire.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Word Solitaire]}"
+install_wine_bottle
+wine "${cache}/WSB32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\WordSolitaireB\WordSolitaireB.exe"

.install/BG Word Target.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Word Target]}"
+install_wine_bottle
+wine "${cache}/WTB32Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\WordTargetB\WordTargetB.exe"

.install/BG Word Yahtzee.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Word Yahtzee]}"
+install_wine_bottle
+wine "${cache}/BWY32Setup10.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\WordYahtzeeB\BGWordYahtzee.exe"

.install/BG Yahtzee.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[BG Yahtzee]}"
+install_wine_bottle
+wine "${cache}/BGY32Setup10a.exe" /silent
+add_launcher "c:\Program Files (x86)\Games\yahtzeeB\BGYahtzee.exe"

.install/Balatro.sh

@@ -0,0 +1,15 @@
+export WINEARCH=win64
+export winVer="win10"
+install_wine_bottle
+get_steam "2379780" "https://store.steampowered.com/app/2379780/Balatro/"
+mkdir -p "$WINEPREFIX/drive_c/users/$USER/AppData/Roaming/Balatro/Mods"
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/users/$USER/AppData/Roaming/Balatro" "$cache/BlackHole-Release.zip"
+pushd "$WINEPREFIX/drive_c/users/$USER/AppData/Roaming/Balatro/Mods"
+(cat mod_urls.txt ; echo) | while read -r x ; do
+    git clone "$x"
+done
+cp -fv BlackHole/bin/*.dll "$WINEPREFIX/drive_c/Program Files/Balatro"
+cp -fv "$cache/Tolk.dll" "$WINEPREFIX/drive_c/Program Files/Balatro/tolk.dll"
+cp -fv "$cache/Tolk.dll" BlackHole/bin/tolk.dll
+cp -fv ../version.dll "$WINEPREFIX/drive_c/Program Files/Balatro"
+add_launcher 'c:\Program Files\Balatro\Balatro.exe' 'export WINEDLLOVERRIDES=version=n,b'

.install/Battle Zone.sh

@@ -0,0 +1,5 @@
+download "https://www.agarchive.net/games/gameMadnessInteractive/battle%20zone%2013.5%20setup.exe"
+export winVer="win7"
+install_wine_bottle
+wine "${cache}/battle zone 13.5 setup.exe" /silent
+add_launcher "c:\Program Files (x86)\Battle Zone\ss.exe"

.install/Battle of the Hunter.sh

@@ -0,0 +1,6 @@
+download "http://files.tunmi13.com/projects_archive/bth.zip"
+# Uses standard wine path based on architecture (win32/win64)
+export winVer="win7"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/$game" "${cache}/bth.zip"
+add_launcher "c:\Program Files\\${game}\bth.exe"

.install/Battlefield 2D.sh

@@ -0,0 +1,7 @@
+get_installer "bf.zip" "https://tunmi13.itch.io/battlefield-2d"
+export WINEARCH=win64
+export winVer="win8"
+# Uses standard wine path based on architecture (win32/win64)
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/" "${cache}/bf.zip"
+add_launcher "c:\Program Files\bf\bf.exe"

.install/Beatstar Pro.sh

@@ -0,0 +1,8 @@
+#//
+download "https://oriolgomez.com/games/beat_windows.zip"
+# Sapi is broken on win64 for now, and this game doesn't support nvda it seems.
+export WINEARCH=win64
+export winVer="win7"
+install_wine_bottle mf
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/Beatstar Pro" "${cache}/beat_windows.zip"
+add_launcher "c:\Program Files\Beatstar Pro\beatstar.exe"

.install/Blades of Glory.sh

@@ -0,0 +1,6 @@
+#//Disable
+download "https://nibblenerds.com/static/blades_of_glory.zip"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/Blades of Glory" "${cache}/blades_of_glory.zip"
+install_discord_rpc_bridge
+add_launcher "c:\Program Files\Blades of Glory\blades_of_glory.exe"

.install/Blind Drive.sh

@@ -0,0 +1,9 @@
+get_installer "Blind Drive 1.1.112.00i-win64.zip" "https://lofipeople.itch.io/blind-drive"
+export WINEARCH=win64
+export winVer="win8"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/blind-drive" "${cache}/Blind Drive 1.1.112.00i-win64.zip"
+# Weird work around to get keyboard working.
+winetricks -q usetakefocus=y
+winetricks -q usetakefocus=n
+add_launcher "c:\Program Files\blind-drive\Blind Drive.exe"

.install/Bloodshed.sh

@@ -0,0 +1,5 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "${ipfs[Bloodshed]}"
+install_wine_bottle
+cp "${cache}/bloodshed.exe" "$WINEPREFIX/drive_c/Program Files/"
+add_launcher "c:\Program Files\bloodshed.exe"

.install/Bokurano Daibouken 2.sh

@@ -0,0 +1,6 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "https://www.nyanchangames.com/softs/nn2_setup.exe"
+export winVer="win7"
+install_wine_bottle
+install_with_progress 7z "Extracting game files..." x -o"$WINEPREFIX/drive_c/nyanchangame/bk2" "${cache}/nn2_setup.exe"
+add_launcher "c:\nyanchangame\bk2\play.exe"

.install/Bokurano Daibouken 3.sh

@@ -0,0 +1,27 @@
+export WINEARCH="win64"  # Migrated to wine64
+download "https://www.nyanchangames.com/softs/nn3_setup.exe"
+export winVer="win7"
+install_wine_bottle
+install_with_progress 7z "Extracting game files..." x -o"$WINEPREFIX/drive_c/nyanchangame/bk3" "${cache}/nn3_setup.exe"
+if [[ ! -r "${cache}/bk3-dict.dat" ]]; then
+    echo "http://www.nyanchangames.com/order/bk3translate.html" | xclip -selection clipboard 2> /dev/null
+    agm_msgbox "Bokurano Daibouken 3" "Bokurano Daibouken 3" "If you would like English translations, the file is available at http://www.nyanchangames.com/order/bk3translate.html. Save the dict.dat file to your Downloads or Desktop directory. For convenience the url has been copied to your clipboard. Press enter when you are ready to continue."
+fi
+dictFile=""
+for i in "${HOME}/Downloads/dict.dat" "${HOME}/Desktop/dict.dat" ; do
+    if [[ -r "$i" ]]; then
+        dictFile="$i"
+    fi
+done
+if [[ "${#dictFile}" -ge 3 ]] && [[ ! -r "${cache}/bk3-dict.dat" ]]; then
+    agm_yesno "Bokurano Daibouken 3" "Bokurano Daibouken 3" "Possible English translation file found at $dictFile. Would you like to use it for BK3?" && cp -fv "$dictFile" "${cache}/bk3-dict.dat"
+fi
+if [[ -f "${cache}/bk3-dict.dat" ]] ; then
+    cp -fv "${cache}/bk3-dict.dat" "${WINEPREFIX}/drive_c/nyanchangame/bk3/dict.dat"
+    if [[ -f "${cache}/nvdaControllerClient32.dll" ]] ; then
+        cp -fv "${cache}/nvdaControllerClient32.dll" "${WINEPREFIX}/drive_c/nyanchangame/bk3/data/nvdaControllerClient32.dll"
+    fi
+else
+    rm -fv "${WINEPREFIX}/drive_c/nyanchangame/bk3/data/nvdaControllerClient32.dll"
+fi
+add_launcher "c:\nyanchangame\bk3\play.exe"

.install/Bokurano Daibouken.sh

@@ -0,0 +1,6 @@
+download "https://www.nyanchangames.com/softs/nn_setup.exe"
+export WINEARCH="win64"  # Migrated to wine64
+export winVer="win7"
+install_wine_bottle
+install_with_progress 7z "Extracting game files..." x -o"$WINEPREFIX/drive_c/nyanchangame/bk" "${cache}/nn_setup.exe"
+add_launcher "c:\nyanchangame\bk\play.exe"

.install/Bombercats.sh

@@ -0,0 +1,6 @@
+download "http://oriolgomez.com/games/bombercats_en.zip"
+# Uses standard wine path based on architecture (win32/win64)
+export winVer="win7"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/bomvercats" "${cache}/bombercats_en.zip"
+add_launcher "c:\Program Files\bomvercats\game.exe"

.install/Bop It Emulator.sh

@@ -0,0 +1,5 @@
+download "http://www.masonasons.me/softs/BopItEmulator3.1PasswordIsBopIt.7z"
+export winVer="win7"
+install_wine_bottle
+install_with_progress 7z "Extracting game files..." x -o"$WINEPREFIX/drive_c/Program Files/Bop It" "${cache}/BopItEmulator3.1PasswordIsBopIt.7z" -pBopIt
+add_launcher "c:\Program Files\Bop It\bop.exe"

.install/Bounce Bounce.sh

@@ -0,0 +1,5 @@
+export WINEARCH=win64
+get_installer "bounce_bounce.rar" "https://kavyapriya.itch.io/bounce-bounce"
+install_wine_bottle
+unrar x "${cache}/bounce_bounce.rar" -op"$WINEPREFIX/drive_c/Program Files"
+add_launcher "c:\Program Files\bounce_bounce\bounce.exe"

.install/Breed Memorial.sh

@@ -0,0 +1,6 @@
+#//
+download "https://hirotaka2014.sakura.ne.jp/mh0406/game/breed_memorial.zip" "${nvdaControllerClient32Dll}"
+export winVer="win7"
+install_wine_bottle cjkfonts
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/" "${cache}/breed_memorial.zip"
+add_launcher "c:\Program Files\Breed memorial\Breed memorial\breed memorial.exe"

.install/Breu2 Shadow Hunt.sh

@@ -0,0 +1,6 @@
+get_installer "breu2.zip" "https://breu.itch.io/shadowhunt"
+export WINEARCH=win64
+export winVer="win8"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/" "${cache}/breu2.zip"
+add_launcher "c:\Program Files\breu2\breu2.exe"

.install/Castaways 2.sh

@@ -0,0 +1,7 @@
+download "http://www.kaldobsky.com/audiogames/castaways2beta.zip"
+# Uses standard wine path based on architecture (win32/win64)
+export winVer="win7"
+install_wine_bottle vb6run dx8vb
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/castaways2" "${cache}/castaways2beta.zip"
+wine "c:\Program Files\castaways2\Checkup.exe" /verysilent
+add_launcher "c:\Program Files\castaways2\Castaways2.exe"

.install/Castaways.sh

@@ -0,0 +1,7 @@
+download "https://www.kaldobsky.com/audiogames/castaways.zip"
+# Uses standard wine path based on architecture (win32/win64)
+export winVer="win7"
+install_wine_bottle vb6run dx8vb
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/castaways" "${cache}/castaways.zip"
+wine "c:\Program Files\castaways\Checkup.exe" /verysilent
+add_launcher "c:\Program Files\castaways\Castaways.exe"

.install/Challenge of the Horse.sh

@@ -0,0 +1,5 @@
+download "http://files.tunmi13.com/projects_archive/coth.zip"
+export winVer="win7"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/$game" "${cache}/coth.zip"
+add_launcher "c:\Program Files\\${game}\game.exe"

.install/Change Reaction.sh

@@ -0,0 +1,12 @@
+download "https://download.dracoent.com/Windows/ChangeReactionSetup.exe"
+# Uses standard wine path based on architecture (win32/win64)
+export winVer="win7"
+install_wine_bottle vb6run dx8vb quartz
+cp -fv "${cache}/ChangeReactionSetup.exe" "$WINEPREFIX/drive_c/windows/temp/"
+wine "c:/windows/temp/ChangeReactionSetup.exe" /sp- /silent
+rm -fv "$WINEPREFIX/drive_c/windows/temp/ChangeReactionSetup.exe"
+# warning warning warning: Do not change location, or installer will not function.
+# FIXME: Hacky, but it works. Install dotnet20 by itself so it actually doesn't hang.
+winetricks -q dotnet20
+wineserver -k # Damn you, dotnet.
+add_launcher "c:\Program Files (x86)\Draconis Entertainment\Change Reaction\ChangeReactionGui.exe"

.install/Chillingham.sh

@@ -0,0 +1,4 @@
+download "https://stormgames.wolfe.casa/downloads/chillingham.zip"
+install_wine_bottle vb6run mfc42
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files" "$cache/chillingham.zip"
+add_launcher "c:\Program Files\chillingham\Chillingham.exe"

.install/Chopper Challenge.sh

@@ -0,0 +1,4 @@
+download "${ipfs[Chopper Challenge]}"
+install_wine_bottle vb6run dx8vb
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files" "${cache}/chopper challenge.zip"
+add_launcher "c:\Program Files\chopper challenge\Chopper.exe"

.install/Christmas Chaos.sh

@@ -0,0 +1,7 @@
+export WINEARCH=win64
+export winVer="win7"
+download "${ipfs[Christmas Chaos]}" "https://stormgames.wolfe.casa/downloads/Tolk.dll"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files" "${cache}/ChristmasChaos.zip"
+find "${WINEPREFIX}" -type f -name 'Tolk.dll' -exec cp -fv "${cache}/Tolk.dll" "{}" \;
+add_launcher "c:\Program Files\ChristmasChaos\ChristmasChaos.exe"

.install/Christmas WhoopAss.sh

@@ -0,0 +1,4 @@
+download "https://www.agarchive.net/games/draconis/christmas%20whoopass%20setup.exe"
+install_wine_bottle vb6run dx8vb
+wine "${cache}/christmas whoopass setup.exe" /sp- /silent
+add_launcher "c:\Program Files (x86)\Draconis Entertainment\Christmas Whoop Ass\wa.exe"

.install/Clashes of the Sky.sh

@@ -0,0 +1,6 @@
+get_installer "clashes_of_the_sky.zip" "https://tunmi13.itch.io/clashes-of-the-sky"
+# Uses standard wine path based on architecture (win32/win64)
+export winVer="win7"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files" "${cache}/clashes_of_the_sky.zip"
+add_launcher 'c:\Program Files\clashes_of_the_sky\clash.exe'

.install/Code Dungeon.sh

@@ -0,0 +1,9 @@
+get_installer "codedungeon-win-64.zip" "https://stealcase.itch.io/codedungeon"
+export WINEARCH=win64
+export winVer="win8"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/code-dungeon" "${cache}/codedungeon-win-64.zip"
+# Weird work around to get keyboard working.
+winetricks -q usetakefocus=y
+winetricks -q usetakefocus=n
+add_launcher "c:\Program Files\code-dungeon\Code Dungeon.exe"

.install/Conjury.sh

@@ -0,0 +1,5 @@
+export WINEARCH=win64
+export winVer="win8"
+install_wine_bottle
+get_steam 2684520 "https://store.steampowered.com/app/2684520/Conjury/"
+add_launcher 'c:\Program Files\Conjury\release\Conjury.exe'

.install/Constant Battle.sh

@@ -0,0 +1,6 @@
+#//
+export winVer="win7"
+download "https://renovagames.com/bc/BC-Setup.exe"
+install_wine_bottle cjkfonts
+wine "${cache}/BC-Setup.exe" /silent
+#add_launcher "c:\Program Files (x86)\"

.install/Constant Motion.sh

@@ -0,0 +1,6 @@
+export WINEARCH=win64
+export winVer="win7"
+download "https://samtupy.com/games/cm.zip"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/ConstantMotion" "$cache/cm.zip"
+add_launcher 'c:\Program Files\ConstantMotion\cm.exe'

.install/Copter Mission.sh

@@ -0,0 +1,5 @@
+export winVer="win7"
+download "http://oriolgomez.com/games/copter_en.zip"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/copter mission" "${cache}/copter_en.zip"
+add_launcher "c:\Program Files\copter mission\game.exe"

.install/Crazy Party.sh

@@ -0,0 +1,7 @@
+download "http://pragmapragma.free.fr/crazy-party/Crazy-Party-beta82.zip" "https://stormgames.wolfe.casa/downloads/Tolk.dll"
+export WINEARCH=win64
+export winVer="win8"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files" "${cache}/Crazy-Party-beta82.zip"
+find "${WINEPREFIX}" -type f -name 'Tolk.dll' -exec cp -fv "${cache}/Tolk.dll" "{}" \;
+add_launcher "c:\Program Files\Crazy-Party-beta82\Crazy Party.exe"

.install/Crazy Tennis.sh

@@ -0,0 +1,4 @@
+download "https://www.agarchive.net/games/VIP/crazy%20tennis%20setup.exe"
+install_wine_bottle
+wine "${cache}/crazy tennis setup.exe" /sp- /silent
+add_launcher "c:\Program Files (x86)\Crazytennis\crazytennis.exe"

.install/Crime Hunter.sh

@@ -0,0 +1,6 @@
+export WINEARCH=win64
+export winVer="win7"
+download "http://masonasons.me/softs/CH2.0Win.zip"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/crime-hunter" "${cache}/CH2.0Win.zip"
+add_launcher "c:\Program Files\crime-hunter\ch.exe"

.install/Danger City.sh

@@ -0,0 +1,9 @@
+download "https://www.agarchive.net/games/xl/DangerCityBeta2.exe"
+install_wine_bottle vb6run dx8vb
+wine "$cache/DangerCityBeta2.exe" /silent &
+xdotool sleep 15 key --clearmodifiers --delay 200 Return 2> /dev/null
+xdotool sleep 5 key --clearmodifiers --delay 200 Return 2> /dev/null
+xdotool sleep 5key --clearmodifiers --delay 200 Return 2> /dev/null
+xdotool sleep 10 --clearmodifiers --delay 200 Return 2> /dev/null
+wineserver -w
+add_launcher 'c:\Program Files\Danger City\dc.exe'

.install/Danger on the Wheel.sh

@@ -0,0 +1,6 @@
+download "http://oriolgomez.com/games/wheel_en.zip"
+# Uses standard wine path based on architecture (win32/win64)
+export winVer="win7"
+install_wine_bottle
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/danger on the wheel" "${cache}/wheel_en.zip"
+add_launcher "c:\Program Files\danger on the wheel\game.exe"

.install/Dark Destroyer.sh

@@ -0,0 +1,6 @@
+#//
+# No custom bottle needed - use standard wine path based on architecture
+download "https://www.agarchive.net/games/pb/Dark-Destroyer-Setup.exe"
+install_wine_bottle ie6
+wine "$cache/Dark-Destroyer-Setup.exe" /silent
+add_launcher 'c:\Pbgames\Dark_destroyer\darkdestroyer.exe'

.install/Daytona and the Book of Gold.sh

@@ -0,0 +1,7 @@
+export winVer="win7"
+export winetricksSettings="vd=1024x768"
+download "https://kaldobsky.com/audiogames/Daytona.zip"
+install_wine_bottle vb6run dx8vb quartz
+install_with_progress unzip "Extracting game files..." -d "$WINEPREFIX/drive_c/Program Files/daytona" "${cache}/Daytona.zip"
+wine 'c:\Program Files\daytona\checkup.exe' /verysilent
+add_launcher "c:\Program Files\daytona\Daytona.exe"