{"id":24583696,"url":"https://github.com/toebeann/gib","last_synced_at":"2026-03-14T03:19:11.817Z","repository":{"id":206831688,"uuid":"717633944","full_name":"toebeann/gib","owner":"toebeann","description":"A simple TUI application for automating the installation of BepInEx on macOS","archived":false,"fork":false,"pushed_at":"2026-02-18T22:15:44.000Z","size":826,"stargazers_count":58,"open_issues_count":7,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-19T02:59:23.611Z","etag":null,"topics":["bepinex","bun","installer","installer-script","nodejs","tui","utility"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/toebeann.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},"funding":{"github":["toebeann"],"ko_fi":"toebean_","custom":["https://paypal.me/tobeyblaber"]}},"created_at":"2023-11-12T04:00:45.000Z","updated_at":"2026-02-19T02:52:45.000Z","dependencies_parsed_at":"2023-11-12T17:47:42.532Z","dependency_job_id":"23ca4ef8-dc40-4f7d-8016-8ae20c7a050d","html_url":"https://github.com/toebeann/gib","commit_stats":null,"previous_names":["toebeann/gib"],"tags_count":71,"template":false,"template_full_name":null,"purl":"pkg:github/toebeann/gib","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toebeann%2Fgib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toebeann%2Fgib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toebeann%2Fgib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toebeann%2Fgib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/toebeann","download_url":"https://codeload.github.com/toebeann/gib/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toebeann%2Fgib/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30278153,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-08T20:45:49.896Z","status":"ssl_error","status_checked_at":"2026-03-08T20:45:49.525Z","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":["bepinex","bun","installer","installer-script","nodejs","tui","utility"],"created_at":"2025-01-24T04:48:21.713Z","updated_at":"2026-03-09T00:02:46.925Z","avatar_url":"https://github.com/toebeann.png","language":"TypeScript","readme":"# gib\n\n[\u003cimg alt=\"Usage statistics for gib from the jsDelivr CDN\" src=\"https://data.jsdelivr.com/v1/package/gh/toebeann/gib/badge\"\u003e](https://www.jsdelivr.com/package/gh/toebeann/gib?tab=stats)\n\ngib _(tobey's Guided Installer for BepInEx)_ is a TUI application for automating\nthe installation of [BepInEx](https://github.com/BepInEx/BepInEx), the popular\nmodding framework for Unity games.\n\nTo get started, just run the following command in Terminal:\n\n```sh\ncurl -fsSL https://cdn.jsdelivr.net/gh/toebeann/gib/gib.sh | bash\n```\n\n![Running gib in the Terminal](https://github.com/toebeann/gib/assets/45315526/1325c6cf-b057-4491-8826-37a54a05affd)\n\ngib aims to automate whatever it can, and hold your hand through whatever it\ncannot. Check the [Features](#features) section for details.\n\nCurrently only macOS is supported, as the process of manual BepInEx installation\nis _exceptionally_ cumbersome on this operating system. Both Intel-based and\nApple Silicon processors are supported, provided you are running on macOS 13\n(Ventura) or later. For other limitations, see the [Caveats](#caveats) section.\n\n## Table of contents\n\n- [gib](#gib)\n  - [Table of contents](#table-of-contents)\n  - [Features](#features)\n  - [Usage](#usage)\n    - [Quick start](#quick-start)\n    - [Walkthrough](#walkthrough)\n      - [Prerequisites](#prerequisites)\n      - [Running gib](#running-gib)\n  - [Temporarily disabling mods for a game](#temporarily-disabling-mods-for-a-game)\n    - [Re-enabling mods after disabling them](#re-enabling-mods-after-disabling-them)\n  - [Uninstallation](#uninstallation)\n    - [Uninstalling BepInEx](#uninstalling-bepinex)\n      - [Clearing Steam launch options](#clearing-steam-launch-options)\n      - [Removing Steam shortcuts](#removing-steam-shortcuts)\n      - [Removing shortcuts from Applications](#removing-shortcuts-from-applications)\n      - [Removing BepInEx from the game folder](#removing-bepinex-from-the-game-folder)\n    - [Uninstalling gib](#uninstalling-gib)\n  - [Caveats](#caveats)\n  - [License](#license)\n\n## Features\n\n- Completely automates the process of installing BepInEx 5 for native unix\n  builds of Unity games on macOS - no more falling asleep or pulling your hair\n  out with frustration while trying to\n  [install it manually](https://github.com/toebeann/BepInEx.Subnautica/wiki/Idiot's-guide-to-macOS-installation#manual-installation)!\n- Takes care of all the annoying stuff like making the run script executable and\n  giving permission to run BepInEx which is where most people give up when\n  installing manually!\n- Implements custom workarounds for common macOS-specific issues with BepInEx!\n- After installing BepInEx, runs an automated test to check that BepInEx is\n  actually loading when you run the game, so you know that everything is working\n  as it's supposed to!\n- Nifty Steam integrations:\n\n  - Automatically configures the launch options to run Steam games with BepInEx!\n  - Optionally adds Steam shortcuts to run Steam games vanilla (without mods) or\n    non-Steam games with mods!\n\n    _**Note:** The Steam shortcuts feature is experimental, please see\n    [Caveats](#caveats) below for details._\n\n## Usage\n\n### Quick start\n\nJust run the following command in Terminal:\n\n```sh\ncurl -fsSL https://cdn.jsdelivr.net/gh/toebeann/gib/gib.sh | bash\n```\n\nThis command will install and launch gib. After this command has completed, to\nrun gib in future you can simply run the command `gib` in Terminal instead.\n**Note:** You will need to reload the Terminal for this change to take effect.\n\nIf you're curious how it all works or want to verify the source code is safe,\ncheck [`gib.sh`](https://github.com/toebeann/gib/blob/main/gib.sh) and\n[`index.ts`](https://github.com/toebeann/gib/blob/main/src/cli/index.ts) for\ndetails.\n\nIf you get stuck, refer to the below [walkthrough](#walkthrough).\n\n### Walkthrough\n\n\u003e [!TIP]\\\n\u003e If you run into any unexpected issues while following these instructions or\n\u003e need further assistance, please feel free to\n\u003e [open an issue](https://github.com/toebeann/gib/issues/new/choose) describing\n\u003e what happened, ideally providing the output from running gib, and I'll help\n\u003e when I can.\n\n\u003e [!NOTE]\\\n\u003e These usage instructions were originally written with macOS Sonoma in mind.\n\u003e The instructions below should work for other versions of macOS, but there may\n\u003e be some slight differences.\n\n#### Prerequisites\n\n- You'll want a Finder window open at the folder where the game is installed.\n\n  - If you own the game on Steam, find the game in your library, then\n    right-click it and select `Manage` -\u003e `Browse local files`.\n\n  - For the Epic Games Launcher, find the game in your library, then right-click\n    it and select `Manage`. In the window that opens, look for the folder icon\n    and click it.\n\n  - For games you typically launch with Spotlight, search for the game as usual\n    in Spotlight, and when the game is highlighted in the drop-down, hold\n    `Command` until the icon changes to Finder. With `Command` still held down,\n    press `Enter`.\n\n- You'll want a copy of BepInEx downloaded and unzipped in your Downloads\n  folder.\n\n  If you're unsure where to get BepInEx from, try a Google search for\n  `[game name] bepinex pack`, e.g. for Subnautica, I would search for:\n\n  ```\n  Subnautica BepInEx pack\n  ```\n\n  Where available, it is always advised to use a popular pack of BepInEx which\n  has been tailored to the specific game you're trying to mod.\n\n  If you can't find a BepInEx pack for the game, then the latest stable version\n  of BepInEx from their official GitHub repo will do.\n  [You can find it here](https://github.com/BepInEx/BepInEx/releases/latest) -\n  scroll down to the `Assets` section, then download the file with \"unix\" or\n  \"macos_x64\" in the name, e.g. `BepInEx_unix_5.4.22.0.zip`,\n  `BepInEx_macos_x64_5.4.23.2.zip`\n\n  Make sure it is unzipped in your Downloads folder after downloading it, as\n  presently gib requires this. By default, Safari will have unzipped it for you.\n  If you use other browsers, simply open the .zip and macOS should unzip it for\n  you.\n\n  Go ahead and open a Finder window in the unzipped BepInEx folder, so that you\n  can see the file `run_bepinex.sh` (or similar).\n\n  Leave this Finder window open - you'll want to come back to it later.\n\n  \u003cimg width=\"920\" alt=\"A screenshot of Finder window open at the location of BepInEx's run_bepinex.sh \" src=\"https://github.com/toebeann/gib/assets/45315526/8b961265-2fd2-4017-85fb-2c91369a825f\"\u003e\n\n#### Running gib\n\n1. Open Terminal from Launchpad or Spotlight (press `Command Space`, type\n   `terminal` and press `Enter`).\n\n   \u003cimg width=\"600\" alt=\"Searching for Terminal with macOS Spotlight\" src=\"https://github.com/toebeann/BepInEx.Subnautica/assets/45315526/f374da75-5c74-4b49-99c2-25daa296c504\"\u003e\n\n2. Copy the command from the [Quick start](#quick-start) section above and paste\n   it in your terminal window with `Command V`, then press `Enter` to run it.\n\n   \u003cimg width=\"585\" alt=\"Running gib in the Terminal\" src=\"https://github.com/toebeann/gib/assets/45315526/1325c6cf-b057-4491-8826-37a54a05affd\"\u003e\n\n3. Now, simply follow the instructions in the terminal to install BepInEx to\n   your game!\n\n\u003e [!TIP]\\\n\u003e You can press `Control C` at any time in the terminal to abort.\n\n\u003e [!TIP]\\\n\u003e If you ran into any unexpected issues while following these instructions or\n\u003e need further assistance, please feel free to\n\u003e [open an issue](https://github.com/toebeann/gib/issues/new/choose) describing\n\u003e what happened, ideally providing the output from running gib, and I'll help\n\u003e when I can.\n\n## Temporarily disabling mods for a game\n\n\u003e [!NOTE]\\\n\u003e Please note that this section only applies to Steam games, For non-Steam\n\u003e games, you can simply run the game normally - _without_ Steam - and it should\n\u003e launch vanilla.\n\nIf you have installed BepInEx with gib for a Steam game, you will have been\ngiven the option to add a shortcut to Steam to launch the game without mods\n(vanilla). However, this feature is experimental and for some games, it\nunfortunately cannot work due to the way the game is coded. Or, you may simply\nhave declined the option and now find that you do indeed want to run the game\nwithout mods temporarily.\n\nIn either case, you can temporarily disable mods by following these steps:\n\n1. Locate the game in your Steam library, then right-click it and choose\n   `Properties...`\n2. In the `General` tab of the window which opens, there should be a text input\n   for launch options. Add the following text to the _beginning_ of the text\n   field, so that it comes before _any_ other text:\n   ```sh\n   %command% #\n   ```\n3. Close the window.\n\nNow, when you run the game with Steam, it should run without any mods. If you\ninstead get an error when you try to launch the game, it means you made a\nmistake when you were editing the launch options. Make sure that `%command% #`\ncomes before _any_ other text in the launch options!\n\nYou may want to\n[remove the vanilla shortcut for the game](#removing-steam-shortcuts), if you\nadded one when running gib.\n\n### Re-enabling mods after disabling them\n\nTo re-enable mods after\n[temporarily disabling them](#temporarily-disabling-mods-for-a-game), you simply\nneed to undo the changes you made to the launch options:\n\n1. Locate the game in your Steam library, then right-click it and choose\n   `Properties...`\n2. In the `General` tab of the window which opens, there should be a text input\n   for launch options. **Delete** the following text, which should be at the\n   start of the line:\n   ```sh\n   %command% #\n   ```\n3. Close the window.\n\nThe game should now run with mods once more when launched through Steam. If you\nget an error when you try to launch the game, it means you made a mistake when\nediting the launch options. If you can't seem to fix it, you will need to run\ngib again to reinstall BepInEx for the game - don't delete any files, just run\nthe gib command again and it will fix the launch options for you - you won't\nlose any mods or anything.\n\n## Uninstallation\n\n### Uninstalling BepInEx\n\nAt present, uninstalling BepInEx is an entirely manual process which gib cannot\nautomate, but it is fairly straightforward:\n\n1. Undo any changes gib made to your Steam library:\n   - **Steam games:**\n     [clear the launch options](#clearing-steam-launch-options), and\n     [remove the vanilla shortcut added during instalation](#removing-steam-shortcuts),\n     if applicable.\n   - **Non-Steam games:**\n     [remove the Steam shortcut to launch the game with BepInEx]((#removing-steam-shortcuts)),\n     if applicable.\n2. You should also\n   [remove the shortcuts added to your Applications folder by gib for the game](#removing-shortcuts-from-applications).\n3. Optionally, you can reclaim the disk space used by BepInEx and your mods by\n   [removing BepInEx from the game folder](#removing-bepinex-from-the-game-folder).\n   As long as you've followed the previous steps this is entirely optional, but\n   probably a good idea since mods can take up a lot of space - and this _isn't_\n   taken care of for you when you uninstall the game!\n\n#### Clearing Steam launch options\n\n\u003e [!NOTE]\\\n\u003e Please note that this section only applies to Steam games.\n\nTo uninstall BepInEx from Steam games, we need to clear the launch options for\nthe game which are responsible for injecting BepInEx when we launch the game\nfrom Steam:\n\n1. Locate the game in your Steam library, then right-click it and choose\n   `Properties...`\n2. In the `General` tab of the window which opens, there should be a text input\n   for launch options. Click into the text box, press `Command A` to select all\n   text, then `Backspace` or `Delete` to clear the launch options.\n3. Close the window.\n\nNow, when you launch the game with Steam it will launch completely vanilla, with\nno mods.\n\n#### Removing Steam shortcuts\n\nWhen setting up BepInEx you may have optionally added a Steam shortcut, e.g. for\nSteam games you can add an optional shortcut to launch the game without mods\n(vanilla), and for non-Steam games it is often preferable to set up a Steam\nshortcut to launch the game with mods.\n\nIn either case, if you're uninstalling BepInEx from the game you likely want to\nget rid of these shortcuts. To do so, follow these steps:\n\n1. Locate the shortcut in your Steam library. If you have trouble finding it,\n   you can use the search bar at the top to search for `(Vanilla)` or\n   `(BepInEx)` as applicable.\n2. Right-click the shortcut in your library and choose `Manage` -\u003e\n   `Remove non-Steam game from your library`.\n\n#### Removing shortcuts from Applications\n\nWhen setting up BepInEx with gib, it often adds shortcuts to your Applications\nfolder for easy use from Launchpad or Spotlight. If you're no longer planning to\nuse BepInEx with the game, you should remove these shortcuts. To do so, follow\nthese steps:\n\n1. Open Spotlight with `Command Space`, start typing the name until you find the\n   shortcut - it will have the suffix `(Vanilla)` or `(BepInEx)`. If you can't\n   find it then you don't have one and can skip this.\n2. With the shortcut selected in Spotlight, hold `Command` until the icon\n   changes to Finder. With `Command` still held down, press `Enter`.\n3. You should find yourself in a Finder window at the location of the shortcut.\n   Simply delete it as normal.\n\n#### Removing BepInEx from the game folder\n\n\u003e [!IMPORTANT]\\\n\u003e Make sure you follow the first two steps of\n\u003e [Uninstalling BepInEx](#uninstalling-bepinex) section before doing this.\n\nIf you want to reclaim the disk space taken up by BepInEx and the mods you're no\nlonger using, here are instructions on how to completely remove BepInEx and all\nmods from the game folder:\n\n1. Navigate to the game folder in Finder, the same way you found it when\n   installing BepInEx. If you can't remember how to find it, check the\n   [Prerequisites](#prerequisites) section for instructions.\n2. Delete the following files if present:\n   - `changelog.txt`\n   - `doorstop_config.ini`\n   - `libdoorstop.dylib`\n   - `run_bepinex.sh` (or similar)\n   - `winhttp.dll`\n3. Delete the following folders if present:\n   - `doorstop_libs`\n   - `corlibs`\n4. Finally, delete the `BepInEx` folder itself. Be aware that deleting this\n   folder will delete not only BepInEx but also all mods you had installed, and\n   any stored configuration of those mods.\n\n### Uninstalling gib\n\n\u003e [!NOTE]\\\n\u003e Uninstalling gib itself is entirely optional and will not uninstall BepInEx,\n\u003e nor any mods you have installed for any games. For that, see\n\u003e [Uninstalling BepInEx](#uninstalling-bepinex).\n\nAs of gib v0.8, gib is a single-file executable built with\n[bun](https://bun.sh/), and takes up ~150 MB of space.\n\nIf you do want to uninstall gib, simply execute the following command in\nTerminal to delete all gib-related files:\n\n```sh\nrm -rf ~/.gib\n```\n\n## Caveats\n\n- Steam shortcuts are an experimental feature and may not work with all games -\n  particularly the shortcuts to launch the game vanilla (without mods). For\n  non-Steam games this isn't an issue - you can simply launch the game\n  \"normally\" (_without_ Steam) and as such we don't offer to create a vanilla\n  shortcut. For Steam games however this can be irksome if we want to\n  occasionally run the game without mods.\n\n  If the vanilla shortcut does not work for one of your Steam games, you are\n  encouraged to [remove the vanilla shortcut](#removing-steam-shortcuts) and\n  follow the guide to\n  [temporarily disable mods for the game](#temporarily-disabling-mods-for-a-game).\n\n- Only native macOS applications are currently supported.\n\n  - Support for Windows apps on macOS (e.g. via Wine-based solutions like\n    CrossOver) is being considered.\n\n  - Support for other operating systems is being considered.\n\n- Only BepInEx 5 is currently supported. Support for BepInEx 6 is being\n  considered, but is unlikely to happen soon. It's worth noting  that the\n  primary use of BepInEx 6 is for IL2CPP games, and modding IL2CPP games on\n  macOS is almost impossible with current tech.\n\n- Users on Apple Silicon sometimes report that their game performance seems to\n  diminish with only BepInEx installed. This is due to the fact that BepInEx is\n  built for Intel-based chips, and therefore your Apple Silicon chip needs to\n  run it through Rosetta. Unfortunately, there is nothing gib can do to resolve\n  this, since BepInEx does not currently support Apple Silicon. You could try\n  running the Windows version of the game (and likewise installing the Windows\n  build of BepInEx) to see if that helps things at all. My recommendation would\n  be to prefer a Wine-based solution such as CrossOver over VMs like Parallels\n  Desktop, as VM-based solutions will introduce more performance bottlenecks,\n  though they are typically more convenient to get running. With a Wine-based\n  approach, make sure you additionally configure Wine to inject BepInEx when the\n  game launches by setting `winhttp` as a DLL override from the `Libraries` tab\n  of the game's Wine Configuration, otherwise the game will run without BepInEx\n  and thus without mods. Google how to access the Wine Configuration via\n  whatever Wine-based solution you're using if you're unsure how, e.g. \"access\n  Wine Configuration via CrossOver\". You also probably will need to Google \"how\n  to install Windows versions of Steam games on mac with CrossOver\" or similar\n  to get started.\n\n## License\n\ngib is licensed under the\n[ISC License](https://github.com/toebeann/gib?tab=ISC-1-ov-file#readme).\n","funding_links":["https://github.com/sponsors/toebeann","https://ko-fi.com/toebean_","https://paypal.me/tobeyblaber"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoebeann%2Fgib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoebeann%2Fgib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoebeann%2Fgib/lists"}