[!WARNING] Linux only tested on Debian 12 on both X11 & Wayland.
You can find the current translation status in TRANSLATION.md
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 | %APPDATA%\SourceGit |
Linux | ${HOME}/.config/SourceGit or ${HOME}/.sourcegit |
macOS | ${HOME}/Library/Application Support/SourceGit |
[!TIP]
- You can open this data storage directory from the main menu
Open Data Storage Directory
.- You can create a
data
folder next to theSourceGit
executable to force this app to store data (user settings, downloaded avatars and crash logs) into it (Portable-Mode). Only works on Windows.
For Windows users:
winget
with follow commands:winget install SourceGit
[!NOTE]
winget
will install this software as a commandline tool. You need runSourceGit
from console orWin+R
at the first time. Then you can add it to the taskbar.
scoop
with follow commands:scoop bucket add extras
scoop install sourcegit
For macOS users:
SourceGit
available on Homebrew
. You can simply install it with following command:brew tap ybeapps/homebrew-sourcegit
brew install --cask --no-quarantine sourcegit
SourceGit.app
from Github Release manually, you need run following command to make sure it works:sudo xattr -cr /Applications/SourceGit.app
echo $PATH > ~/Library/Application\ Support/SourceGit/PATH
to generate a custom PATH env file to introduce PATH
env to SourceGit.For Linux users:
Thanks @aikawayataro for providing rpm
and deb
repositories, hosted on Codeberg.
deb
how to:
curl https://codeberg.org/api/packages/yataro/debian/repository.key | sudo tee /etc/apt/keyrings/sourcegit.asc
echo "deb [signed-by=/etc/apt/keyrings/sourcegit.asc, arch=amd64,arm64] https://codeberg.org/api/packages/yataro/debian generic main" | sudo tee /etc/apt/sources.list.d/sourcegit.list
sudo apt update
sudo apt install sourcegit
rpm
how to:
curl https://codeberg.org/api/packages/yataro/rpm.repo | sed -e 's/gpgcheck=1/gpgcheck=0/' > sourcegit.repo
# Fedora 41 and newer
sudo dnf config-manager addrepo --from-repofile=./sourcegit.repo
# Fedora 40 and earlier
sudo dnf config-manager --add-repo ./sourcegit.repo
sudo dnf install sourcegit
If your distribution isn't using dnf
, please refer to the documentation of your distribution on how to add an rpm
repository.
AppImage
files can be found on AppImage hub, xdg-open
(xdg-utils
) 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.
If you can NOT type accented characters, such as ê
, ó
, try to set the environment variable AVALONIA_IM_MODULE
to none
.
This software supports using OpenAI or other AI service that has an OpenAI compatible HTTP API to generate commit message. You need configurate the service in Preference
window.
For OpenAI
:
Server
must be https://api.openai.com/v1
For other AI service:
Server
should fill in a URL equivalent to OpenAI's https://api.openai.com/v1
. For example, when using Ollama
, it should be http://localhost:11434/v1
instead of http://localhost:11434/api/generate
API Key
is optional that depends on the serviceThis app supports open repository in external tools listed in the table below.
Tool | Windows | macOS | Linux |
---|---|---|---|
Visual Studio Code | YES | YES | YES |
Visual Studio Code - Insiders | YES | YES | YES |
VSCodium | YES | YES | YES |
Fleet | YES | YES | YES |
Sublime Text | YES | YES | YES |
Zed | NO | YES | YES |
Visual Studio | YES | NO | NO |
[!NOTE] This app will try to find those tools based on some pre-defined or expected locations automatically. If you are using one portable version of these tools, it will not be detected by this app. To solve this problem you can add a file named
external_editors.json
in app data storage directory and provide the path directly. For example:
{
"tools": {
"Visual Studio Code": "D:\\VSCode\\Code.exe"
}
}
[!NOTE] This app also supports a lot of
JetBrains
IDEs, installingJetBrains Toolbox
will help this app to find them.
Dark Theme
Light Theme
Custom
You can find custom themes from sourcegit-theme. And welcome to share your own themes.
Everyone is welcome to submit a PR. Please make sure your PR is based on the latest develop
branch and the target branch of PR is develop
.
In short, here are the commands to get started once .NET tools are installed:
dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org
dotnet restore
dotnet build
dotnet run --project src/SourceGit.csproj
Thanks to all the people who contribute.
For detailed license information, see THIRD-PARTY-LICENSES.md.
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。
1. 开源生态
2. 协作、人、软件
3. 评估模型