mirror of https://github.com/sourcegit-scm/sourcegit.git synced 2024-12-22 20:37:19 -08:00

Windows/macOS/Linux GUI client for GIT users

Find a file

Alexander Bogomolets 927a1cab24 Add checkout local changes handling This commit adds the local changes handling behavior for branch checkout. One of three can be selected: stash and reapply after checkout, discard changes or leave them as is (previous behaviour)		2024-04-29 16:40:20 +08:00
.github/workflows	ci: fix wrong runtime identifier for linux	2024-04-29 14:25:24 +08:00
build	build: read version from VERSION file	2024-04-17 11:24:25 +08:00
screenshots	update<screenshots>:	2024-02-21 12:07:56 +08:00
src	Add checkout local changes handling	2024-04-29 16:40:20 +08:00
.editorconfig	code_style: using avalonia's editorconfig and run `dotnet format`.	2024-03-31 16:54:29 +08:00
.gitattributes	Gitattributes Fix	2024-03-20 02:33:19 -05:00
.gitignore	update: git ignore files & folders	2024-04-16 19:50:40 +08:00
global.json	dotnet Config Files	2024-03-20 01:56:26 -05:00
LICENSE	style<*>: use mono font for all contents	2024-02-18 10:41:41 +08:00
README.md	readme: add tips for finding other tools by JetBrains Toolbox	2024-04-27 22:12:31 +08:00
SourceGit.sln	build: read version from VERSION file	2024-04-17 11:24:25 +08:00
VERSION	version: Release 8.10	2024-04-29 11:00:57 +08:00

README.md

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 or sourcegit_x.y.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 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.