/desktop

Fork of GitHub Desktop to support various Linux distributions

Primary LanguageTypeScriptMIT LicenseMIT

GitHub Desktop - The Linux Fork

Travis Azure DevOps Pipelines Build Status GitHub Desktop license 90+% TypeScript

GitHub Desktop is an open source Electron-based GitHub app. It is written in TypeScript and uses React.

GitHub Desktop screenshot - Windows

What is this repository for?

This repository contains specific patches on top of the upstream desktop/desktop repository to support Linux usage.

It also hosts preview packages for various Linux distributions:

  • AppImage (.AppImage)
  • Debian (.deb)
  • RPM (.rpm)
  • Snap (.snap) - also available from snapcraft.io

Check out the latest releases to help out with testing on your distribution.

Snapcraft Store

We are currently testing out a new version of the Snap that requires using the classic enclosure, as GitHub Desktop has integrations to launch your chosen shell or editor which are not supported in the strict enclosure.

If you are currently running the Snap installed from edge

You will be prompted to manually upgrade to the beta channel as an installed application cannot upgrade it's enclosure via an update.

To upgrade manually, run these commands:

$ snap remove github-desktop
$ snap install github-desktop --beta --classic

Other Distributions

Arch Linux users can install GitHub Desktop from the AUR.

gnome-keyring is required and the daemon must be launched either at login or when the X server is started. Normally this is handled by a display manager, but in other cases following the instructions found on the Arch Wiki will fix the issue of not being able to save login credentials.

More information

Please check out the README on the upstream GitHub Desktop project and desktop.github.com for more product-oriented information about GitHub Desktop.

License

MIT

The MIT license grant is not for GitHub's trademarks, which include the logo designs. GitHub reserves all trademark and copyright rights in and to all GitHub trademarks. GitHub's logos include, for instance, the stylized Invertocat designs that include "logo" in the file title in the following folder: logos.

GitHub® and its stylized versions and the Invertocat mark are GitHub's Trademarks or registered Trademarks. When using GitHub's logos, be sure to follow the GitHub logo guidelines.