You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Experimental support for **multiple accounts** of the same endpoint (e.g. multiple GitHub accounts).
24
-
- Support for **Git Worktrees**: view and manage all your worktrees in the same repository, with the ability to easily switch between them.
25
+
- Support for **multiple accounts** of the same endpoint (e.g. multiple GitHub accounts).
26
+
Simply add as many accounts as you want in the "Accounts" settings page. If a repository is using an incorrect account, you can change it in the repository settings.
27
+
28
+
- Support for **Git Worktrees**: view and manage all your worktrees in the same repository, with the ability to easily switch between them.
29
+
To view the worktrees dropdown, enable it in the app settings or press `Ctrl+E` / `Cmd+E`.
30
+
31
+
- Support for **multiple windows**: open multiple repositories in separate windows, or the same repository in multiple windows (e.g. to view different files at the same time).
32
+
Select "File" > "Open new window" or press `Ctrl+Alt+N`/`Cmd+Alt+N`. You can also right-click on a repository in the list and select "Open repository in new window".
33
+
25
34
-**Bitbucket** and **GitLab** integration:
26
35
- Clone repositories from within the app.
27
36
- Preview and create pull requests.
28
37
- View pull requests status, including checks.
29
38
- Display a commit or PR in Bitbucket/GitLab (web browser).
30
39
- Correctly set repository owner (instead of displaying "Other").
40
+
41
+
The integration is enabled automatically for the corresponding repositories if you are logged in to your account.
42
+
31
43
- Allow using a **different text editor for a given repo**, by overriding it in the repository settings.
32
-
- Add **icons** to some similar-looking buttons for faster visual recognition.
33
-
- Red background for destructive action buttons.
34
-
- Allow generating **branch name presets** by calling an external script (e.g. fetching ticket numbers from an issue tracker). [Click here for more details](docs/branch-name-presets.md).
44
+
45
+
- Some similar-looking buttons now have distinct **icons** for faster visual recognition.
46
+
47
+
- Buttons with destructive actions have a red background to make them more visually distinct.
48
+
49
+
- Allow generating **branch name presets** by calling an external script (e.g. fetching ticket numbers from an issue tracker).
50
+
[Click here for more details](docs/branch-name-presets.md).
35
51
36
52
### Repositories list:
37
53
38
54
- "**Pull all**" button to fetch and pull all your repositories at once.
55
+
39
56
- Allow showing the **current branch name** next to the repository name.
40
-
- Allow **hiding** the "**Recent**" repositories section.
41
-
- Allow customizing the **repository groups** to better organize your repositories (right click on a repository and select "Change group name").
57
+
58
+
- Allow **hiding** the "Recent" repositories section.
59
+
60
+
- Allow customizing the **repository groups** to better organize your repositories.
61
+
Right click on a repository and select "Change group name".
42
62
43
63
### Branches list:
44
64
45
-
- Add warning indicator to **local-only branches** (branches that have not been pushed to the remote, or that have been deleted automatically after a PR).
46
-
- Allow manually setting which is the **default branch** for a repository (even if it doesn't match the one configured in the remote).
65
+
- Added a warning indicator to **local-only branches** (branches that have not been pushed to the remote, or that have been deleted automatically after a PR).
66
+
67
+
- Allow manually setting which is the **default branch** for a repository (even if it doesn't match the one configured in the remote).
68
+
Right click on a branch and select "Set as default branch". The default branch is used as the base when creating new branches.
69
+
70
+
- Allow changing the **sort order** of the branch list to either "Recently updated" or "Alphabetical".
47
71
48
72
### History tab:
49
73
50
74
-**Search commits** by title, message, tag, or hash.
75
+
51
76
- Use a different font style for **merge commits** in order to make them visually distinct, since most of the time they are not as relevant.
77
+
78
+
- Allow choosing between relative dates ("3 days ago") or absolute dates ("Mar 14, 2026, 2:34 PM") for displaying commit dates.
79
+
52
80
- If a commit modifies only 1 file, allow double-clicking the commit to open the file. For other commits, you can still double-click the file as usual.
81
+
53
82
- Allow deleting commits and tags that have already been pushed. Please note that this is intended for advanced users only, and can cause problems if the commits have already been pulled by other collaborators.
54
83
55
84
### Changes tab:
56
85
57
-
-Context menu option to **permanently discard changes** without sending to trash (useful when the there are many changed files and the regular "Discard" is extremely slow).
86
+
-Added the option to **permanently discard changes** without sending to trash. This is useful when the there are many changed files and the regular "Discard" is extremely slow.
Simply install `github-desktop-plus-bin` from the AUR.
101
+
#### Using Winget (Recommended)
67
102
68
-
You can also build from source by installing `github-desktop-plus` or `github-desktop-plus-git` from the AUR.
103
+
```powershell
104
+
winget install polrivero.GitHubDesktopPlus
105
+
```
69
106
70
-
> `gnome-keyring` is required and the daemon must be launched either at login or when the X server / Wayland compositor is started. Normally this is handled by a display manager, but in other cases following the instructions found on the [Arch Wiki](https://wiki.archlinux.org/index.php/GNOME/Keyring#Using_the_keyring_outside_GNOME) will fix the issue of not being able to save login credentials.
107
+
To update, run `winget upgrade polrivero.GitHubDesktopPlus` or `winget upgrade --all` to update all your winget packages. Make sure to update regularly to get the latest features and fixes.
108
+
109
+
#### Manual download (Not recommended)
110
+
111
+
Download and execute the installer from the [releases page](https://github.com/pol-rivero/github-desktop-plus/releases/latest).
Please note that the app doesn't autoupdate like the official GitHub Desktop, so you will need to manually download and install it every time you want to update.
119
+
For this reason, I recommend using Winget instead of the manual download.
120
+
121
+
</details>
122
+
123
+
### macOS
124
+
125
+
<details>
126
+
<summary>Click to expand</summary>
127
+
128
+
#### Using Homebrew (Recommended)
129
+
130
+
```bash
131
+
brew install pol-rivero/tap/github-desktop-plus
132
+
```
133
+
134
+
Make sure to run `brew update` regularly to get the latest updates for GitHub Desktop Plus.
135
+
136
+
#### Manual download (Not recommended)
137
+
138
+
Download and extract the ZIP file from the [releases page](https://github.com/pol-rivero/github-desktop-plus/releases/latest). Click the app file to run it.
139
+
If you encounter the error "Apple could not verify this app is free of malware", go to "System Settings" > "Privacy & Security", scroll down to "Security" and click "Open Anyway" on "GitHub Desktop Plus".
140
+
141
+
|**64-bit x86**|**64-bit ARM (Apple Silicon)**|
142
+
| --- | --- |
143
+
|`-macOS-x64.zip`|`-macOS-arm64.zip`|
144
+
145
+
Please note that the app doesn't autoupdate like the official GitHub Desktop, so you will need to manually download it every time you want to update.
146
+
For this reason, I recommend using Homebrew instead of the manual download.
You can install GitHub Desktop Plus from Flathub by following the instructions at https://flathub.org/en/apps/io.github.pol_rivero.github-desktop-plus or by running the following command:
198
+
Simply install `github-desktop-plus-bin` from the AUR.
You can also build from source by installing `github-desktop-plus` or `github-desktop-plus-git` from the AUR.
201
+
202
+
> `gnome-keyring` is required and the daemon must be launched either at login or when the X server / Wayland compositor is started. Normally this is handled by a display manager, but in other cases following the instructions found on the [Arch Wiki](https://wiki.archlinux.org/index.php/GNOME/Keyring#Using_the_keyring_outside_GNOME) will fix the issue of not being able to save login credentials.
128
203
129
204
</details>
130
205
131
-
### AppImage (any distro, not recommended)
206
+
207
+
### Flatpak (any distro)
132
208
133
209
<details>
134
210
<summary>Click to expand</summary>
135
211
136
-
Download the AppImage from the [releases page](https://github.com/pol-rivero/github-desktop-plus/releases/latest) and make it executable:
212
+
You can install GitHub Desktop Plus from Flathub by following the instructions at https://flathub.org/en/apps/io.github.pol_rivero.github-desktop-plus or by running the following command:
> I recommend using your distribution's native package manager (or Flatpak) instead of the AppImage.
155
227
156
-
```powershell
157
-
winget install polrivero.GitHubDesktopPlus
158
-
```
228
+
#### Using ["AM"/"AppMan"](https://github.com/ivan-hc/AM)
159
229
160
-
To update, run `winget upgrade polrivero.GitHubDesktopPlus` or `winget upgrade --all` to update all your winget packages. Make sure to update regularly to get the latest features and fixes.
230
+
```bash
231
+
# If using "AM":
232
+
am install github-desktop-plus
233
+
# If using "AppMan":
234
+
appman install github-desktop-plus
235
+
```
161
236
162
237
#### Manual download (Not recommended)
163
238
164
-
Download and execute the installer from the [releases page](https://github.com/pol-rivero/github-desktop-plus/releases/latest).
Make sure to run `brew update` regularly to get the latest updates for GitHub Desktop Plus.
251
+
Finally, double-click the .AppImage file to run it.
185
252
186
-
#### Manual download (Not recommended)
187
-
188
-
Download and extract the ZIP file from the [releases page](https://github.com/pol-rivero/github-desktop-plus/releases/latest). Click the app file to run it.
189
-
If you encounter the error "Apple could not verify this app is free of malware", go to "System Settings" > "Privacy & Security", scroll down to "Security" and click "Open Anyway" on "GitHub Desktop Plus".
190
-
191
-
|**64-bit x86**|**64-bit ARM (Apple Silicon)**|
192
-
| --- | --- |
193
-
|`-macOS-x64.zip`|`-macOS-arm64.zip`|
194
253
195
254
</details>
196
255
197
-
## Common issues
256
+
## Common issues 🛠️
198
257
199
258
Before opening a new issue, please check the [Known Issues](docs/known-issues.md) document for common issues and their workarounds.
200
259
201
-
## Running the app locally
260
+
## Running the app locally 💻
202
261
203
262
### From the terminal
204
263
@@ -241,7 +300,7 @@ yarn test:docker
241
300
242
301
## Why this fork?
243
302
244
-
First of all, because shiftkey's fork is currently unmaintained (last commit was in February 2025), so it's not getting the latest features and fixes from the official GitHub Desktop repository.
303
+
First of all, because shiftkey's fork is currently unmaintained (last commit was in February 2025), so all Linux users are no longer getting the latest features and fixes from the official GitHub Desktop repository.
245
304
246
305
Secondly, I think the official GitHub Desktop app is very slow in terms of updates and lacks some advanced features that I'd like. This fork has low code quality requirements compared to the official repo, so I (and hopefully you as well) can add features and improvements quickly.
247
306
This fork also focuses on integrating nicely with Bitbucket, since I use it for work and haven't found a good Linux GUI client for it.
0 commit comments