{"id":46442314,"url":"https://github.com/alterware/alterware-launcher","last_synced_at":"2026-03-05T22:05:06.535Z","repository":{"id":298453524,"uuid":"1000011675","full_name":"alterware/alterware-launcher","owner":"alterware","description":"AlterWare.dev updater \u0026 launcher | Call of Duty mods","archived":false,"fork":false,"pushed_at":"2026-02-02T09:44:25.000Z","size":1440,"stargazers_count":38,"open_issues_count":3,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-02T22:42:21.703Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alterware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2025-06-11T06:17:11.000Z","updated_at":"2026-02-02T09:44:26.000Z","dependencies_parsed_at":"2025-06-11T07:39:08.790Z","dependency_job_id":"9f603ae9-a869-4e5f-af64-b5535cab0fff","html_url":"https://github.com/alterware/alterware-launcher","commit_stats":null,"previous_names":["alterware/alterware-launcher"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/alterware/alterware-launcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alterware%2Falterware-launcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alterware%2Falterware-launcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alterware%2Falterware-launcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alterware%2Falterware-launcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alterware","download_url":"https://codeload.github.com/alterware/alterware-launcher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alterware%2Falterware-launcher/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30152011,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T21:15:50.531Z","status":"ssl_error","status_checked_at":"2026-03-05T21:15:11.173Z","response_time":93,"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-03-05T22:05:05.870Z","updated_at":"2026-03-05T22:05:06.513Z","avatar_url":"https://github.com/alterware.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# AlterWare Launcher\n\n#### Official launcher for AlterWare Call of Duty mods\n\n##### IW4-SP | IW5-Mod | IW6-Mod | S1-Mod\n\n![GitHub tag (with filter)](https://img.shields.io/github/v/tag/alterware/alterware-launcher?filter=!v*-pre\u0026style=flat-square\u0026label=Latest%20release\u0026labelColor=F3F8FF\u0026color=E26EE5) ![GitHub (Pre-)Release Date](https://img.shields.io/github/release-date-pre/alterware/alterware-launcher?style=flat-square\u0026label=Release%20date\u0026labelColor=F3F8FF\u0026color=E26EE5) ![GitHub all releases](https://img.shields.io/github/downloads/alterware/alterware-launcher/total?style=flat-square\u0026label=Total%20downloads\u0026labelColor=F3F8FF\u0026color=E26EE5)\n\u003c/div\u003e\n\n\u003e [!IMPORTANT]\n\u003e **Only legitimate copies of the games are supported. If you don't own the game, please buy it.**\n\n## 🗺️ Table of Contents\n\n\u003ca href=\"https://alterware.dev\"\u003e\u003cimg src=\".github/images/logo.png\" align=\"right\" width=\"128\" height=\"128\"\u003e\u003c/a\u003e\n\n- [Installation](#-installation)\n- [Supported Games](#-supported-games)\n- [Command line arguments](#%EF%B8%8F-command-line-arguments)\n- [Config file](#-config-file-alterware-launcherjson)\n- [Building from Source](#-building-from-source)\n- [Support](#-support)\n\n---\n\n## 📦 Installation\n[**Windows**](#-windows) | [**Debian/Ubuntu**](#-debianubuntu-amd64arm64) | [**Other Linux OS**](#-other-linux-os) | [**macOS**](#-macos)\n\n---\n\n### 🪟 Windows\n1. Download the game from [Steam](https://store.steampowered.com/).\n2. Download the appropriate version of the AlterWare launcher:\n   - **Windows 64-bit**: Download the [latest alterware-launcher.exe](https://github.com/alterware/alterware-launcher/releases/latest/download/alterware-launcher.exe).\n   - **Windows 32-bit**: Download the [latest alterware-launcher-x86.exe](https://github.com/alterware/alterware-launcher/releases/latest/download/alterware-launcher-x86.exe).\n3. Place the `alterware-launcher.exe` in the game directory.\n4. Run `alterware-launcher.exe`. After updating, the game will launch automatically.\n\n\u003e [!NOTE]\n\u003e Windows 7 is no longer supported.\n\n\u003e [!IMPORTANT]\n\u003e ### Information for server owners:\n\u003e On Windows, the launcher self-updates and restarts by spawning a new console.\n\u003e For automated processes, use `--skip-launcher-update` and manually download the latest launcher from [here](https://github.com/alterware/alterware-launcher/releases/latest/download/alterware-launcher.exe).\n\n---\n\n### 🐧 Debian/Ubuntu (amd64/arm64)\n\n1. Download the game from Steam using either [SteamCMD](https://developer.valvesoftware.com/wiki/SteamCMD) or the official Steam desktop app.\n2. Follow the instructions provided in [this forum post](https://forum.alterware.dev/t/linux-debian-ubuntu-amd64-arm64-install-the-alterware-launcher-using-our-apt-repository/1117) to install the alterware-launcher using our self-hosted APT repository.\n3. Once installed, run the launcher from your game directory to download the client files automatically.\n\n\u003e [!TIP]\n\u003e Use the `--update` command-line argument if you want to launch the game through Proton or other Wine versions instead of the default wine found in your path.\n\n\u003e [!NOTE]\n\u003e The steps above can be used for any Debian-based distribution that uses the APT package manager.\n\n\u003e [!NOTE]\n\u003e For more information on how to run the launcher on Linux, see [this guide](https://forum.alterware.dev/t/all-clients-useful-info-for-running-our-mods-under-linux/343).\n\n---\n\n### 🐧 Other Linux OS\n\n1. Download the game from Steam using either [SteamCMD](https://developer.valvesoftware.com/wiki/SteamCMD) or the official Steam desktop app.\n2. Download the [latest release](https://github.com/alterware/alterware-launcher/releases/latest) corresponding to your system architecture.\n    - Most likely you want [alterware-launcher-x86_64-unknown-linux-gnu.tar.gz](https://github.com/alterware/alterware-launcher/releases/latest/download/alterware-launcher-x86_64-unknown-linux-gnu.tar.gz)\n3. Unpack the archive and copy the `alterware-launcher` executable to your game directory.\n    - Alternatively, you can place it in your `PATH` so you can run it from anywhere. For example, in `/usr/local/bin/`\n4. Make the launcher executable: `chmod +x alterware-launcher`\n5. Run the launcher from your game directory to download the client files: `./alterware-launcher`\n\n\u003e [!TIP]\n\u003e Use the `--update` command-line argument if you want to launch the game through Proton or other Wine versions instead of the default wine found in your path.\n\n\u003e [!NOTE]\n\u003e For more information on how to run the launcher on Linux, see [this guide](https://forum.alterware.dev/t/all-clients-useful-info-for-running-our-mods-under-linux/343).\n\n---\n\n### 🍎 macOS\n\n1. Download the game from Steam using either [SteamCMD](https://developer.valvesoftware.com/wiki/SteamCMD) or the official Steam desktop app.\n2. Download the [latest alterware-launcher](https://github.com/alterware/alterware-launcher/releases/latest/download/alterware-launcher-universal-apple-darwin.tar.gz).\n3. Once installed, run the launcher from your game directory to download the client files automatically. For updates, use the launcher from the terminal with the `--update` command-line argument as explained in [this guide](https://forum.alterware.dev/t/all-clients-useful-info-for-running-our-mods-under-linux/343).\n\n\u003e [!CAUTION]\n\u003e Running the AlterWare launcher on macOS has not been officially tested. However, since WINE has a macOS port, it should theoretically be possible to run our clients on this platform.\n\n---\n\n## 🎮 Supported Games\n\n\u003e [!IMPORTANT]\n\u003e **Only legitimate copies of the games are supported. If you don't own the game, please buy it.**\n\n\u003e **IW4-SP**  \n\u003e Call of Duty: Modern Warfare 2 - Singeplayer\n\n\u003e **IW5-Mod**  \n\u003e Call of Duty: Modern Warfare 3 - Singleplayer, SpecOps\n\n\u003e **IW6-Mod**  \n\u003e Call of Duty: Ghosts\n\n\u003e **S1-Mod**  \n\u003e Call of Duty: Advanced Warfare\n\n---\n\n## ⚙️ Command line arguments\n\n- ```iw4-sp```, ```iw5-mod```, ```iw6-mod```, ```s1-mod```\n  - Skip automatic detection and launch the specified game\n    - Must be the first argument if used\n- ```--help```\n  - Print help\n- ```--update```, ```-u```\n  - Update the game without launching it\n- ```--skip-launcher-update```\n  - Skip updating the launcher\n- ```--bonus```\n  - Download bonus content (default)\n- ```--skip-bonus```\n  - Don't download bonus content\n- ```--force```, ```-f```\n  - Force file hash recheck\n- ```--path```, ```-p```\n  - Set the game installation path\n    - Do not include a trailing backslash in the path\n- ```--pass```\n  - Pass additional arguments to the game\n    - See [client-args.md](client-args.md) for more details\n- ```--version```, ```-v```\n  - Print the launcher version\n- ```--ignore-required-files```\n  - Install client even if required files are missing\n- ```--skip-redist```\n  - Skip installing redistributables\n- ```--redist```\n  - Install or reinstall redistributables\n- ```--prerelease```\n  - Update to prerelease version of the launcher\n- ```--cdn-url```\n- ```--offline```\n\n\n##### Example:\n```shell\nalterware-launcher.exe iw6 --bonus -u --path \"C:\\Games\\IW6x\" --pass \"-headless\"\n```\n\u003e [!TIP]\n\u003e Some arguments can be set in alterware-launcher.json, args generally override the values of the config.\n\n---\n\n## 🔧 Config file `alterware-launcher.json`\n\n- `update_only`: Set to true to only update the game. Default: `false`.\n- `skip_self_update`: Skip launcher updates. Default: `false`.\n- `download_bonus_content`: Automatically download bonus content. Default: `false`.\n- `ask_download_bonus_content`: Ask before downloading bonus content. Default: `false`.\n- `force_update`: Force file recheck. Default: `false`.\n- `args`: Pass additional arguments to the game. Default: `\"\"`.\n- `use_https`: Use HTTPS for downloads. Default: `true`.\n- `skip_redist`: Skip redistributable installations. Default: `false`.\n- `prerelease`: Update to prerelease version of clients and launcher. Default: `false`.\n- `cdn_url`\n- `offline`\n\n---\n\n## 🔨 Building from Source\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n---\n\n## ❓ Support\n\nNeed help or have questions? We're here to help you!\n\n- **AlterWare Forum**: Visit our [official forum](https://forum.alterware.dev/) for in-depth discussions, troubleshooting, and community support.\n- **Discord Community**: Join our [Discord server](https://discord.gg/2ETE8engZM) for real-time chat, quick questions, and to connect with other users.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://alterware.dev\"\u003e\u003cimg src=\".github/images/logotype.png\" width=\"512\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falterware%2Falterware-launcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falterware%2Falterware-launcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falterware%2Falterware-launcher/lists"}