sourcegit/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 first.

You can download the latest stable from Releases or download workflow artifacts from Github Actions to try this app based on latest commits.

For Windows users:

• MSYS Git is NOT supported. Please use official Git for Windows 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 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, 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.