mirror of
https://github.com/sourcegit-scm/sourcegit.git
synced 2024-12-26 21:17:20 -08:00
Windows/macOS/Linux GUI client for GIT users
.github/workflows | ||
build | ||
screenshots | ||
src | ||
.editorconfig | ||
.gitattributes | ||
.gitignore | ||
global.json | ||
LICENSE | ||
README.md | ||
SourceGit.sln | ||
VERSION |
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(>=2.23.0) first.
You can download the latest stable from Releases or download workflow artifacts from Github Actions to try this app based on latest commits.
This software creates a folder $"{System.Environment.SpecialFolder.ApplicationData}/SourceGit"
, which is platform-dependent, to store user settings, downloaded avatars and crash logs.
OS | PATH |
---|---|
Windows | C:\Users\USER_NAME\AppData\Roaming\SourceGit |
Linux | /home/USER_NAME/.config/SourceGit |
macOS | /Users/USER_NAME/.config/SourceGit |
For Windows users:
- MSYS Git is NOT supported. Please use official Git for Windows instead.
sourcegit_x.y.win-x64.zip
may be reported as virus by Windows Defender. I don't know why. I have manually tested the zip to be uploaded using Windows Defender before uploading and no virus was found. If you have installed .NET 8 SDK locally, I suggest you to compile it yourself. And if you have any idea about how to fix this, please open an issue.
For macOS users:
- Download
sourcegit_x.y.osx-x64.zip
orsourcegit_x.y.osx-arm64.zip
from Releases.x64
for Intel andarm64
for Apple Silicon. - Move
SourceGit.app
toApplications
folder. - Make sure your mac trusts all software from anywhere. For more information, search
spctl --master-disable
. - Make sure git-credential-manager 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 is installed on your linux.
- Maybe you need to set environment variable
AVALONIA_SCREEN_SCALE_FACTORS
. See https://github.com/AvaloniaUI/Avalonia/wiki/Configuring-X11-per-monitor-DPI.
External Tools
This app supports open repository in external tools listed in the table below.
Tool | 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 |
Sublime Text | YES | YES | YES | SUBLIME_TEXT_PATH |
- You can set the given environment variable for special tool if it can NOT be found by this app automatically.
- Installing
JetBrains Toolbox
will help this app to find other JetBrains tools installed on your device.
Screenshots
- Dark Theme
- Light Theme
Contributing
Thanks to all the people who contribute.