{"id":23860503,"url":"https://github.com/pebeto/proton-ge-manager","last_synced_at":"2026-06-21T17:31:11.881Z","repository":{"id":270306257,"uuid":"909928009","full_name":"pebeto/proton-ge-manager","owner":"pebeto","description":"A painless proton-ge installation for Steam Deck/Linux.","archived":false,"fork":false,"pushed_at":"2026-06-15T23:08:57.000Z","size":89,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-15T23:11:18.832Z","etag":null,"topics":["proton","protonge","steam","steamdeck"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pebeto.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-30T04:44:20.000Z","updated_at":"2026-06-15T23:09:00.000Z","dependencies_parsed_at":"2024-12-31T14:01:25.570Z","dependency_job_id":null,"html_url":"https://github.com/pebeto/proton-ge-manager","commit_stats":null,"previous_names":["pebeto/proton-ge-manager"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pebeto/proton-ge-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pebeto%2Fproton-ge-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pebeto%2Fproton-ge-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pebeto%2Fproton-ge-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pebeto%2Fproton-ge-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pebeto","download_url":"https://codeload.github.com/pebeto/proton-ge-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pebeto%2Fproton-ge-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34620358,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["proton","protonge","steam","steamdeck"],"created_at":"2025-01-03T04:59:35.427Z","updated_at":"2026-06-21T17:31:11.875Z","avatar_url":"https://github.com/pebeto.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# proton-ge-manager\nA small script to download, install, and remove Proton-GE releases on your system.\n\n\u003e [!NOTE]\n\u003e This utility is only compatible with Proton-GE releases from GloriousEggroll's GitHub\n\u003e repository, and with the standard directory structure used by Steam across different\n\u003e platforms (Steam Deck, Native installation, Flatpak, and Snap).\n\n![Proton-GE Manager in action](./proton-ge-manager.gif)\n\n## Features\n\n- Progress bars for downloads and extractions\n- Color-coded output (on terminals that support it; honors `NO_COLOR`)\n- Automatic download resume for interrupted transfers\n- SHA-512 checksum verification before extraction\n- Backup creation before purge operations\n- Clear error messages with suggested fixes\n- Shell completion for bash and zsh\n\n## Quick start\n\u003e [!NOTE]\n\u003e These commands fetch the script from a small API that always serves the latest\n\u003e version. You can read the endpoint source [here](https://github.com/pebeto/pebeto.github.io/blob/master/app/api/pgm/%5Btype%5D/route.tsx).\n\n### Install the latest Proton-GE\n\nRun the line for your platform:\n\n- Steam Deck\n    ```bash\n    sh -c \"$(curl -fsSL https://pebeto.github.io/api/pgm/steamdeck) -l\"\n    ```\n\n- Steam (Native)\n    ```bash\n    sh -c \"$(curl -fsSL https://pebeto.github.io/api/pgm/native) -l\"\n    ```\n\n- Steam (Flatpak)\n    ```bash\n    sh -c \"$(curl -fsSL https://pebeto.github.io/api/pgm/flatpak) -l\"\n    ```\n\n- Steam (Snap)\n    ```bash\n    sh -c \"$(curl -fsSL https://pebeto.github.io/api/pgm/snap) -l\"\n    ```\n\nOnce it finishes, restart Steam, right-click a game, open **Properties → Compatibility**, and pick the new Proton-GE version from the dropdown. On Steam Deck, switch back to Gaming Mode to apply the change.\n\n### Install the manager (for repeat use)\n\nThe command above downloads the script, runs it once, and discards it. To manage versions over time, save it to your `PATH` instead. Replace `native` with your platform (`steamdeck`, `native`, `flatpak`, or `snap`):\n\n```bash\ncurl -fsSL --create-dirs https://pebeto.github.io/api/pgm/native -o ~/.local/bin/proton-ge-manager\nchmod +x ~/.local/bin/proton-ge-manager\n~/.local/bin/proton-ge-manager -l\n```\n\n`--create-dirs` lets `curl` create `~/.local/bin` when it's missing; Steam Deck has no such directory by default. If `~/.local/bin` is not on your `PATH`, add it or choose another directory that is; once it's there, you can run `proton-ge-manager` without the full path.\n\n## Commands\n\n- `-i, --install \u003cversion\u003e`: Install a specific Proton-GE version (e.g., `./proton-ge-manager.sh -i 9-10`). Skips download if already installed; use `-f` to force reinstall.\n- `-l, --latest`: Install the latest Proton-GE version automatically.\n- `-L, --list`: List installed Proton-GE versions.\n- `-s, --status`: Show detailed status including version, location, size, and file count.\n- `-r, --remove \u003cversion\u003e`: Remove a specific Proton-GE version.\n- `-p, --purge`: Remove ALL installed Proton-GE versions. Offers backup option before deletion.\n- `-I, --interactive`: Launch interactive setup wizard for guided installation.\n- `-f, --force`: Force reinstallation even if version is present.\n- `-y, --yes`: Skip all confirmation prompts.\n- `-h, --help`: Display this help message.\n\nRun `./proton-ge-manager.sh -h` to print this list at any time.\n\n## Examples\n\nCreate a backup before purging everything:\n```bash\n./proton-ge-manager.sh -p\n# answer \"y\" to purge, then \"y\" to create the backup\n```\n\nReinstall a version you already have:\n```bash\n./proton-ge-manager.sh -i 9-19 -f\n```\n\nInstall the latest version without any prompts:\n```bash\n./proton-ge-manager.sh -l -y\n```\n\n## Configuration\n\nSet these environment variables before running the script:\n\n- `COMPATIBILITYTOOLS_DIR`: Override the default Steam compatibility tools directory\n- `NO_COLOR`: Set to any value to disable color output\n\nExample:\n```bash\nCOMPATIBILITYTOOLS_DIR=/custom/path ./proton-ge-manager.sh -l\n```\n\n## Shell completion\n\nThe completion scripts ship in this repository, so clone it first:\n```bash\ngit clone https://github.com/pebeto/proton-ge-manager.git\n```\n\nThen source the script for your shell.\n\n### Bash\n\nAdd to your `~/.bashrc`:\n```bash\nsource /path/to/proton-ge-manager/scripts/proton-ge-manager-completion.bash\n```\n\n### Zsh\n\nAdd to your `~/.zshrc`:\n```zsh\nsource /path/to/proton-ge-manager/scripts/proton-ge-manager-completion.zsh\n```\n\nReload with `source ~/.bashrc` or `source ~/.zshrc` to enable completion.\n\n## Troubleshooting\n\n**Steam path not found**:\n```\nSteam compatibility tools directory not found at: /path/to/dir\n```\n- Ensure Steam is installed\n- Launch Steam at least once\n- Check your Steam installation path\n\n**Download failed**:\n```\nError: failed to download Proton-GE X-Y\n```\n- Check your internet connection\n- Try again later (GitHub may be rate limiting)\n- Downloads resume automatically if interrupted\n\n**Checksum mismatch**:\n```\nError: checksum mismatch\n```\n- The download may be corrupted\n- Try downloading again\n- Ensure you have enough disk space\n\n**Invalid version format**:\n```\nError: invalid version format: invalid\n```\n- Use format like `9-19` or `10-0`\n- Check available versions on [GloriousEggroll's GitHub](https://github.com/GloriousEggroll/proton-ge-custom/releases)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpebeto%2Fproton-ge-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpebeto%2Fproton-ge-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpebeto%2Fproton-ge-manager/lists"}