diff --git a/docs/superpowers/contracts/steam-compatibility-split-2026-08-17.json b/docs/superpowers/contracts/steam-compatibility-split-2026-08-17.json new file mode 100644 index 00000000..0b701130 --- /dev/null +++ b/docs/superpowers/contracts/steam-compatibility-split-2026-08-17.json @@ -0,0 +1,16 @@ +{ + "title": "Split steam_compatibility.sh 663 -> 140 + four libraries", + "objective": "steam_compatibility.sh is over the 250-line cap with no deployed copy. Split it into an entry script plus libraries grouped by the state each touches, so that no file assigns a global it never reads - the SC2034 constraint that decides where a shell seam can fall in this repo.", + "acceptance_criteria": [ + "All five resulting files are under 250 lines; the over-cap total falls 26 -> 25", + "All 33 top-level functions are verbatim", + "Every library passes shellcheck standalone with no suppression", + "The script runs: --help prints usage and exits 0 through the split source graph" + ], + "out_of_scope": [ + "The API paths, which need Steam credentials and a network round-trip", + "libre_translate.sh and diagnose_pacman_hook_stall.sh, both parked", + "The phone_focus_mode scripts and the pacman-wrapper pair" + ], + "verifier": "bash meta/scripts/verify_shell_split.sh for the verbatim claim; bash steam_compatibility.sh --help for the runtime claim; shellcheck standalone on each library; bash ~/utils/scripts/check_file_length.sh --all." +} diff --git a/docs/superpowers/evidence/steam-compatibility-split-2026-08-17.json b/docs/superpowers/evidence/steam-compatibility-split-2026-08-17.json new file mode 100644 index 00000000..ed91b5b5 --- /dev/null +++ b/docs/superpowers/evidence/steam-compatibility-split-2026-08-17.json @@ -0,0 +1,53 @@ +{ + "intent": "Split steam_compatibility.sh (663 lines) into an entry script and four sourced libraries, all under the 250-line cap, moving every function verbatim.", + "scope": [ + "steam_compatibility.sh 663 -> 140", + "New: lib/steam_requirements.sh 199, lib/steam_report.sh 156, lib/steam_api.sh 124, lib/steam_credentials.sh 103", + "Non-goal: any behaviour change" + ], + "changes": [ + "Grouped by what each function touches rather than by size: requirement parsing and scoring with the hardware detection that feeds it, the Steam/ProtonDB API calls, credential and presentation helpers, and the run loop with the cache it reads.", + "The grouping was driven by the SC2034 writer/reader rule rather than chosen freely. Two arrangements were discarded first: detect_system alone in a lib writes SYSTEM_CPU_CLASS, SYSTEM_GPU_VENDOR and SYSTEM_RAM_GB without reading them, and load_cache_map alone writes CACHE_MAP without reading it. Both were fixed by moving the writer next to its reader - detect_system beside score_game, load_cache_map beside main.", + "The entry script is now colours, defaults, the four source lines, parse_args, the tiny log/die/vlog helpers, and `main \"$@\"`." + ], + "verification": [ + { + "command": "bash meta/scripts/verify_shell_split.sh HEAD ", + "result": "pass", + "evidence": "IDENTICAL: all 33 top-level functions moved verbatim, re-checked after each regrouping." + }, + { + "command": "bash linux_configuration/scripts/single_use/utils/steam_compatibility.sh --help", + "result": "pass", + "evidence": "Prints the full usage block and exits 0. This is a real run of the split script: it proves all four source lines resolve and that main dispatches, which no static check can show." + }, + { + "command": "shellcheck on each of the four libraries standalone", + "result": "pass", + "evidence": "All clean, with no suppression added. The pre-commit hook runs shellcheck without -x, so each file has to stand on its own." + }, + { + "command": "Sourcing each library in a subshell", + "result": "pass", + "evidence": "All four source with no side effects." + }, + { + "command": "pre-commit run --files ", + "result": "pass", + "evidence": "shellcheck and shfmt both pass." + }, + { + "command": "bash ~/utils/scripts/check_file_length.sh --all", + "result": "pass", + "evidence": "25 files over cap, down from 26. The five files are 140, 199, 156, 124 and 103 lines." + } + ], + "risks": [ + "--help exits before any network call, so the run exercises argument parsing and the source graph but not the API paths. Those need Steam credentials and a network round-trip, which is not something to trigger from a split verification.", + "Four libraries is more indirection than three would be, but the writer/reader rule fixed the grouping: merging any two would either put a writer away from its reader or push a file back over the cap." + ], + "rollback": [ + "git revert the commit; the entry script returns to 663 lines and the four libraries disappear.", + "After rollback, confirm steam_compatibility.sh --help still prints usage and exits 0." + ] +} diff --git a/linux_configuration/scripts/single_use/utils/lib/steam_api.sh b/linux_configuration/scripts/single_use/utils/lib/steam_api.sh new file mode 100755 index 00000000..4289ac38 --- /dev/null +++ b/linux_configuration/scripts/single_use/utils/lib/steam_api.sh @@ -0,0 +1,124 @@ +#!/usr/bin/env bash +# Steam library discovery, the Steam and ProtonDB API calls, and requirement +# extraction for steam_compatibility.sh. + +find_steamapps_dirs() { + local dirs=() + for base in "${STEAM_DIRS[@]}"; do + [[ -d $base ]] || continue + if [[ -f "$base/steamapps/libraryfolders.vdf" ]]; then + # Newer format includes nested objects with paths + local paths + paths=$(grep -oE '"path"\s+"[^"]+"' "$base/steamapps/libraryfolders.vdf" | sed -E 's/.*"([^"]+)"/\1/' || true) + if [[ -n $paths ]]; then + while IFS= read -r p; do + [[ -d "$p/steamapps" ]] && dirs+=("$p/steamapps") + done <<< "$paths" + fi + fi + [[ -d "$base/steamapps" ]] && dirs+=("$base/steamapps") + done + # de-dupe + printf "%s\n" "${dirs[@]}" 2> /dev/null | awk '!seen[$0]++' +} + +list_installed_games() { + local d appid name + while IFS= read -r d; do + [[ -d $d ]] || continue + for mf in "$d"/appmanifest_*.acf; do + [[ -f $mf ]] || continue + appid=$(grep -oE '"appid"\s+"[0-9]+"' "$mf" | sed -E 's/.*"([0-9]+)"/\1/' | head -n1) + name=$(grep -oE '"name"\s+"[^"]+"' "$mf" | sed -E 's/.*"([^"]+)"/\1/' | head -n1) + if [[ -n $appid ]]; then + printf "%s\t%s\n" "$appid" "${name:-Unknown}" + fi + done + done < <(find_steamapps_dirs) +} + +list_owned_games_via_api() { + local key="${STEAM_API_KEY:-}" sid="${STEAM_ID64:-}" + if [[ -z $key || -z $sid ]]; then + return 1 + fi + local url="https://api.steampowered.com/IPlayerService/GetOwnedGames/v0001/?key=${key}&steamid=${sid}&include_appinfo=1&include_played_free_games=1&format=json" + http_get "$url" | jq -r '.response.games[]? | "\(.appid)\t\(.name)"' || return 1 +} + +fetch_appdetails_json() { + local appid="$1" + # Using store API (no key) + local url="https://store.steampowered.com/api/appdetails?appids=${appid}&l=en&cc=us" + http_get "$url" || true +} + +extract_requirements_and_platforms() { + # Input: JSON from appdetails; Output: TSV of fields + # Fields: success, linux, windows, mac, min_text, rec_text, type + local appid="$1" json="$2" + # Some apps return {"APPID": {"success":true, "data":{...}}} + local out + out=$(jq -r --arg APP "$appid" ' + .[$APP] as $root | if ($root.success==true and ($root.data|type)=="object") then + ($root.data.platforms.linux // false) as $linux | + ($root.data.platforms.windows // false) as $windows | + ($root.data.platforms.mac // false) as $mac | + ($root.data.type // "") as $type | + # Prefer Linux reqs when present + ($root.data.linux_requirements.minimum // $root.data.pc_requirements.minimum // "") as $min | + ($root.data.linux_requirements.recommended // $root.data.pc_requirements.recommended // "") as $rec | + ["ok", ($linux|tostring), ($windows|tostring), ($mac|tostring), ($min|tostring), ($rec|tostring), ($type|tostring)] | @tsv + else + ["fail", "false", "false", "false", "", "", ""] | @tsv + end' 2> /dev/null <<< "$json") || true + if [[ -z $out ]]; then + out=$'fail false false false ' + fi + printf '%s\n' "$out" +} + +# Read JSON from stdin (avoids storing large/binary data in variables) +extract_requirements_and_platforms_stdin() { + local appid="$1" + local out + out=$(jq -r --arg APP "$appid" ' + .[$APP] as $root | if ($root.success==true and ($root.data|type)=="object") then + ($root.data.platforms.linux // false) as $linux | + ($root.data.platforms.windows // false) as $windows | + ($root.data.platforms.mac // false) as $mac | + ($root.data.type // "") as $type | + ($root.data.linux_requirements.minimum // $root.data.pc_requirements.minimum // "") as $min | + ($root.data.linux_requirements.recommended // $root.data.pc_requirements.recommended // "") as $rec | + ["ok", ($linux|tostring), ($windows|tostring), ($mac|tostring), ($min|tostring), ($rec|tostring), ($type|tostring)] | @tsv + else + ["fail", "false", "false", "false", "", "", ""] | @tsv + end' 2> /dev/null) || true + if [[ -z $out ]]; then + out=$'fail\tfalse\tfalse\tfalse\t\t\t' + fi + printf '%s\n' "$out" +} + +fetch_protondb_tier() { + local appid="$1" + local url="https://www.protondb.com/api/v1/reports/summaries/${appid}.json" + # Returns minimal JSON including .tier, .confidence; we only need .tier + local tier + tier=$(http_get "$url" | jq -r 'try .tier // "unknown"' 2> /dev/null || true) + if [[ -z $tier || $tier == "null" ]]; then + echo "unknown" + else + tr '[:upper:]' '[:lower:]' <<< "$tier" | tr -d '\r\n' + fi +} + +protondb_allowed() { + local tier + tier=$(tr '[:upper:]' '[:lower:]' <<< "${1:-}") + case "$tier" in + platinum | native | gold | silver | unknown | "") return 0 ;; + bronze | pending | borked | unsupported | broken) return 1 ;; + *) return 0 ;; + esac +} diff --git a/linux_configuration/scripts/single_use/utils/lib/steam_credentials.sh b/linux_configuration/scripts/single_use/utils/lib/steam_credentials.sh new file mode 100755 index 00000000..3bc89485 --- /dev/null +++ b/linux_configuration/scripts/single_use/utils/lib/steam_credentials.sh @@ -0,0 +1,103 @@ +#!/usr/bin/env bash +# Credential storage, usage text and small presentation helpers. +# +# load_cache_map stays in the entry script beside the code that reads +# CACHE_MAP, so no file assigns a global it never reads. + +usage() { + cat << USAGE +Usage: $SCRIPT_NAME [--refresh] [--clear-cache] [--verbose] [--help] + +Options: + --refresh Re-analyze all games and overwrite cache (ignore previous results). + --clear-cache Delete cached results before running (implies --refresh). + -v, --verbose Print detailed progress and HTTP/parse steps. + -h, --help Show this help message and exit. +USAGE +} + +require_cmd() { + command -v "$1" > /dev/null 2>&1 || die "Missing dependency: $1" +} + +load_credentials() { + # Prefer environment, else config file + if [[ -n ${STEAM_API_KEY:-} && -n ${STEAM_ID64:-} ]]; then + return 0 + fi + if [[ -r $CONFIG_FILE ]]; then + # shellcheck disable=SC1090 + . "$CONFIG_FILE" || true + fi + if [[ -z ${STEAM_API_KEY:-} || -z ${STEAM_ID64:-} ]]; then + return 1 + fi + return 0 +} + +save_credentials() { + local key="$1" id="$2" + mkdir -p "$CONFIG_DIR" + chmod 700 "$CONFIG_DIR" 2> /dev/null || true + umask 177 + cat > "$CONFIG_FILE" << EOF +# Saved by $SCRIPT_NAME +STEAM_API_KEY="$key" +STEAM_ID64="$id" +EOF +} + +prompt_for_credentials() { + if [[ ! -t 0 ]]; then + die "STEAM_API_KEY/STEAM_ID64 not set and input is non-interactive. Export them or create $CONFIG_FILE." + fi + echo "Steam Web API credentials are required to scan your full library." + echo + echo "Where to get them:" + echo "- Steam Web API Key: https://steamcommunity.com/dev/apikey" + echo " Log in, set any domain (e.g., 127.0.0.1), then copy the key." + echo "- SteamID64 (17-digit ID starting with 765):" + echo " * Easiest: https://steamid.io/ (paste your profile URL to get the 64-bit ID)" + echo " * Or enable URL bar in Steam (Settings > Interface), open your profile; the URL contains the ID." + echo + local key id + read -r -p "Enter Steam Web API Key: " key + read -r -p "Enter Steam 64-bit ID (begins with 765…): " id + if [[ -z $key || -z $id ]]; then + die "Credentials not provided. Exiting." + fi + # Light validation for ID64 + if ! grep -qE '^765[0-9]{14}$' <<< "$id"; then + log "Warning: Steam ID64 format unexpected; continuing anyway." + fi + STEAM_API_KEY="$key" + STEAM_ID64="$id" + export STEAM_API_KEY STEAM_ID64 + save_credentials "$STEAM_API_KEY" "$STEAM_ID64" + log "Saved credentials to $CONFIG_FILE" +} + +print_header() { + printf "%-5s %-8s %-6s %-6s %-8s %-9s %s\n" "Rank" "Score" "MinRAM" "RecRAM" "Linux" "ProtonDB" "Title" +} + +check_network_or_exit() { + # Quick probe to Steam Store API; exit early if not reachable + local probe_url="https://store.steampowered.com/api/appdetails?appids=10&l=en&cc=us" + if ! http_get "$probe_url" | jq -e '."10".success == true' > /dev/null 2>&1; then + log "Warning: store.steampowered.com probe failed (network or rate-limit). Continuing and handling per-app." + fi +} + +is_known_tool_name() { + local name_lc + name_lc=$(tr '[:upper:]' '[:lower:]' <<< "$1") + if grep -qE 'steam linux runtime|proton|compatibility tool' <<< "$name_lc"; then + return 0 + fi + return 1 +} + +ensure_cache_dir() { + mkdir -p "$CACHE_DIR" 2> /dev/null || true +} diff --git a/linux_configuration/scripts/single_use/utils/lib/steam_report.sh b/linux_configuration/scripts/single_use/utils/lib/steam_report.sh new file mode 100755 index 00000000..f5200049 --- /dev/null +++ b/linux_configuration/scripts/single_use/utils/lib/steam_report.sh @@ -0,0 +1,156 @@ +#!/usr/bin/env bash +# The run loop and the on-disk cache for steam_compatibility.sh. +# +# load_cache_map writes CACHE_MAP and main reads it, so writer and reader sit +# in the same file. + +load_cache_map() { + CACHE_MAP=() + if [[ -r $RESULTS_CACHE ]]; then + while IFS= read -r raw_line; do + # Normalize historical caches that contain literal "\t" instead of real tabs + local norm_line + norm_line=$(printf "%s" "$raw_line" | sed -E $'s/\\t/\t/g; s/\r$//') + IFS=$'\t' read -r c_score c_appid c_linux c_min c_rec c_name c_pdb <<< "$norm_line" + [[ -z ${c_appid:-} ]] && continue + c_pdb=${c_pdb:-unknown} + CACHE_MAP["$c_appid"]="$c_score\t$c_appid\t$c_linux\t$c_min\t$c_rec\t$c_name\t$c_pdb" + done < "$RESULTS_CACHE" + fi +} + +main() { + parse_args "$@" + detect_system + log "System: CPU=[$SYSTEM_CPU_MODEL] class=$SYSTEM_CPU_CLASS | GPU=$SYSTEM_GPU_VENDOR | RAM=${SYSTEM_RAM_GB}GB | Arch=$SYSTEM_ARCH" + + local tmpdir + tmpdir=$(mktemp -d) + trap '[[ -n "${tmpdir:-}" ]] && rm -rf "$tmpdir"' EXIT + + local games_tsv="$tmpdir/games.tsv" + : > "$games_tsv" + + # Ensure credentials exist: load from env/config or prompt, else exit + if ! load_credentials; then + prompt_for_credentials + fi + + # Fail fast if we cannot reach the store API to avoid noisy per-app errors + check_network_or_exit + + if list_owned_games_via_api > "$games_tsv" 2> /dev/null; then + log "Fetched owned games via Steam Web API" + fi + + if [[ ! -s $games_tsv ]]; then + die "No games found from Steam Web API. Check STEAM_API_KEY/STEAM_ID64 and network connectivity." + fi + + # Fail fast if we cannot reach the store API to avoid noisy per-app errors + check_network_or_exit + + ensure_cache_dir + if [[ $CLEAR_CACHE -eq 1 ]] && [[ -f $RESULTS_CACHE ]]; then + rm -f "$RESULTS_CACHE" || true + log "Cleared cache: $RESULTS_CACHE" + fi + if [[ $FORCE_REFRESH -eq 0 ]]; then + load_cache_map + else + CACHE_MAP=() + fi + + local results_combined="$tmpdir/results.tsv" + : > "$results_combined" + + local count=0 + local total + total=$(wc -l < "$games_tsv" | tr -d ' ') + [[ -z $total ]] && total=0 + while IFS=$'\t' read -r appid name; do + [[ $ABORT -eq 1 ]] && break + [[ -n $appid ]] || continue + if is_known_tool_name "$name"; then + vlog "[$((count + 1))/$total] Skipping compatibility tool: $name ($appid)" + continue + fi + # If cached, reuse; else analyze and cache + if [[ $FORCE_REFRESH -eq 0 && -n ${CACHE_MAP[$appid]+isset} ]]; then + # Normalize to include ProtonDB column if older cache lacked it + IFS=$'\t' read -r c_score c_a c_linux c_min c_rec c_name c_pdb <<< "${CACHE_MAP[$appid]}" + c_pdb=${c_pdb:-unknown} + vlog "[$((count + 1))/$total] Cache hit: $name ($appid) | ProtonDB=$c_pdb" + printf "%s\t%s\t%s\t%s\t%s\t%s\t%s\n" "$c_score" "$c_a" "$c_linux" "$c_min" "$c_rec" "$c_name" "$c_pdb" >> "$results_combined" + continue + fi + count=$((count + 1)) + log "Analyzing: $name ($appid) [$count/$total]" + local row url + url="https://store.steampowered.com/api/appdetails?appids=${appid}&l=en&cc=us" + vlog "[$count/$total] Fetching store appdetails: $url" + # Be gentle with the store API + sleep 0.1 + row=$(http_get "$url" | extract_requirements_and_platforms_stdin "$appid" || true) + if [[ -z $row ]]; then continue; fi + local status linux _windows _mac min_txt rec_txt type + IFS=$'\t' read -r status linux _windows _mac min_txt rec_txt type <<< "$row" + vlog "[$count/$total] Parsed store data: status=$status linux=$linux type=$type" + # Occasionally Steam returns success=false spuriously; retry once + if [[ $status != "ok" ]]; then + vlog "[$count/$total] Store status=fail; retrying once..." + sleep 0.3 + row=$(http_get "$url" | extract_requirements_and_platforms_stdin "$appid" || true) + IFS=$'\t' read -r status linux _windows _mac min_txt rec_txt type <<< "$row" + vlog "[$count/$total] After retry: status=$status" + fi + # Try filtered endpoint that often bypasses age/region gates + if [[ $status != "ok" ]]; then + local url2="https://store.steampowered.com/api/appdetails?appids=${appid}&filters=platforms,linux_requirements,pc_requirements,type&l=en&cc=us" + vlog "[$count/$total] Retrying with filters: $url2" + sleep 0.1 + row=$(http_get "$url2" | extract_requirements_and_platforms_stdin "$appid" || true) + IFS=$'\t' read -r status linux _windows _mac min_txt rec_txt type <<< "$row" + vlog "[$count/$total] Filtered fetch status=$status" + fi + if [[ $status != "ok" ]]; then continue; fi + if [[ $type != "game" && $type != "dlc" && $type != "" ]]; then continue; fi + # ProtonDB tier + [[ $ABORT -eq 1 ]] && break + local pdb_tier + vlog "[$count/$total] Fetching ProtonDB tier for appid=$appid" + pdb_tier=$(fetch_protondb_tier "$appid") + vlog "[$count/$total] ProtonDB tier=$pdb_tier" + + # Compute hardware-based score + local score_line s_score s_min_ram s_rec_ram + score_line=$(score_game "$linux" "$min_txt" "$rec_txt") + IFS=$'\t' read -r s_score s_min_ram s_rec_ram <<< "$score_line" + + # Gate by ProtonDB: if bronze or below -> mark unplayable and force low score + if ! protondb_allowed "$pdb_tier"; then + s_score=-999 + fi + + printf "%s\t%s\t%s\t%s\t%s\t%s\t%s\n" "$s_score" "$appid" "$linux" "$s_min_ram" "$s_rec_ram" "$name" "$pdb_tier" >> "$results_combined" + vlog "[$count/$total] Scored and recorded: score=$s_score min=${s_min_ram}G rec=${s_rec_ram}G" + done < "$games_tsv" + + if [[ ! -s $results_combined ]]; then + die "No compatible entries parsed from store API." + fi + + print_header + local rank=0 + sort -t $'\t' -k1,1nr -k6,6 "$results_combined" | while IFS=$'\t' read -r score appid linux min_ram rec_ram name pdb_tier; do + rank=$((rank + 1)) + local display_name="$name" + if ! protondb_allowed "$pdb_tier"; then + display_name="$name [UNPLAYABLE]" + fi + printf "%-5s %-8s %-6s %-6s %-8s %-9s %s\n" "$rank" "$score" "${min_ram}G" "${rec_ram}G" "$linux" "${pdb_tier:-unknown}" "$display_name" + done + + # Persist updated results for future runs (only current library entries) + cp -f "$results_combined" "$RESULTS_CACHE" 2> /dev/null || cat "$results_combined" > "$RESULTS_CACHE" +} diff --git a/linux_configuration/scripts/single_use/utils/lib/steam_requirements.sh b/linux_configuration/scripts/single_use/utils/lib/steam_requirements.sh new file mode 100755 index 00000000..94a3b987 --- /dev/null +++ b/linux_configuration/scripts/single_use/utils/lib/steam_requirements.sh @@ -0,0 +1,199 @@ +#!/usr/bin/env bash +# Hardware detection and the parsing and scoring of Steam requirement text. +# +# detect_system writes the SYSTEM_* globals that score_game reads, so writer +# and readers sit in the same file - a file that assigns a global it never +# reads trips SC2034, which the repo forbids suppressing. + +# Safe HTTP GET with optional timeout if available +http_get() { + local url="$1" + shift || true + local ua="Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124 Safari/537.36" + if [[ $HAS_TIMEOUT -eq 1 ]]; then + timeout 12s curl -sSL --compressed --retry 2 --retry-delay 0.5 --retry-connrefused \ + -H "User-Agent: $ua" -H 'Accept: application/json, text/plain, */*' "$url" "$@" 2> /dev/null + else + curl -sSL --compressed --retry 2 --retry-delay 0.5 --retry-connrefused \ + -H "User-Agent: $ua" -H 'Accept: application/json, text/plain, */*' "$url" "$@" 2> /dev/null + fi +} + +to_int() { awk '{gsub(/[^0-9]/,""); if($0=="") print 0; else print $0}' <<< "$1"; } + +detect_system() { + # CPU model + if command -v lscpu > /dev/null 2>&1; then + SYSTEM_CPU_MODEL=$(lscpu | awk -F': *' '/Model name/ {print $2; exit}') + fi + if [[ -z $SYSTEM_CPU_MODEL && -r /proc/cpuinfo ]]; then + SYSTEM_CPU_MODEL=$(awk -F': *' '/model name/ {print $2; exit}' /proc/cpuinfo) + fi + SYSTEM_CPU_MODEL=${SYSTEM_CPU_MODEL:-unknown} + + # CPU class (very rough) + lc_model=$(tr '[:upper:]' '[:lower:]' <<< "$SYSTEM_CPU_MODEL") + if grep -qiE 'i9-|core\(tm\) i9| ryzen 9' <<< "$lc_model"; then + SYSTEM_CPU_CLASS="tier4" + elif grep -qiE 'i7-|core\(tm\) i7| ryzen 7' <<< "$lc_model"; then + SYSTEM_CPU_CLASS="tier3" + elif grep -qiE 'i5-|core\(tm\) i5| ryzen 5' <<< "$lc_model"; then + SYSTEM_CPU_CLASS="tier2" + elif grep -qiE 'i3-|core\(tm\) i3| ryzen 3| pentium|celeron|atom' <<< "$lc_model"; then + SYSTEM_CPU_CLASS="tier1" + else SYSTEM_CPU_CLASS="tier2"; fi + + # GPU vendor + local vga + vga=$(lspci 2> /dev/null | grep -iE 'vga|3d|display' | head -n1 || true) + lc_vga=$(tr '[:upper:]' '[:lower:]' <<< "$vga") + if grep -q 'nvidia' <<< "$lc_vga"; then + SYSTEM_GPU_VENDOR="nvidia" + elif grep -q -E 'amd|ati|radeon' <<< "$lc_vga"; then + SYSTEM_GPU_VENDOR="amd" + elif grep -q 'intel' <<< "$lc_vga"; then + SYSTEM_GPU_VENDOR="intel" + else SYSTEM_GPU_VENDOR="unknown"; fi + + # RAM GB + local mem_kb + mem_kb=$(awk '/MemTotal/ {print $2; exit}' /proc/meminfo 2> /dev/null || echo 0) + if [[ $mem_kb -gt 0 ]]; then + SYSTEM_RAM_GB=$(((mem_kb + 1023 * 1024) / (1024 * 1024))) + else + local mem_mb + mem_mb=$(free -m | awk '/Mem:/ {print $2; exit}') + SYSTEM_RAM_GB=$(((mem_mb + 1023) / 1024)) + fi +} + +cpu_class_rank() { + case "$1" in + tier1) echo 1 ;; + tier2) echo 2 ;; + tier3) echo 3 ;; + tier4) echo 4 ;; + *) echo 2 ;; + esac +} + +required_cpu_rank_from_text() { + local t + t=$(tr '[:upper:]' '[:lower:]' <<< "$1") + if grep -qE 'i9|ryzen 9' <<< "$t"; then + echo 4 + return + fi + if grep -qE 'i7|ryzen 7' <<< "$t"; then + echo 3 + return + fi + if grep -qE 'i5|ryzen 5' <<< "$t"; then + echo 2 + return + fi + if grep -qE 'i3|ryzen 3|pentium|celeron|atom' <<< "$t"; then + echo 1 + return + fi + echo 2 +} + +gpu_vendor_required_from_text() { + local t + t=$(tr '[:upper:]' '[:lower:]' <<< "$1") + if grep -qE 'nvidia|geforce|gtx|rtx' <<< "$t"; then + echo nvidia + return + fi + if grep -qE 'amd|radeon|rx[ -]?[0-9]' <<< "$t"; then + echo amd + return + fi + if grep -qE 'intel( graphics| arc| iris| hd)' <<< "$t"; then + echo intel + return + fi + echo unknown +} + +strip_html() { + sed -E 's/<[^>]+>//g; s/ / /g; s/&/\&/g; s/\r//g' <<< "$1" +} + +parse_ram_gb() { + # Extract first RAM mention and convert to GB integer + local text="$1" + local num val + # Prefer GB + num=$(grep -oiE '([0-9]+)\s*(gb|gib)' <<< "$text" | head -n1 | grep -oiE '^[0-9]+' || true) + if [[ -n $num ]]; then + echo "$num" + return + fi + # Try MB + num=$(grep -oiE '([0-9]+)\s*(mb|mib)' <<< "$text" | head -n1 | grep -oiE '^[0-9]+' || true) + if [[ -n $num ]]; then + val=$(((num + 1023) / 1024)) + echo "$val" + return + fi + echo 0 +} + +score_game() { + local linux_support="$1" min_txt="$2" rec_txt="$3" + local score=0 + + # Linux platform support + if [[ $linux_support == "true" ]]; then + score=$((score + 50)) + else + score=$((score + 20)) # Assume Proton potential + fi + + local min_plain rec_plain + min_plain=$(strip_html "$min_txt") + rec_plain=$(strip_html "$rec_txt") + + local min_ram rec_ram + min_ram=$(parse_ram_gb "$min_plain") + rec_ram=$(parse_ram_gb "$rec_plain") + + # RAM checks + if [[ $min_ram -gt 0 ]]; then + if [[ $SYSTEM_RAM_GB -ge $min_ram ]]; then score=$((score + 15)); else score=$((score - 30)); fi + fi + if [[ $rec_ram -gt 0 ]]; then + if [[ $SYSTEM_RAM_GB -ge $rec_ram ]]; then score=$((score + 10)); else score=$((score - 10)); fi + fi + + # CPU checks (very rough tiers) + local req_rank sys_rank + req_rank=$(required_cpu_rank_from_text "$min_plain $rec_plain") + sys_rank=$(cpu_class_rank "$SYSTEM_CPU_CLASS") + if [[ $sys_rank -ge $req_rank ]]; then score=$((score + 10)); else score=$((score - 10)); fi + + # GPU vendor hints + local req_gpu vendor + req_gpu=$(gpu_vendor_required_from_text "$min_plain $rec_plain") + vendor="$SYSTEM_GPU_VENDOR" + if [[ $req_gpu == "unknown" ]]; then + score=$((score + 5)) + elif [[ $req_gpu == "$vendor" ]]; then + score=$((score + 10)) + else + score=$((score - 10)) + fi + + # 64-bit OS requirement + if grep -qi '64-?bit' <<< "$min_plain $rec_plain"; then + if [[ $SYSTEM_ARCH == "x86_64" || $SYSTEM_ARCH == "aarch64" ]]; then + score=$((score + 5)) + else + score=$((score - 20)) + fi + fi + + printf "%s\t%s\t%s\n" "$score" "$min_ram" "$rec_ram" +} diff --git a/linux_configuration/scripts/single_use/utils/steam_compatibility.sh b/linux_configuration/scripts/single_use/utils/steam_compatibility.sh index e8478157..2d8ea88f 100755 --- a/linux_configuration/scripts/single_use/utils/steam_compatibility.sh +++ b/linux_configuration/scripts/single_use/utils/steam_compatibility.sh @@ -17,6 +17,18 @@ set -euo pipefail +# shellcheck source=lib/steam_report.sh +. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/lib/steam_report.sh" + +# shellcheck source=lib/steam_credentials.sh +. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/lib/steam_credentials.sh" + +# shellcheck source=lib/steam_api.sh +. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/lib/steam_api.sh" + +# shellcheck source=lib/steam_requirements.sh +. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/lib/steam_requirements.sh" + SCRIPT_NAME=${0##*/} ABORT=0 on_abort() { @@ -28,17 +40,6 @@ trap on_abort INT TERM # --------------------------- CLI args --------------------------- -usage() { - cat << USAGE -Usage: $SCRIPT_NAME [--refresh] [--clear-cache] [--verbose] [--help] - -Options: - --refresh Re-analyze all games and overwrite cache (ignore previous results). - --clear-cache Delete cached results before running (implies --refresh). - -v, --verbose Print detailed progress and HTTP/parse steps. - -h, --help Show this help message and exit. -USAGE -} FORCE_REFRESH=0 CLEAR_CACHE=0 @@ -78,9 +79,6 @@ die() { } vlog() { if [[ $VERBOSE -eq 1 ]]; then printf "[%s][verbose] %s\n" "$SCRIPT_NAME" "$*" >&2; fi; } -require_cmd() { - command -v "$1" > /dev/null 2>&1 || die "Missing dependency: $1" -} for cmd in curl jq awk sed grep sort lspci free uname; do require_cmd "$cmd" @@ -91,19 +89,6 @@ if command -v timeout > /dev/null 2>&1; then HAS_TIMEOUT=1 fi -# Safe HTTP GET with optional timeout if available -http_get() { - local url="$1" - shift || true - local ua="Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124 Safari/537.36" - if [[ $HAS_TIMEOUT -eq 1 ]]; then - timeout 12s curl -sSL --compressed --retry 2 --retry-delay 0.5 --retry-connrefused \ - -H "User-Agent: $ua" -H 'Accept: application/json, text/plain, */*' "$url" "$@" 2> /dev/null - else - curl -sSL --compressed --retry 2 --retry-delay 0.5 --retry-connrefused \ - -H "User-Agent: $ua" -H 'Accept: application/json, text/plain, */*' "$url" "$@" 2> /dev/null - fi -} # --------------------------- System detection --------------------------- @@ -113,127 +98,12 @@ SYSTEM_GPU_VENDOR="unknown" SYSTEM_RAM_GB=0 SYSTEM_ARCH="$(uname -m || echo unknown)" -to_int() { awk '{gsub(/[^0-9]/,""); if($0=="") print 0; else print $0}' <<< "$1"; } -detect_system() { - # CPU model - if command -v lscpu > /dev/null 2>&1; then - SYSTEM_CPU_MODEL=$(lscpu | awk -F': *' '/Model name/ {print $2; exit}') - fi - if [[ -z $SYSTEM_CPU_MODEL && -r /proc/cpuinfo ]]; then - SYSTEM_CPU_MODEL=$(awk -F': *' '/model name/ {print $2; exit}' /proc/cpuinfo) - fi - SYSTEM_CPU_MODEL=${SYSTEM_CPU_MODEL:-unknown} - # CPU class (very rough) - lc_model=$(tr '[:upper:]' '[:lower:]' <<< "$SYSTEM_CPU_MODEL") - if grep -qiE 'i9-|core\(tm\) i9| ryzen 9' <<< "$lc_model"; then - SYSTEM_CPU_CLASS="tier4" - elif grep -qiE 'i7-|core\(tm\) i7| ryzen 7' <<< "$lc_model"; then - SYSTEM_CPU_CLASS="tier3" - elif grep -qiE 'i5-|core\(tm\) i5| ryzen 5' <<< "$lc_model"; then - SYSTEM_CPU_CLASS="tier2" - elif grep -qiE 'i3-|core\(tm\) i3| ryzen 3| pentium|celeron|atom' <<< "$lc_model"; then - SYSTEM_CPU_CLASS="tier1" - else SYSTEM_CPU_CLASS="tier2"; fi - # GPU vendor - local vga - vga=$(lspci 2> /dev/null | grep -iE 'vga|3d|display' | head -n1 || true) - lc_vga=$(tr '[:upper:]' '[:lower:]' <<< "$vga") - if grep -q 'nvidia' <<< "$lc_vga"; then - SYSTEM_GPU_VENDOR="nvidia" - elif grep -q -E 'amd|ati|radeon' <<< "$lc_vga"; then - SYSTEM_GPU_VENDOR="amd" - elif grep -q 'intel' <<< "$lc_vga"; then - SYSTEM_GPU_VENDOR="intel" - else SYSTEM_GPU_VENDOR="unknown"; fi - # RAM GB - local mem_kb - mem_kb=$(awk '/MemTotal/ {print $2; exit}' /proc/meminfo 2> /dev/null || echo 0) - if [[ $mem_kb -gt 0 ]]; then - SYSTEM_RAM_GB=$(((mem_kb + 1023 * 1024) / (1024 * 1024))) - else - local mem_mb - mem_mb=$(free -m | awk '/Mem:/ {print $2; exit}') - SYSTEM_RAM_GB=$(((mem_mb + 1023) / 1024)) - fi -} -cpu_class_rank() { - case "$1" in - tier1) echo 1 ;; - tier2) echo 2 ;; - tier3) echo 3 ;; - tier4) echo 4 ;; - *) echo 2 ;; - esac -} -required_cpu_rank_from_text() { - local t - t=$(tr '[:upper:]' '[:lower:]' <<< "$1") - if grep -qE 'i9|ryzen 9' <<< "$t"; then - echo 4 - return - fi - if grep -qE 'i7|ryzen 7' <<< "$t"; then - echo 3 - return - fi - if grep -qE 'i5|ryzen 5' <<< "$t"; then - echo 2 - return - fi - if grep -qE 'i3|ryzen 3|pentium|celeron|atom' <<< "$t"; then - echo 1 - return - fi - echo 2 -} - -gpu_vendor_required_from_text() { - local t - t=$(tr '[:upper:]' '[:lower:]' <<< "$1") - if grep -qE 'nvidia|geforce|gtx|rtx' <<< "$t"; then - echo nvidia - return - fi - if grep -qE 'amd|radeon|rx[ -]?[0-9]' <<< "$t"; then - echo amd - return - fi - if grep -qE 'intel( graphics| arc| iris| hd)' <<< "$t"; then - echo intel - return - fi - echo unknown -} - -strip_html() { - sed -E 's/<[^>]+>//g; s/ / /g; s/&/\&/g; s/\r//g' <<< "$1" -} - -parse_ram_gb() { - # Extract first RAM mention and convert to GB integer - local text="$1" - local num val - # Prefer GB - num=$(grep -oiE '([0-9]+)\s*(gb|gib)' <<< "$text" | head -n1 | grep -oiE '^[0-9]+' || true) - if [[ -n $num ]]; then - echo "$num" - return - fi - # Try MB - num=$(grep -oiE '([0-9]+)\s*(mb|mib)' <<< "$text" | head -n1 | grep -oiE '^[0-9]+' || true) - if [[ -n $num ]]; then - val=$(((num + 1023) / 1024)) - echo "$val" - return - fi - echo 0 -} # --------------------------- Steam data --------------------------- @@ -244,420 +114,27 @@ CONFIG_FILE="$CONFIG_DIR/credentials.conf" CACHE_DIR="${XDG_CACHE_HOME:-$HOME/.cache}/steam-compat-check" RESULTS_CACHE="$CACHE_DIR/results.tsv" -load_credentials() { - # Prefer environment, else config file - if [[ -n ${STEAM_API_KEY:-} && -n ${STEAM_ID64:-} ]]; then - return 0 - fi - if [[ -r $CONFIG_FILE ]]; then - # shellcheck disable=SC1090 - . "$CONFIG_FILE" || true - fi - if [[ -z ${STEAM_API_KEY:-} || -z ${STEAM_ID64:-} ]]; then - return 1 - fi - return 0 -} -save_credentials() { - local key="$1" id="$2" - mkdir -p "$CONFIG_DIR" - chmod 700 "$CONFIG_DIR" 2> /dev/null || true - umask 177 - cat > "$CONFIG_FILE" << EOF -# Saved by $SCRIPT_NAME -STEAM_API_KEY="$key" -STEAM_ID64="$id" -EOF -} -prompt_for_credentials() { - if [[ ! -t 0 ]]; then - die "STEAM_API_KEY/STEAM_ID64 not set and input is non-interactive. Export them or create $CONFIG_FILE." - fi - echo "Steam Web API credentials are required to scan your full library." - echo - echo "Where to get them:" - echo "- Steam Web API Key: https://steamcommunity.com/dev/apikey" - echo " Log in, set any domain (e.g., 127.0.0.1), then copy the key." - echo "- SteamID64 (17-digit ID starting with 765):" - echo " * Easiest: https://steamid.io/ (paste your profile URL to get the 64-bit ID)" - echo " * Or enable URL bar in Steam (Settings > Interface), open your profile; the URL contains the ID." - echo - local key id - read -r -p "Enter Steam Web API Key: " key - read -r -p "Enter Steam 64-bit ID (begins with 765…): " id - if [[ -z $key || -z $id ]]; then - die "Credentials not provided. Exiting." - fi - # Light validation for ID64 - if ! grep -qE '^765[0-9]{14}$' <<< "$id"; then - log "Warning: Steam ID64 format unexpected; continuing anyway." - fi - STEAM_API_KEY="$key" - STEAM_ID64="$id" - export STEAM_API_KEY STEAM_ID64 - save_credentials "$STEAM_API_KEY" "$STEAM_ID64" - log "Saved credentials to $CONFIG_FILE" -} STEAM_DIRS=("$HOME/.steam/steam" "$HOME/.local/share/Steam") -find_steamapps_dirs() { - local dirs=() - for base in "${STEAM_DIRS[@]}"; do - [[ -d $base ]] || continue - if [[ -f "$base/steamapps/libraryfolders.vdf" ]]; then - # Newer format includes nested objects with paths - local paths - paths=$(grep -oE '"path"\s+"[^"]+"' "$base/steamapps/libraryfolders.vdf" | sed -E 's/.*"([^"]+)"/\1/' || true) - if [[ -n $paths ]]; then - while IFS= read -r p; do - [[ -d "$p/steamapps" ]] && dirs+=("$p/steamapps") - done <<< "$paths" - fi - fi - [[ -d "$base/steamapps" ]] && dirs+=("$base/steamapps") - done - # de-dupe - printf "%s\n" "${dirs[@]}" 2> /dev/null | awk '!seen[$0]++' -} -list_installed_games() { - local d appid name - while IFS= read -r d; do - [[ -d $d ]] || continue - for mf in "$d"/appmanifest_*.acf; do - [[ -f $mf ]] || continue - appid=$(grep -oE '"appid"\s+"[0-9]+"' "$mf" | sed -E 's/.*"([0-9]+)"/\1/' | head -n1) - name=$(grep -oE '"name"\s+"[^"]+"' "$mf" | sed -E 's/.*"([^"]+)"/\1/' | head -n1) - if [[ -n $appid ]]; then - printf "%s\t%s\n" "$appid" "${name:-Unknown}" - fi - done - done < <(find_steamapps_dirs) -} -list_owned_games_via_api() { - local key="${STEAM_API_KEY:-}" sid="${STEAM_ID64:-}" - if [[ -z $key || -z $sid ]]; then - return 1 - fi - local url="https://api.steampowered.com/IPlayerService/GetOwnedGames/v0001/?key=${key}&steamid=${sid}&include_appinfo=1&include_played_free_games=1&format=json" - http_get "$url" | jq -r '.response.games[]? | "\(.appid)\t\(.name)"' || return 1 -} -fetch_appdetails_json() { - local appid="$1" - # Using store API (no key) - local url="https://store.steampowered.com/api/appdetails?appids=${appid}&l=en&cc=us" - http_get "$url" || true -} -extract_requirements_and_platforms() { - # Input: JSON from appdetails; Output: TSV of fields - # Fields: success, linux, windows, mac, min_text, rec_text, type - local appid="$1" json="$2" - # Some apps return {"APPID": {"success":true, "data":{...}}} - local out - out=$(jq -r --arg APP "$appid" ' - .[$APP] as $root | if ($root.success==true and ($root.data|type)=="object") then - ($root.data.platforms.linux // false) as $linux | - ($root.data.platforms.windows // false) as $windows | - ($root.data.platforms.mac // false) as $mac | - ($root.data.type // "") as $type | - # Prefer Linux reqs when present - ($root.data.linux_requirements.minimum // $root.data.pc_requirements.minimum // "") as $min | - ($root.data.linux_requirements.recommended // $root.data.pc_requirements.recommended // "") as $rec | - ["ok", ($linux|tostring), ($windows|tostring), ($mac|tostring), ($min|tostring), ($rec|tostring), ($type|tostring)] | @tsv - else - ["fail", "false", "false", "false", "", "", ""] | @tsv - end' 2> /dev/null <<< "$json") || true - if [[ -z $out ]]; then - out=$'fail false false false ' - fi - printf '%s\n' "$out" -} -# Read JSON from stdin (avoids storing large/binary data in variables) -extract_requirements_and_platforms_stdin() { - local appid="$1" - local out - out=$(jq -r --arg APP "$appid" ' - .[$APP] as $root | if ($root.success==true and ($root.data|type)=="object") then - ($root.data.platforms.linux // false) as $linux | - ($root.data.platforms.windows // false) as $windows | - ($root.data.platforms.mac // false) as $mac | - ($root.data.type // "") as $type | - ($root.data.linux_requirements.minimum // $root.data.pc_requirements.minimum // "") as $min | - ($root.data.linux_requirements.recommended // $root.data.pc_requirements.recommended // "") as $rec | - ["ok", ($linux|tostring), ($windows|tostring), ($mac|tostring), ($min|tostring), ($rec|tostring), ($type|tostring)] | @tsv - else - ["fail", "false", "false", "false", "", "", ""] | @tsv - end' 2> /dev/null) || true - if [[ -z $out ]]; then - out=$'fail\tfalse\tfalse\tfalse\t\t\t' - fi - printf '%s\n' "$out" -} -score_game() { - local linux_support="$1" min_txt="$2" rec_txt="$3" - local score=0 - # Linux platform support - if [[ $linux_support == "true" ]]; then - score=$((score + 50)) - else - score=$((score + 20)) # Assume Proton potential - fi - local min_plain rec_plain - min_plain=$(strip_html "$min_txt") - rec_plain=$(strip_html "$rec_txt") - local min_ram rec_ram - min_ram=$(parse_ram_gb "$min_plain") - rec_ram=$(parse_ram_gb "$rec_plain") - # RAM checks - if [[ $min_ram -gt 0 ]]; then - if [[ $SYSTEM_RAM_GB -ge $min_ram ]]; then score=$((score + 15)); else score=$((score - 30)); fi - fi - if [[ $rec_ram -gt 0 ]]; then - if [[ $SYSTEM_RAM_GB -ge $rec_ram ]]; then score=$((score + 10)); else score=$((score - 10)); fi - fi - - # CPU checks (very rough tiers) - local req_rank sys_rank - req_rank=$(required_cpu_rank_from_text "$min_plain $rec_plain") - sys_rank=$(cpu_class_rank "$SYSTEM_CPU_CLASS") - if [[ $sys_rank -ge $req_rank ]]; then score=$((score + 10)); else score=$((score - 10)); fi - - # GPU vendor hints - local req_gpu vendor - req_gpu=$(gpu_vendor_required_from_text "$min_plain $rec_plain") - vendor="$SYSTEM_GPU_VENDOR" - if [[ $req_gpu == "unknown" ]]; then - score=$((score + 5)) - elif [[ $req_gpu == "$vendor" ]]; then - score=$((score + 10)) - else - score=$((score - 10)) - fi - - # 64-bit OS requirement - if grep -qi '64-?bit' <<< "$min_plain $rec_plain"; then - if [[ $SYSTEM_ARCH == "x86_64" || $SYSTEM_ARCH == "aarch64" ]]; then - score=$((score + 5)) - else - score=$((score - 20)) - fi - fi - - printf "%s\t%s\t%s\n" "$score" "$min_ram" "$rec_ram" -} - -print_header() { - printf "%-5s %-8s %-6s %-6s %-8s %-9s %s\n" "Rank" "Score" "MinRAM" "RecRAM" "Linux" "ProtonDB" "Title" -} - -check_network_or_exit() { - # Quick probe to Steam Store API; exit early if not reachable - local probe_url="https://store.steampowered.com/api/appdetails?appids=10&l=en&cc=us" - if ! http_get "$probe_url" | jq -e '."10".success == true' > /dev/null 2>&1; then - log "Warning: store.steampowered.com probe failed (network or rate-limit). Continuing and handling per-app." - fi -} - -is_known_tool_name() { - local name_lc - name_lc=$(tr '[:upper:]' '[:lower:]' <<< "$1") - if grep -qE 'steam linux runtime|proton|compatibility tool' <<< "$name_lc"; then - return 0 - fi - return 1 -} - -ensure_cache_dir() { - mkdir -p "$CACHE_DIR" 2> /dev/null || true -} declare -A CACHE_MAP -load_cache_map() { - CACHE_MAP=() - if [[ -r $RESULTS_CACHE ]]; then - while IFS= read -r raw_line; do - # Normalize historical caches that contain literal "\t" instead of real tabs - local norm_line - norm_line=$(printf "%s" "$raw_line" | sed -E $'s/\\t/\t/g; s/\r$//') - IFS=$'\t' read -r c_score c_appid c_linux c_min c_rec c_name c_pdb <<< "$norm_line" - [[ -z ${c_appid:-} ]] && continue - c_pdb=${c_pdb:-unknown} - CACHE_MAP["$c_appid"]="$c_score\t$c_appid\t$c_linux\t$c_min\t$c_rec\t$c_name\t$c_pdb" - done < "$RESULTS_CACHE" - fi -} # --------------------------- ProtonDB integration --------------------------- -fetch_protondb_tier() { - local appid="$1" - local url="https://www.protondb.com/api/v1/reports/summaries/${appid}.json" - # Returns minimal JSON including .tier, .confidence; we only need .tier - local tier - tier=$(http_get "$url" | jq -r 'try .tier // "unknown"' 2> /dev/null || true) - if [[ -z $tier || $tier == "null" ]]; then - echo "unknown" - else - tr '[:upper:]' '[:lower:]' <<< "$tier" | tr -d '\r\n' - fi -} -protondb_allowed() { - local tier - tier=$(tr '[:upper:]' '[:lower:]' <<< "${1:-}") - case "$tier" in - platinum | native | gold | silver | unknown | "") return 0 ;; - bronze | pending | borked | unsupported | broken) return 1 ;; - *) return 0 ;; - esac -} -main() { - parse_args "$@" - detect_system - log "System: CPU=[$SYSTEM_CPU_MODEL] class=$SYSTEM_CPU_CLASS | GPU=$SYSTEM_GPU_VENDOR | RAM=${SYSTEM_RAM_GB}GB | Arch=$SYSTEM_ARCH" - - local tmpdir - tmpdir=$(mktemp -d) - trap '[[ -n "${tmpdir:-}" ]] && rm -rf "$tmpdir"' EXIT - - local games_tsv="$tmpdir/games.tsv" - : > "$games_tsv" - - # Ensure credentials exist: load from env/config or prompt, else exit - if ! load_credentials; then - prompt_for_credentials - fi - - # Fail fast if we cannot reach the store API to avoid noisy per-app errors - check_network_or_exit - - if list_owned_games_via_api > "$games_tsv" 2> /dev/null; then - log "Fetched owned games via Steam Web API" - fi - - if [[ ! -s $games_tsv ]]; then - die "No games found from Steam Web API. Check STEAM_API_KEY/STEAM_ID64 and network connectivity." - fi - - # Fail fast if we cannot reach the store API to avoid noisy per-app errors - check_network_or_exit - - ensure_cache_dir - if [[ $CLEAR_CACHE -eq 1 ]] && [[ -f $RESULTS_CACHE ]]; then - rm -f "$RESULTS_CACHE" || true - log "Cleared cache: $RESULTS_CACHE" - fi - if [[ $FORCE_REFRESH -eq 0 ]]; then - load_cache_map - else - CACHE_MAP=() - fi - - local results_combined="$tmpdir/results.tsv" - : > "$results_combined" - - local count=0 - local total - total=$(wc -l < "$games_tsv" | tr -d ' ') - [[ -z $total ]] && total=0 - while IFS=$'\t' read -r appid name; do - [[ $ABORT -eq 1 ]] && break - [[ -n $appid ]] || continue - if is_known_tool_name "$name"; then - vlog "[$((count + 1))/$total] Skipping compatibility tool: $name ($appid)" - continue - fi - # If cached, reuse; else analyze and cache - if [[ $FORCE_REFRESH -eq 0 && -n ${CACHE_MAP[$appid]+isset} ]]; then - # Normalize to include ProtonDB column if older cache lacked it - IFS=$'\t' read -r c_score c_a c_linux c_min c_rec c_name c_pdb <<< "${CACHE_MAP[$appid]}" - c_pdb=${c_pdb:-unknown} - vlog "[$((count + 1))/$total] Cache hit: $name ($appid) | ProtonDB=$c_pdb" - printf "%s\t%s\t%s\t%s\t%s\t%s\t%s\n" "$c_score" "$c_a" "$c_linux" "$c_min" "$c_rec" "$c_name" "$c_pdb" >> "$results_combined" - continue - fi - count=$((count + 1)) - log "Analyzing: $name ($appid) [$count/$total]" - local row url - url="https://store.steampowered.com/api/appdetails?appids=${appid}&l=en&cc=us" - vlog "[$count/$total] Fetching store appdetails: $url" - # Be gentle with the store API - sleep 0.1 - row=$(http_get "$url" | extract_requirements_and_platforms_stdin "$appid" || true) - if [[ -z $row ]]; then continue; fi - local status linux _windows _mac min_txt rec_txt type - IFS=$'\t' read -r status linux _windows _mac min_txt rec_txt type <<< "$row" - vlog "[$count/$total] Parsed store data: status=$status linux=$linux type=$type" - # Occasionally Steam returns success=false spuriously; retry once - if [[ $status != "ok" ]]; then - vlog "[$count/$total] Store status=fail; retrying once..." - sleep 0.3 - row=$(http_get "$url" | extract_requirements_and_platforms_stdin "$appid" || true) - IFS=$'\t' read -r status linux _windows _mac min_txt rec_txt type <<< "$row" - vlog "[$count/$total] After retry: status=$status" - fi - # Try filtered endpoint that often bypasses age/region gates - if [[ $status != "ok" ]]; then - local url2="https://store.steampowered.com/api/appdetails?appids=${appid}&filters=platforms,linux_requirements,pc_requirements,type&l=en&cc=us" - vlog "[$count/$total] Retrying with filters: $url2" - sleep 0.1 - row=$(http_get "$url2" | extract_requirements_and_platforms_stdin "$appid" || true) - IFS=$'\t' read -r status linux _windows _mac min_txt rec_txt type <<< "$row" - vlog "[$count/$total] Filtered fetch status=$status" - fi - if [[ $status != "ok" ]]; then continue; fi - if [[ $type != "game" && $type != "dlc" && $type != "" ]]; then continue; fi - # ProtonDB tier - [[ $ABORT -eq 1 ]] && break - local pdb_tier - vlog "[$count/$total] Fetching ProtonDB tier for appid=$appid" - pdb_tier=$(fetch_protondb_tier "$appid") - vlog "[$count/$total] ProtonDB tier=$pdb_tier" - - # Compute hardware-based score - local score_line s_score s_min_ram s_rec_ram - score_line=$(score_game "$linux" "$min_txt" "$rec_txt") - IFS=$'\t' read -r s_score s_min_ram s_rec_ram <<< "$score_line" - - # Gate by ProtonDB: if bronze or below -> mark unplayable and force low score - if ! protondb_allowed "$pdb_tier"; then - s_score=-999 - fi - - printf "%s\t%s\t%s\t%s\t%s\t%s\t%s\n" "$s_score" "$appid" "$linux" "$s_min_ram" "$s_rec_ram" "$name" "$pdb_tier" >> "$results_combined" - vlog "[$count/$total] Scored and recorded: score=$s_score min=${s_min_ram}G rec=${s_rec_ram}G" - done < "$games_tsv" - - if [[ ! -s $results_combined ]]; then - die "No compatible entries parsed from store API." - fi - - print_header - local rank=0 - sort -t $'\t' -k1,1nr -k6,6 "$results_combined" | while IFS=$'\t' read -r score appid linux min_ram rec_ram name pdb_tier; do - rank=$((rank + 1)) - local display_name="$name" - if ! protondb_allowed "$pdb_tier"; then - display_name="$name [UNPLAYABLE]" - fi - printf "%-5s %-8s %-6s %-6s %-8s %-9s %s\n" "$rank" "$score" "${min_ram}G" "${rec_ram}G" "$linux" "${pdb_tier:-unknown}" "$display_name" - done - - # Persist updated results for future runs (only current library entries) - cp -f "$results_combined" "$RESULTS_CACHE" 2> /dev/null || cat "$results_combined" > "$RESULTS_CACHE" -} main "$@"