{"id":13469585,"url":"https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher","last_synced_at":"2025-03-26T07:30:55.860Z","repository":{"id":37001414,"uuid":"325550081","full_name":"Heroic-Games-Launcher/HeroicGamesLauncher","owner":"Heroic-Games-Launcher","description":"A games launcher for GOG, Amazon and Epic Games for Linux, Windows and macOS.","archived":false,"fork":false,"pushed_at":"2024-10-26T02:49:10.000Z","size":718892,"stargazers_count":8155,"open_issues_count":465,"forks_count":427,"subscribers_count":51,"default_branch":"main","last_synced_at":"2024-10-29T15:10:16.692Z","etag":null,"topics":["amazon-prime","electron","epic-games-launcher","epic-games-store","epic-store","gaming","gog","gog-galaxy","heroic-games-launcher","linux","play-games","proton","steam","wine"],"latest_commit_sha":null,"homepage":"https://heroicgameslauncher.com","language":"TypeScript","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/Heroic-Games-Launcher.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"COPYING","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"Support.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"Heroic-Games-Launcher","patreon":"heroicgameslauncher","open_collective":null,"ko_fi":"heroicgames","ethereum":886961724126564373474827707398257016179336856220,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2020-12-30T12:51:57.000Z","updated_at":"2024-10-29T10:04:14.000Z","dependencies_parsed_at":"2023-01-17T12:45:55.889Z","dependency_job_id":"8cfe0164-5835-4021-9305-97d057f13590","html_url":"https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher","commit_stats":null,"previous_names":[],"tags_count":103,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Heroic-Games-Launcher%2FHeroicGamesLauncher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Heroic-Games-Launcher%2FHeroicGamesLauncher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Heroic-Games-Launcher%2FHeroicGamesLauncher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Heroic-Games-Launcher%2FHeroicGamesLauncher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Heroic-Games-Launcher","download_url":"https://codeload.github.com/Heroic-Games-Launcher/HeroicGamesLauncher/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222121829,"owners_count":16934973,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["amazon-prime","electron","epic-games-launcher","epic-games-store","epic-store","gaming","gog","gog-galaxy","heroic-games-launcher","linux","play-games","proton","steam","wine"],"created_at":"2024-07-31T15:01:45.982Z","updated_at":"2025-03-26T07:30:55.854Z","avatar_url":"https://github.com/Heroic-Games-Launcher.png","language":"TypeScript","funding_links":["https://github.com/sponsors/Heroic-Games-Launcher","https://patreon.com/heroicgameslauncher","https://ko-fi.com/heroicgames",886961724126564373474827707398257016179336856220,"https://www.paypal.me/heroiclauncher"],"categories":["Games","TypeScript","UI Apps/Tools","二、精选 Electron 应用","Apps","electron","Uncategorized","linux","Table of Contents"],"sub_categories":["Other","Gaming","5. 娱乐与社交","Open Source","Uncategorized","Game Launcher"],"readme":"# Heroic Games Launcher\n\n[![GitHub release](https://img.shields.io/github/v/release/Heroic-Games-Launcher/HeroicGamesLauncher?style=for-the-badge)](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest)\n[![GitHub all releases](https://img.shields.io/github/downloads/Heroic-Games-Launcher/HeroicGamesLauncher/total?style=for-the-badge\u0026color=00B000)](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/)\n[![Flathub](https://img.shields.io/flathub/downloads/com.heroicgameslauncher.hgl?label=flathub\u0026logo=flathub\u0026logoColor=white\u0026style=for-the-badge\u0026color=00B000)](https://flathub.org/apps/details/com.heroicgameslauncher.hgl)\n[![GPLv3 license](https://img.shields.io/github/license/Heroic-Games-Launcher/HeroicGamesLauncher?style=for-the-badge\u0026color=blue)](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/blob/main/COPYING)  \n[![Discord](https://img.shields.io/discord/812703221789097985?label=Discord%20Server\u0026logo=discord\u0026color=5865F2\u0026style=for-the-badge)](https://discord.gg/rHJ2uqdquK)\n[![Patreon](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Dheroicgameslauncher%26type%3Dpatrons\u0026style=for-the-badge)](https://patreon.com/heroicgameslauncher)\n[![PayPal](https://img.shields.io/badge/PayPal-Donate-blue?style=for-the-badge\u0026logo=paypal)](https://www.paypal.me/heroiclauncher)\n[![kofi](https://img.shields.io/badge/Ko--Fi-Donate-orange?style=for-the-badge\u0026logo=ko-fi)](https://ko-fi.com/heroicgames)\n\nHeroic is an Open Source Game Launcher for Linux, Windows and macOS.  \nRight now it supports launching games from the Epic Games Store using [Legendary](https://github.com/derrod/legendary), GOG Games using our custom implementation with [gogdl](https://github.com/Heroic-Games-Launcher/heroic-gogdl) and Amazon Games using [Nile](https://github.com/imLinguin/nile).\n\nHeroic is built with Web Technologies:  \n[![Typescript](https://img.shields.io/badge/Typescript-3178c6?style=for-the-badge\u0026logo=typescript\u0026labelColor=gray)](https://www.typescriptlang.org/)\n[![React](https://img.shields.io/badge/React-5fd9fb?style=for-the-badge\u0026logo=react\u0026labelColor=gray)](https://reactjs.org/)\n[![MUI](https://img.shields.io/badge/MUI-66b2ff?style=for-the-badge\u0026logo=mui\u0026labelColor=gray\u0026logoColor=66b2ff)](https://mui.com/)\n[![NodeJS](https://img.shields.io/badge/NodeJS-689f63?style=for-the-badge\u0026logo=nodedotjs\u0026labelColor=gray)](https://nodejs.org/)\n[![Electron](https://img.shields.io/badge/Electron-4078c0?style=for-the-badge\u0026logo=electron\u0026labelColor=gray)](https://www.electronjs.org/)\n[![electron-builder](https://img.shields.io/badge/electron--builder-4078c0?style=for-the-badge\u0026logo=electronbuilder\u0026labelColor=gray\u0026logoColor=4078c0)](https://www.electron.build/)\n[![Jest](https://img.shields.io/badge/Jest-18DF16?style=for-the-badge\u0026logo=jest\u0026labelColor=gray\u0026logoColor=18DF16)](https://jestjs.io/)\n[![Vite](https://img.shields.io/badge/Vite-BD34FE?style=for-the-badge\u0026logo=vite\u0026labelColor=gray)](https://vitejs.dev/)\n\n## Index\n\n- [Heroic Games Launcher](#heroic-games-launcher)\n  - [Index](#index)\n  - [Features available right now](#features-available-right-now)\n  - [Planned features](#planned-features)\n  - [Supported Operating Systems](#supported-operating-systems)\n  - [Language Support](#language-support)\n    - [Help with Translations Here](#help-with-translations-here)\n  - [Installation](#installation)\n    - [Linux](#linux)\n      - [Flatpak](#flatpak)\n      - [Debian, Ubuntu and Derivatives](#debian-ubuntu-and-derivatives)\n      - [Arch (AUR)](#arch-aur)\n      - [Fedora](#fedora)\n      - [Other Distributions (AppImage and TAR.XZ)](#other-distributions-appimage-and-tarxz)\n    - [Windows](#windows)\n    - [macOS](#macos)\n  - [Development environment](#development-environment)\n    - [Building Heroic Binaries](#building-heroic-binaries)\n    - [Building with VS Code](#building-with-vs-code)\n    - [Quickly testing/debugging Heroic on your own system](#quickly-testingdebugging-heroic-on-your-own-system)\n    - [Testing with Docker](#testing-with-docker)\n  - [Sponsors](#sponsors)\n  - [Screenshots](#screenshots)\n  - [Credits](#credits)\n\n## Features available right now\n\n- Login with an existing Epic Games, GOG or Amazon account\n- Install, uninstall, update, repair and move Games\n- Import an already installed game\n- Play Epic games online [AntiCheat on macOS and on Linux depends on the game]\n- Play games using Wine or Proton [Linux]\n- Play games using Crossover [macOS]\n- Download custom Wine and Proton versions [Linux]\n- Access to Epic, GOG and Amazon Games stores directly from Heroic\n- Search for the game on ProtonDB for compatibility information [Linux]\n- Show ProtonDB and Steam Deck compatibility information [Linux]\n- Sync installed games with an existing Epic Games Store installation\n- Sync saves with the cloud\n- Custom Theming Support\n- Download queue\n- Add Games and Applications outside GOG, Epic Games and Amazon Games\n- Define your categories to organize your collection\n\n## Planned features\n\n- Support Other Store (IndieGala, etc)\n\n## Supported Operating Systems\n\n- Linux:\n  - Ubuntu 20.04LTS or newer\n  - Fedora 33 or newer\n  - Arch Linux \u0026 derivatives (Manjaro, Garuda, EndeavourOS)\n  - Heroic will still _work_ on most distros, but it is up to you to _get_ it to work\n    Chances are though that someone on our [Discord](https://discord.gg/rHJ2uqdquK) can help you\n- SteamOS (downloading using Discover only)\n- Windows 10 \u0026 11\n- macOS 12 or newer\n\n## Language Support\n\n\u003cdetails\u003e\n  \u003csummary\u003eExpand\u003c/summary\u003e\n\nThanks to the community, Heroic was translated to almost 40 different languages so far:\n\n- English\n- Azerbaijani\n- Basque\n- Belarussian\n- Bosnian\n- Bulgarian\n- Catalan\n- Czech\n- Croatian\n- Simplified Chinese\n- Traditional Chinese\n- Dutch\n- Estonian\n- Finnish\n- French\n- German\n- Greek\n- Hebraic\n- Japanese\n- Korean\n- Hungarian\n- Italian\n- Indonesian\n- Malayalam\n- Norwegian Bokmål\n- Persian\n- Polish\n- Portuguese\n- Portuguese (Brazil)\n- Romanian\n- Russian\n- Serbian\n- Spanish\n- Slovak\n- Swedish\n- Tamil\n- Turkish\n- Ukrainian\n- Vietnamese\n\n\u003c/details\u003e\n\n### Help with Translations [Here](https://hosted.weblate.org/projects/heroic-games-launcher)\n\n## Installation\n\n### Linux\n\n#### Flatpak\n\n[\u003cimg src=\"https://flathub.org/assets/badges/flathub-badge-en.png\" alt=\"Flathub Badge\" width=\"10%\" /\u003e](https://flathub.org/apps/details/com.heroicgameslauncher.hgl)\n\nHeroic is available on Flathub, so you should be able to easily install it on most distros with Software Centers (Pop!\\_Shop, Discover, etc.)\n\n#### Distribution-specific instructions\n\nIf you're not using the Flatpak version, make sure you have all Wine dependencies installed:\n[Wine Dependencies](https://github.com/lutris/docs/blob/master/WineDependencies.md).\n\n#### Debian, Ubuntu and Derivatives\n\nDownload the file ending in .deb from the [latest release](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest).  \nDouble-click it to open it up in your Software Manager, or run `sudo dpkg -i heroic_*_amd64.deb` to install it directly:\n\n#### Arch (AUR)\n\nWe currently only support one AUR package: `heroic-games-launcher-bin`. Although you might find other packages there, do not ask support for them on this Github or on our Discord, ask their maintainers directly.\n\n- [![Stable version badge](https://img.shields.io/aur/version/heroic-games-launcher-bin?style=flat\u0026label=heroic-games-launcher-bin)](https://aur.archlinux.org/packages/heroic-games-launcher-bin)  \n  (stable release, recommended)\n\nPlease see [the Arch Wiki](https://wiki.archlinux.org/title/Arch_User_Repository#Installing_and_upgrading_packages) on how to install them\n\n#### Fedora\n\n##### COPR repo\n\nHeroic for Fedora is available on [this COPR repo](https://copr.fedorainfracloud.org/coprs/atim/heroic-games-launcher/).  \nEnable it with `sudo dnf copr enable atim/heroic-games-launcher`, then install Heroic with `sudo dnf install heroic-games-launcher-bin`\n\n##### Binary package from the releases page\n\nYou can alternatively download the file ending in .rpm from the [latest release](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest) and install it with `sudo dnf install ./heroic-*.x86_64.rpm`\n\n#### Other Distributions (AppImage and TAR.XZ)\n\nSince these two distribution formats don't have a form of dependency management, make sure the `curl` command is available. You might run into weird issues if it's not.\n\n##### AppImage\n\n- Download the file ending in .AppImage from the [latest release](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest)\n- Make it executable (`chmod +x Heroic*.AppImage`)\n- Run it (double-click in most file managers, or run `./Heroic*.AppImage`)\n\n##### .tar.xz\n\n- Download the file ending in .tar.xz from the [latest release](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest)\n- Extract it anywhere\n- Run the `heroic` file in the folder you extracted it to (double-click in most file managers, or run `./heroic`)\n\n### Windows\n\n#### WinGet\n\nIf you use WinGet (installed by default on Windows 11 and modern versions of 10), you can run `winget install Heroic` in a terminal to install Heroic.\n\n#### Manual installl\n\nDownload the Heroic Installer (`Heroic-x.x.x-Setup.exe`) or the portable version (`Heroic-x.x.x-Portable.exe`) from the [latest release](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest). Run the executable you downloaded to install/run Heroic.  \nThe Setup will create shortcuts to Heroic on your Desktop and in your Start Menu.\n\n### macOS\n\nIf you use Homebrew, you can run `brew install --cask --no-quarantine heroic` to install Heroic.  \nOtherwise, download the file ending in .dmg from the [latest release](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest), double-click it to mount it, and drag the \"Heroic\" application into the \"Applications\" folder.\n\n## Development environment\n\nThis part will walk you through setting up a development environment so you can build Heroic binaries yourself or make changes to the code.\n\n1. Make sure Git, NodeJS, and pnpm 9 are installed  \n   **NOTE**: On Windows, due to an issue with electron-builder, you'll need the standalone version of pnpm (`@pnpm/exe`)\n   to build packages\n2. Clone the repo and enter the cloned folder, for example with these commands:\n\n   ```bash\n   git clone https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher.git --recurse-submodules\n   cd HeroicGamesLauncher\n   ```\n\n3. Make sure all dependencies are installed by running `pnpm install`\n\n### Building Heroic Binaries\n\nRun the appropriate command for your OS:\n\n- Build for Linux:\n\n  ```bash\n  pnpm dist:linux # Optionally specify a package to create (eg: deb, pacman, tar.xz, rpm, AppImage); default: AppImage\n  ```\n\n- Build for Windows:\n\n  ```bash\n  pnpm dist:win\n  ```\n\n- Build for Mac:\n  ```bash\n  pnpm dist:mac\n  ```\n\n### Building with VS Code\n\nInstead of using the above commands to build Heroic, you can also use the Tasks in VSCode to build.\nTo do that, open up the command palette (Ctrl + P), type in \"task\" and press Space. You will then see 3 build tasks, \"Build for Linux\", \"Build for Windows\", and \"Build for MacOS\". Click the one you want to run.\n\n### Quickly testing/debugging Heroic on your own system\n\nIf you want to quickly test a change, or you're implementing features that require a lot of restarts, you can use Vite's development server to speed up the process:  \nGo to the \"Run and Debug\" tab of VSCode and start the \"Launch Heroic (HMR \u0026 HR)\" task (alternatively, if you're not using VSCode or just prefer the terminal, run `pnpm start`). Heroic will start up after a short while, and once you make any change to the code, it'll reload/restart.\n\n## Sponsors\n\nThanks [Weblate](https://weblate.org/en/) for hosting our translations\n\n![weblate](https://s.weblate.org/cdn/Logo-Darktext-borders.png)\n\nThanks [Signpath](https://signpath.io/?utm_source=foundation\u0026utm_medium=github\u0026utm_campaign=heroicgameslauncher) for providing free signing of Windows binaries\n\n[![signpath](https://user-images.githubusercontent.com/26871415/182468471-6ef4aac6-a4e2-4ae8-93ef-d638cd01627d.png)](https://signpath.io/?utm_source=foundation\u0026utm_medium=github\u0026utm_campaign=heroicgameslauncher)\n\n## Screenshots\n\n\u003cdetails\u003e\n  \u003csummary\u003eExpand\u003c/summary\u003e\n\n![image](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/assets/26871415/70c9e0f2-3fa8-4e56-9bb0-0e5f8713c968)\n![image](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/assets/26871415/95e199d5-24de-4a23-a8b8-657afd657390)\n![image](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/assets/26871415/e190ddce-b16c-40c6-a509-b1337669b65a)\n![image](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/assets/26871415/9868d9eb-c141-4b46-874d-e13f668480cb)\n![image](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/assets/26871415/07e76bdb-e794-41fd-9028-062fa22f15b6)\n![image](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/assets/26871415/8daf7035-4f30-4dcd-a7ef-412ef690a286)\n![image](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/assets/26871415/61467411-f518-4d10-b859-9c2adef3302e)\n\n\u003c/details\u003e\n\n## Credits\n\n### Weblate: Localization platform\n\n- URL: https://weblate.org/en/\n\n### Those Awesome Guys: Gamepad prompts images\n\n- URL: https://thoseawesomeguys.com/prompts/\n\n[![jump](https://img.shields.io/badge/Back%20to%20top-%20?style=flat\u0026color=grey\u0026logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGhlaWdodD0iMjRweCIgdmlld0JveD0iMCAwIDI0IDI0IiB3aWR0aD0iMjRweCIgZmlsbD0iI0ZGRkZGRiI+PHBhdGggZD0iTTAgMGgyNHYyNEgwVjB6IiBmaWxsPSJub25lIi8+PHBhdGggZD0iTTQgMTJsMS40MSAxLjQxTDExIDcuODNWMjBoMlY3LjgzbDUuNTggNS41OUwyMCAxMmwtOC04LTggOHoiLz48L3N2Zz4=)](#heroic-games-launcher)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHeroic-Games-Launcher%2FHeroicGamesLauncher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHeroic-Games-Launcher%2FHeroicGamesLauncher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHeroic-Games-Launcher%2FHeroicGamesLauncher/lists"}