mirror of
https://github.com/sourcegit-scm/sourcegit.git
synced 2024-10-31 13:03:20 -07:00
111bf2966a
* supported editors can be different on different platforms. * display founded editors only
84 lines
2.9 KiB
Markdown
84 lines
2.9 KiB
Markdown
# SourceGit
|
|
|
|
Opensource Git GUI client.
|
|
|
|
## Highlights
|
|
|
|
* Supports Windows/macOS/Linux
|
|
* Opensource/Free
|
|
* Fast
|
|
* English/简体中文
|
|
* Built-in light/dark themes
|
|
* Visual commit graph
|
|
* Supports SSH access with each remote
|
|
* GIT commands with GUI
|
|
* Clone/Fetch/Pull/Push...
|
|
* Branches
|
|
* Remotes
|
|
* Tags
|
|
* Stashes
|
|
* Submodules
|
|
* Archive
|
|
* Diff
|
|
* Save as patch/apply
|
|
* File histories
|
|
* Blame
|
|
* Revision Diffs
|
|
* GitFlow support
|
|
|
|
> **Linux** only tested on **Ubuntu 22.04** on **X11**.
|
|
|
|
## How to use
|
|
|
|
**To use this tool, you need to install Git first.**
|
|
|
|
You can download the latest stable from [Releases](https://github.com/sourcegit-scm/sourcegit/releases/latest) or download workflow artifacts from [Github Actions](https://github.com/sourcegit-scm/sourcegit/actions) to try this app based on latest commits.
|
|
|
|
For **Windows** users:
|
|
|
|
* **MSYS Git is NOT supported**. Please use official [Git for Windows](https://git-scm.com/download/win) instead.
|
|
|
|
For **macOS** users:
|
|
|
|
* Download `SourceGit.osx-x64.zip` or `SourceGit.osx-arm64.zip` from Releases. `x64` for Intel and `arm64` for Apple Silicon.
|
|
* Move `SourceGit.app` to `Applications` folder.
|
|
* Make sure your mac trusts all software from anywhere. For more information, search `spctl --master-disable`.
|
|
* Make sure [git-credential-manager](https://github.com/git-ecosystem/git-credential-manager/releases) is installed on your mac.
|
|
* You may need to run `sudo xattr -cr /Applications/SourceGit.app` to make sure the software works.
|
|
|
|
For **Linux** users:
|
|
|
|
* `xdg-open` must be installed to support open native file manager.
|
|
* Make sure [git-credential-manager](https://github.com/git-ecosystem/git-credential-manager/releases) is installed on your linux, and it requires `ttf-mscorefonts-installer` installed.
|
|
* Maybe you need to set environment variable `AVALONIA_SCREEN_SCALE_FACTORS`. See https://github.com/AvaloniaUI/Avalonia/wiki/Configuring-X11-per-monitor-DPI.
|
|
* Modify `SourceGit.desktop.template` (replace SOURCEGIT_LOCAL_FOLDER with real path) and move it into `~/.local/share/applications`.
|
|
|
|
## External Editors
|
|
|
|
This app supports open repository in external editors listed in the table below.
|
|
|
|
| Editor | Windows | macOS | Linux | Environment Variable |
|
|
| --- | --- | --- | --- | --- |
|
|
| Visual Studio Code | YES | YES | YES | VSCODE_PATH |
|
|
| Visual Studio Code - Insiders | YES | YES | YES | VSCODE_INSIDERS_PATH |
|
|
| JetBrains Fleet | YES | YES | YES | FLEET_PATH |
|
|
|
|
You can set the given environment variable for special editor if it can NOT be found by this app automatically.
|
|
|
|
## Screen Shots
|
|
|
|
* Dark Theme
|
|
|
|
|
|
|
|
* Light Theme
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
Thanks to all the people who contribute.
|
|
|
|
<a href="https://github.com/sourcegit-scm/sourcegit/graphs/contributors">
|
|
<img src="https://contrib.rocks/image?repo=sourcegit-scm/sourcegit&t=1" />
|
|
</a>
|