{"id":15113823,"url":"https://github.com/redromnon/heroicbashlauncher","last_synced_at":"2025-09-27T15:31:59.847Z","repository":{"id":37237399,"uuid":"429317861","full_name":"redromnon/HeroicBashLauncher","owner":"redromnon","description":"Directly launch any Epic Games Store and GOG game from anywhere without Heroic on Linux.","archived":true,"fork":false,"pushed_at":"2024-05-19T09:28:31.000Z","size":6930,"stargazers_count":354,"open_issues_count":14,"forks_count":17,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-09-27T01:23:25.827Z","etag":null,"topics":["bash-script","epic-games","gog","heroic-games-launcher","linux-gaming","steam"],"latest_commit_sha":null,"homepage":"","language":"Python","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/redromnon.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}},"created_at":"2021-11-18T06:15:42.000Z","updated_at":"2024-09-02T07:07:50.000Z","dependencies_parsed_at":"2024-05-19T10:31:11.273Z","dependency_job_id":"82965d88-bd9b-4f9f-b82a-6b579c3dffc1","html_url":"https://github.com/redromnon/HeroicBashLauncher","commit_stats":null,"previous_names":[],"tags_count":52,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redromnon%2FHeroicBashLauncher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redromnon%2FHeroicBashLauncher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redromnon%2FHeroicBashLauncher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redromnon%2FHeroicBashLauncher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/redromnon","download_url":"https://codeload.github.com/redromnon/HeroicBashLauncher/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234448347,"owners_count":18834213,"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":["bash-script","epic-games","gog","heroic-games-launcher","linux-gaming","steam"],"created_at":"2024-09-26T01:23:25.914Z","updated_at":"2025-09-27T15:31:59.457Z","avatar_url":"https://github.com/redromnon.png","language":"Python","funding_links":["https://www.buymeacoffee.com/redromnon","https://img.buymeacoffee.com/button-api/?text=Buy"],"categories":[],"sub_categories":[],"readme":"# Announcement: _This project will no longer be maintained. It was a good run. Thanks everyone for using HeroicBashLauncher!_\n\n\u003cimg alt=\"GitHub\" src=\"https://img.shields.io/github/license/redromnon/HeroicBashLauncher?style=for-the-badge\"\u003e   \u003cimg alt=\"GitHub release (latest by date including pre-releases)\" src=\"https://img.shields.io/github/v/release/redromnon/HeroicBashLauncher?color=blue\u0026include_prereleases\u0026style=for-the-badge\"\u003e    \u003cimg alt=\"GitHub Repo stars\" src=\"https://img.shields.io/github/stars/redromnon/HeroicBashLauncher?color=yellow\u0026style=for-the-badge\"\u003e  \u003cimg alt=\"GitHub closed issues\" src=\"https://img.shields.io/github/issues-closed/redromnon/HeroicBashLauncher?color=blueviolet\u0026style=for-the-badge\"\u003e  \u003cimg alt=\"GitHub top language\" src=\"https://img.shields.io/github/languages/top/redromnon/HeroicBashLauncher?color=green\u0026style=for-the-badge\"\u003e  \u003cimg alt=\"GitHub all releases\" src=\"https://img.shields.io/github/downloads/redromnon/HeroicBashLauncher/total?color=red\u0026style=for-the-badge\"\u003e  \u003ca href=\"https://www.buymeacoffee.com/redromnon\"\u003e\u003cimg src=\"https://img.buymeacoffee.com/button-api/?text=Buy me a coffee\u0026emoji=\u0026slug=redromnon\u0026button_colour=FFDD00\u0026font_colour=000000\u0026font_family=Poppins\u0026outline_colour=000000\u0026coffee_colour=ffffff\" width=150 /\u003e\u003c/a\u003e\n\n# HeroicBashLauncher\n\n**NOTE - This is an independent project and not affiliated with Heroic Games Launcher.**\n\nEver wanted to launch your [Heroic Games Launcher](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher) game library directly from the Steam, Lutris, GameHub or any other frontend game launcher without opening Heroic? \nBash Launcher does exactly this and takes you straight to the game!     \n\n![Heroic Bash Launcher](https://user-images.githubusercontent.com/74495920/142615495-a4e5e811-7ee3-41b8-ae80-d6d008820f2a.png)\n\n\n## Index\n\n- [Features](#features)\n- [Pre-requisites](#pre-requisites)\n- [Using Bash Launcher](#using-bash-launcher)\n  - [Download](#download)\n  - [Running the Program](#running-the-program)\n  - [Configuring Settings](#configuring-settings)\n  - [Launching Games](#launching-games)\n- [Handy Guides](#handy-guides)\n- [Issues and Suggestions](#issues-and-suggestions)\n- [Building and Testing](#building-and-testing)\n- [License](#license)\n- [Support](#support)\n\n\n## Features\n\n✔️ Creates game launch scripts for installed Epic \u0026 GOG games that act as shortcuts\n\n✔️ Completely bypasses Heroic running in the background and eliminates any extra _CPU_ and _memory_ usage*\n\n✔️ Includes all launch parameters including cloud save-syncing (EPIC GAMES ONLY) set in Heroic's Game Settings\n\n✔️ Syncs games to Steam along with artwork**\n\n✔️ Enables per game profile customization for Steam Deck users\n\n✔️ Users can add game launch scripts to any game library or manager like Lutris, GameHub, GNOME Games, etc.\n\n\n  *Launching occurs via legendary and gogdl programs which Heroic uses\n\n  **The \"Add To Steam\" feature in Heroic (v2.4.0+) is recommended\n\n\n## Pre-requisites\n- Heroic\n- Zenity\n- glibc v2.31+\n\n\n## Using Bash Launcher\n\n### Download\nHead over to the [Releases](https://github.com/redromnon/HeroicBashLauncher/releases) page. Then download and extract the **.zip** file of the latest release.\n\n### Running the Program\nExecute the program by simply  double-clicking the HeroicBashLauncher executable. You should be greeted by the _Process Finished_ dialog at the end. Don't forget to enable executable permission - you can achieve that by doing a right-click and selecting Properties. \n\n#### Running in Silent Mode\nIf you want to disable the GUI dialog pop-ups for some reason, you can execute `./HeroicBashLauncher --silent` from the terminal.\n\n### Configuring Settings\n\nOpen the `settings.config` file and disable an option by changing \"true\" to \"false\".\n\nThe following options are available:\n- `\"artwork\"` - Downloads artwork for adding Heroic games to Steam\n- `\"epic\"` - Creates scripts for your Heroic Epic library\n- `\"gog\"` - Creates scripts for your Heroic GOG library\n- `\"autoaddtosteam\"` - Automatically add Heroic games (game scripts) to Steam for Deck users\n \n### Launching Games\n\n#### Steam Deck users\nYour games will be automatically added to Steam along with the artwork. Just open Steam or switch to the Deck UI Mode to launch your titles.\n\n#### Desktop users\n- Run your game by executing the game's launch script by double-clicking the game's launch scipt or running ```./\u003cgamename\u003e_Heroic.sh```\n- Using your preferred game launcher/manager, just point the executable path to the game's launch script or just run `AddToSteam.sh` to add and launch games from Steam. Simple!\n\n**Don't copy or move the game files and launch scripts anywhere else, it won't work.** \n\n\n## Handy Guides\n\n- [Bash Launcher Wiki](https://github.com/redromnon/HeroicBashLauncher/wiki)\n- [Flatpak/Steam Deck extended guide](https://github.com/redromnon/HeroicBashLauncher/wiki/Steam-Deck-(Flatpak)-Guide)\n- [Adding Heroic games to Lutris and GameHub](https://github.com/redromnon/HeroicBashLauncher/wiki/Adding-Games-to-Game-Launchers-\u0026-Managers)\n- [Syncing games to Steam](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/wiki/Adding-Games-to-Steam-on-Linux#adding-your-games-to-steam)\n\n\n## Issues and Suggestions\n\n**Do note that I don't have a Deck and this tool wasn't developed with the Steam Deck in mind, thus you may encounter Deck-specific issues.**\n\nBefore submitting an issue :\n\n- Make sure you've run the game from Heroic atleast once\n\n- Restart Steam after adding the launch scripts if the games don't launch. \n\n- Disable the Proton compatibility layer for the newly added launch script. You're not trying to run a game but a script.\n\n- Try using Wine-GE instead of Proton, since Proton is made for Steam games in mind.\n\n- Check if the added game's TARGET *(Right Click Game -\u003e Properties -\u003e SHORTCUT)* points to the correct path in Steam\n\nIf it's not working for you, consider checking the logs. The logs for the game launch scripts and the program are present in `/GameFiles/logs`and the `HeroicBashLauncher.log` respectively.\n\nFeel free to suggest any new features and post issues in the _heroic-bash-launcher_ channel by joining [Heroic's Discord server](https://discord.gg/kXADMWbqu2). \n\n\n## Building and Testing\nSince the program makes use of an executable, you will need **Python version 3.8+ and PyInstaller** to build the code.\n\nYou will also need [wget](https://pypi.org/project/wget/) and [requests](https://pypi.org/project/requests/).\n\nTo build the program, run `build.sh` which will generate an executable stored in the `dist` folder. Copy the executable, paste it in `HeroicBashLauncher` and run it to test.\n\n\n## License\nThis project is under the GNU GPLv3 license. You can take a look at LICENSE.md for more information.\n\nMakes use of these amazing projects -\n[Legendary](https://github.com/derrod/legendary),\n[heroic-gogdl](https://github.com/Heroic-Games-Launcher/heroic-gogdl) and\n[Heroic Games Launcher](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher).\n\n\n## Support\nLike my work!? Feel free to Buy Me A Coffee.\n\n\u003ca href=\"https://www.buymeacoffee.com/redromnon\"\u003e\u003cimg src=\"https://img.buymeacoffee.com/button-api/?text=Buy me a coffee\u0026emoji=\u0026slug=redromnon\u0026button_colour=FFDD00\u0026font_colour=000000\u0026font_family=Poppins\u0026outline_colour=000000\u0026coffee_colour=ffffff\" /\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredromnon%2Fheroicbashlauncher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fredromnon%2Fheroicbashlauncher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredromnon%2Fheroicbashlauncher/lists"}