| title | intro | redirect_from | versions | shortTitle | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Configuring a default editor in GitHub Desktop |
You can configure {% data variables.product.prodname_desktop %} to open files in your project with your preferred text editor or integrated development environment (IDE). |
|
|
Configure default editor |
{% data variables.product.prodname_desktop %} provides support for a number of editors, and also allows you to select a custom editor if your preferred editor is not supported. If you installed an editor while {% data variables.product.prodname_desktop %} was open you will need to quit and reopen {% data variables.product.prodname_desktop %} in order for the editor to be detected.
{% mac %}
- MacVim
- {% data variables.product.prodname_vscode %}
- Visual Studio Codium
- Sublime Text
- BBEdit
- JetBrains WebStorm
- JetBrains PhpStorm
- JetBrains Rider
- JetBrains PyCharm
- JetBrains RubyMine
- JetBrains IntelliJ IDEA
- JetBrains GoLand
- JetBrains Fleet
- JetBrains DataSpell
- Brackets
- To use Brackets with {% data variables.product.prodname_desktop %}, you must install the Command Line shortcut. To install the shortcut, open Brackets, click File in the menu bar, then click Install Command Line Shortcut.
- Typora
- CodeRunner
- SlickEdit
- Xcode
- RStudio
- Nova
- Android Studio
- Aptana Studio
- Neovide
- Emacs
- Lite XL
- Pulsar
- Zed
{% endmac %}
{% windows %}
- {% data variables.product.prodname_vscode %}
- Visual Studio Codium
- Sublime Text
- ColdFusion Builder
- Typora
- SlickEdit
- JetBrains IntelliJ Idea
- JetBrains WebStorm
- JetBrains PhpStorm
- JetBrains Rider
- JetBrains CLion
- JetBrains PyCharm
- JetBrains RubyMine
- JetBrains GoLand
- JetBrains Fleet
- JetBrains DataSpell
- Android Studio
- Brackets
- Notepad++
- RStudio
- Aptana Studio
{% endwindows %}
{% mac %}
{% data reusables.desktop.mac-select-desktop-menu %}
- In the Settings window, select Integrations.
- Under "External Editor", use the dropdown menu to select the editor you want to set as your default.
- Click Save.
{% endmac %}
{% windows %}
{% data reusables.desktop.windows-choose-options %}
- In the Options window, select Integrations.
- Under "External Editor", use the dropdown menu to select the editor you want to set as your default.
- Click Save.
{% endwindows %}
{% data reusables.desktop.mac-select-desktop-menu %}
- In the Settings window, select Integrations.
- Under "External Editor", use the dropdown menu to select Configure Custom Editor.
- Click Choose to open the system dialog to navigate to the path of your custom editor.
- Under "Arguments", enter any arguments you would like to use after the "%TARGET_PATH%" variable. Reference supporting documentation for your custom editor to ensure you have the arguments set correctly, as invalid arguments can prevent the editor from launching in {% data variables.product.prodname_desktop %}.
- Click Save.
To open the current repository in the default editor, you can use the menu bar:
- In the menu bar, select Repository.
- Click Open in default editor
If you want to open another repository in the default editor, you can use the repository list.
- In the upper-left corner of {% data variables.product.prodname_desktop %}, to the right of the current repository name, click {% octicon "triangle-down" aria-label="The triangle-down icon" %}.
- Right-click the repository, then click Open in default editor.
{% mac %}
Tip
You can use the Shift+Command+A keyboard shortcut to open a repository in the default editor.
{% endmac %}
{% windows %}
Tip
You can use the Ctrl+Shift+A keyboard shortcut to open a repository in the default editor.
{% endwindows %}
- Navigate to the "Changes" tab in the left sidebar.
- Double-click on the file, or right-click on the file and select Open in default editor.