2020-08-12 13:10:18 +00:00
# [GitHub Desktop](https://desktop.github.com)
2016-08-04 16:02:45 +00:00
2021-12-07 18:08:52 +00:00
[GitHub Desktop ](https://desktop.github.com/ ) is an open source [Electron ](https://www.electronjs.org/ )-based
2022-06-26 14:06:27 +00:00
GitHub app. It is written in [TypeScript ](https://www.typescriptlang.org ) and
2021-02-18 11:48:09 +00:00
uses [React ](https://reactjs.org/ ).
2016-05-11 16:16:32 +00:00
2022-11-18 15:44:07 +00:00
< picture >
< source
srcset="https://user-images.githubusercontent.com/634063/202742848-63fa1488-6254-49b5-af7c-96a6b50ea8af.png"
media="(prefers-color-scheme: dark)"
/>
< img
width="1072"
src="https://user-images.githubusercontent.com/634063/202742985-bb3b3b94-8aca-404a-8d8a-fd6a6f030672.png"
alt="A screenshot of the GitHub Desktop application showing changes being viewed and committed with two attributed co-authors"
/>
< / picture >
2017-05-16 07:34:08 +00:00
2017-04-21 06:53:59 +00:00
## Where can I get it?
2017-08-21 05:55:16 +00:00
Download the official installer for your operating system:
2017-04-21 06:53:59 +00:00
2021-05-27 15:15:24 +00:00
- [macOS ](https://central.github.com/deployments/desktop/desktop/latest/darwin )
2022-07-20 14:10:45 +00:00
- [macOS (Apple silicon) ](https://central.github.com/deployments/desktop/desktop/latest/darwin-arm64 )
2018-02-01 23:08:53 +00:00
- [Windows ](https://central.github.com/deployments/desktop/desktop/latest/win32 )
- [Windows machine-wide install ](https://central.github.com/deployments/desktop/desktop/latest/win32?format=msi )
2017-04-10 19:33:57 +00:00
2017-04-21 05:09:46 +00:00
You can install this alongside your existing GitHub Desktop for Mac or GitHub
2017-04-21 06:53:59 +00:00
Desktop for Windows application.
2021-12-27 19:05:35 +00:00
Linux is not officially supported; however, you can find installers created for Linux from a fork of GitHub Desktop in the [Community Releases ](https://github.com/desktop/desktop#community-releases ) section.
2021-12-07 18:08:52 +00:00
2021-12-23 09:50:37 +00:00
**NOTE**: There is no current migration path to import your existing
2017-04-21 06:53:59 +00:00
repositories into the new application - you can drag-and-drop your repositories
from disk onto the application to get started.
2017-04-11 15:17:27 +00:00
2021-12-23 09:52:50 +00:00
2017-11-08 22:15:06 +00:00
### Beta Channel
Want to test out new features and get fixes before everyone else? Install the
beta channel to get access to early builds of Desktop:
2018-02-01 23:08:53 +00:00
- [macOS ](https://central.github.com/deployments/desktop/desktop/latest/darwin?env=beta )
2022-07-20 14:10:45 +00:00
- [macOS (Apple silicon) ](https://central.github.com/deployments/desktop/desktop/latest/darwin-arm64?env=beta )
2018-02-01 23:08:53 +00:00
- [Windows ](https://central.github.com/deployments/desktop/desktop/latest/win32?env=beta )
2021-04-08 15:49:17 +00:00
- [Windows (ARM64) ](https://central.github.com/deployments/desktop/desktop/latest/win32-arm64?env=beta )
2022-07-20 14:10:45 +00:00
2021-01-22 22:18:08 +00:00
The release notes for the latest beta versions are available [here ](https://desktop.github.com/release-notes/?env=beta ).
2018-12-27 17:48:46 +00:00
2019-05-21 13:16:51 +00:00
### Community Releases
2019-05-21 13:15:39 +00:00
2019-05-21 13:16:51 +00:00
There are several community-supported package managers that can be used to
install GitHub Desktop:
2023-03-09 06:27:27 +00:00
- Windows users can install using [winget ](https://docs.microsoft.com/en-us/windows/package-manager/winget/ ) `c:\> winget install github-desktop` or [Chocolatey ](https://chocolatey.org/ ) `c:\> choco install github-desktop`
2019-05-21 13:15:39 +00:00
- macOS users can install using [Homebrew ](https://brew.sh/ ) package manager:
2020-12-23 12:54:08 +00:00
`$ brew install --cask github`
2019-05-19 11:56:23 +00:00
2019-05-21 13:16:51 +00:00
Installers for various Linux distributions can be found on the
[`shiftkey/desktop` ](https://github.com/shiftkey/desktop ) fork.
2019-05-19 11:56:23 +00:00
2019-05-21 13:16:51 +00:00
Arch Linux users can install the latest version from the
[AUR ](https://aur.archlinux.org/packages/github-desktop-bin/ ).
2019-05-19 11:56:23 +00:00
2018-09-26 22:43:29 +00:00
## Is GitHub Desktop right for me? What are the primary areas of focus?
2018-12-27 17:48:46 +00:00
[This document ](https://github.com/desktop/desktop/blob/development/docs/process/what-is-desktop.md ) describes the focus of GitHub Desktop and who the product is most useful for.
2018-09-26 22:43:29 +00:00
2018-12-27 17:48:46 +00:00
And to see what the team is working on currently and in the near future, check out the [GitHub Desktop roadmap ](https://github.com/desktop/desktop/blob/development/docs/process/roadmap.md ).
2017-04-26 06:27:22 +00:00
## I have a problem with GitHub Desktop
2018-12-27 17:48:46 +00:00
Note: The [GitHub Desktop Code of Conduct ](https://github.com/desktop/desktop/blob/development/CODE_OF_CONDUCT.md ) applies in all interactions relating to the GitHub Desktop project.
2018-08-15 20:37:09 +00:00
2018-02-01 23:08:53 +00:00
First, please search the [open issues ](https://github.com/desktop/desktop/issues?q=is%3Aopen )
and [closed issues ](https://github.com/desktop/desktop/issues?q=is%3Aclosed )
to see if your issue hasn't already been reported (it may also be fixed).
2017-04-26 06:27:22 +00:00
2018-12-27 17:48:46 +00:00
There is also a list of [known issues ](https://github.com/desktop/desktop/blob/development/docs/known-issues.md )
2018-02-12 01:27:46 +00:00
that are being tracked against Desktop, and some of these issues have workarounds.
2018-05-08 00:59:39 +00:00
If you can't find an issue that matches what you're seeing, open a [new issue ](https://github.com/desktop/desktop/issues/new/choose ),
choose the right template and provide us with enough information to investigate
2018-02-01 23:08:53 +00:00
further.
2017-04-26 06:27:22 +00:00
2018-08-15 20:37:09 +00:00
## The issue I reported isn't fixed yet. What can I do?
If nobody has responded to your issue in a few days, you're welcome to respond to it with a friendly ping in the issue. Please do not respond more than a second time if nobody has responded. The GitHub Desktop maintainers are constrained in time and resources, and diagnosing individual configurations can be difficult and time consuming. While we'll try to at least get you pointed in the right direction, we can't guarantee we'll be able to dig too deeply into any one person's issue.
2017-05-04 11:56:57 +00:00
## How can I contribute to GitHub Desktop?
2017-04-11 15:17:27 +00:00
2018-02-23 06:13:33 +00:00
The [CONTRIBUTING.md ](./.github/CONTRIBUTING.md ) document will help you get setup and
2017-05-04 11:56:57 +00:00
familiar with the source. The [documentation ](docs/ ) folder also contains more
2017-04-21 06:53:59 +00:00
resources relevant to the project.
2018-02-01 23:08:53 +00:00
If you're looking for something to work on, check out the [help wanted ](https://github.com/desktop/desktop/issues?q=is%3Aissue+is%3Aopen+label%3A%22help%20wanted%22 ) label.
2017-05-31 14:23:36 +00:00
2022-10-10 14:26:45 +00:00
## Building Desktop
2023-03-10 17:54:00 +00:00
To setup your development environment for building Desktop, check out: [`setup.md` ](./docs/contributing/setup.md ).
2022-10-10 14:26:45 +00:00
2017-04-21 06:53:59 +00:00
## More Resources
See [desktop.github.com ](https://desktop.github.com ) for more product-oriented
information about GitHub Desktop.
2017-04-10 14:41:04 +00:00
2021-12-08 14:27:57 +00:00
See our [getting started documentation ](https://docs.github.com/en/desktop/installing-and-configuring-github-desktop/overview/getting-started-with-github-desktop ) for more information on how to set up, authenticate, and configure GitHub Desktop.
2017-04-10 14:41:04 +00:00
## License
**[MIT](LICENSE)**
2017-04-21 05:09:46 +00:00
The MIT license grant is not for GitHub's trademarks, which include the logo
2018-02-01 23:08:53 +00:00
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 ](app/static/logos ).
2017-04-10 14:41:04 +00:00
2017-04-21 05:09:46 +00:00
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 ](https://github.com/logos ).