Working on GNU/Linux (without snap), Windows and macOS.
✔ Verified on version v7.7.0 ~ v9.5.1
It should support any newer version, unless the entrypoint code (src/main/static/startMainProcess.js of The App source) is modified.
WARNING! On
macOSyou should patchThe Apponly after first launch and full program closing!
The App On-Premise Serverless(Recommended)The App Pro
Node.jsv12 LTS or lateryarn
yarn installyarn buildnode dist/bin/gitcracken.js --helpfor more usage information
$ yarn gitcracken patcher [options] [actions...]actions - array of values (any order, any count)
If
actionsis empty, will be usedautomode (ideal for beginners)
| Action | Description |
|---|---|
backup |
Backup app.asar file |
unpack |
Unpack app.asar file into app directory |
patch |
Patch app directory |
pack |
Pack app directory to app.asar file |
remove |
Remove app directory |
| Option | Description (if not defined, will be used auto value) |
|---|---|
-a, --asar |
Path to app.asar file |
-d, --dir |
Path to app directory |
-f, --feature |
Patcher feature (from patches dir without extension) |
You can invoke
-f,--featureseveral times to apply all patches!
Auto patch installed The App (maybe require sudo privileges on GNU/Linux) By Default Patch Pro
$ yarn gitcracken patcherThe App On-Premise Serverless Client patch
$ yarn gitcracken patcher -f serverlessUse custom path to app.asar
$ yarn gitcracken patcher --asar ~/Downloads/gitkraken/resources/app.asarUse custom actions (backup, unpack and patch)
$ yarn gitcracken patcher backup unpack patchThis patch will modify your license while The App fetching your profile. So if you still got free edition, you should re-login your The App account.
Please ensure the communication with The App server. Somebody may blocked the The App server by the DNS or hosts file, please comment out or remove it temporarily.
If you still got free edition after re-login. Deleting the local profile might help. (Usually the path is %appdata%\.gitkraken for Windows, or ~/.gitkraken for Linux or macOS)
There is a quarantine flag while downloading an App from Internet. If you changed it before the first launch, macOS will think the App was broken.
If you already do that, you can execute sudo xattr -rd com.apple.quarantine /Application/The App.app to remove quarantine flag.
Search macos quarantine for more details.
Add this content to your hosts file:
0.0.0.0 release.gitkraken.com