{"id":43200283,"url":"https://github.com/exaroth/game-appimage","last_synced_at":"2026-02-01T06:03:42.395Z","repository":{"id":317772955,"uuid":"1067440357","full_name":"exaroth/game-appimage","owner":"exaroth","description":"Utility for building self contained Windows game AppImages running on Wine","archived":false,"fork":false,"pushed_at":"2025-10-03T00:18:05.000Z","size":6612,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-03T00:27:01.757Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/exaroth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-09-30T21:25:06.000Z","updated_at":"2025-10-03T00:24:43.000Z","dependencies_parsed_at":"2025-10-03T00:37:27.828Z","dependency_job_id":null,"html_url":"https://github.com/exaroth/game-appimage","commit_stats":null,"previous_names":["exaroth/game-appimage"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/exaroth/game-appimage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exaroth%2Fgame-appimage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exaroth%2Fgame-appimage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exaroth%2Fgame-appimage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exaroth%2Fgame-appimage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/exaroth","download_url":"https://codeload.github.com/exaroth/game-appimage/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exaroth%2Fgame-appimage/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28970194,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T05:48:53.985Z","status":"ssl_error","status_checked_at":"2026-02-01T05:47:55.855Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-02-01T06:03:42.302Z","updated_at":"2026-02-01T06:03:42.384Z","avatar_url":"https://github.com/exaroth.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"## :video_game: :package: :gear: Game AppImage Builder\n\nGame AppImage Builder is a simple tool that makes it easy to create portable and self contained windows game appimages running on Wine.\n\n- Small size overhead thanks to use of compact wine appimage by [mmtrt](https://github.com/mmtrt/WINE_AppImage) (~200MB)\n- Ability to define custom path mappings for the game\n- Support for both idempotent and writeable winprefixes\n\n### Usage\n\n1. Run `setup.py` \n\n2. Initialize wineprefix \n```\n./run_wine.sh wineboot\n```\n3. If game has an installer run it via:\n```\n./run_wine.sh /path/to/installer.exe\n```\n4. If game needs dxvk/vulkan drivers, .NET Runtime etc. install dependencies via winetricks by executing:\n```\n./run_wine.sh winetricks\n```\n\n5. Move contents of game folder to `game` directory\n\n6. Update `AppDir/wrapper` file, set `EXECUTABLE` to the name of game executable as well as `PROGRAM_NAME` to unique game identifier\n\n7. Run `build.sh` to build AppImage, look for generated file in `build` dir\n\n\u003e [!NOTE]\n\u003e There are multiple build modes available:\n\u003e - __Default__ - This will use provided wineprefix in read only mode, you might need to create custom path mappings (see below) for locations in the filesystem that game writes to.\n\u003e - __Writeable wineprefix mode__ - This mode is similar to above but will mount a writeable, persistent copy of the supplied wineprefix in the host filesystem. To enable it add `--rw-mode` when executing `build.sh` script.\n\u003e - __Provisioned wineprefix mode__ - When using this mode wineprefix will not be attached to the AppImage, instead it will be generated automatically during first game boot. You can configure the provisioning process by editing `./AppDir/provision_wineprefix.sh` script, eg. to install dxvk and Visual C++ Redist in the wineprefix append \n\u003e ```\n\u003e $WINE winetricks dxvk2071 \n\u003e $WINE winetricks vcrun2019\n\u003e ```\n\u003e In order to use this mode add `--provision-mode` when running build script. Using provisioned mode reduces size of the game AppImage size by at least 100MB.\n \nPersistent wineprefix directories are stored in `$HOME/.wine_prefixes`\n### Custom path mappings\n\nThis feature is useful if you want for some game files to be stored outside of the appimage, for example save directory, configuration etc.\nIn order to create a mapping add a line to `AppDir/override_list` in a form of `\u003csource\u003e:\u003cdestination\u003e` where source is path relative to `AppDir` directory (eg. `game/log.log`) and destination is absolute path within host filesystem.\n\nFor example given that a game uses `Saves` directory for saving and `config.txt` for configuration you can create a mapping for these by adding following to `override_list` file:\n\n```\ngame/Saves:$HOME/Documents/my_game/Saves\ngame/config.txt:$HOME/Documents/my_game/config.txt\n```\n\nThis works for both files and directories, note however that these have to exist when you build the appimage.\n\n### Troubleshooting\n\nIf AppImage fails to run the program try following steps:\n\n- Ensure that game works outside the AppImage, run\n```\n./run_wine.sh start /d \"$PWD/game\" \"\u003cgame_executable\u003e.exe\"\n```\nIf the program fails to start, ensure that all required libraries (eg. `dxvk`, `C++ Redistritable`) are installed\n\n- If you're building AppImage using default build type try running it with either `--rw-mode` or `--provision-mode`\n \n- Check game directory for obvious folders which might require write access (eg. save or configuration dirs). Use custom path mappings to expose those within local filesystem (see [Custom Path Mappings](#custom-path-mappings) section) as AppImages are read only\n \n- If the game still fails to run properly execute:\n\n```\nlsof -a +D $PWD/game -r 1  | awk 'NR==1 || $4~/[0-9]+[uw]/'\n```\nthen in another terminal run game using command from step 1 to find out if there are any other files which require write access.\n\n\n### License\nSee `LICENSE` file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexaroth%2Fgame-appimage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexaroth%2Fgame-appimage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexaroth%2Fgame-appimage/lists"}