mirror of
https://github.com/sourcegit-scm/sourcegit.git
synced 2024-10-31 13:03:20 -07:00
165 lines
7.4 KiB
Markdown
165 lines
7.4 KiB
Markdown
# SourceGit - Opensource Git GUI client.
|
|
|
|
[](https://github.com/sourcegit-scm/sourcegit/stargazers)
|
|
[](https://github.com/sourcegit-scm/sourcegit/forks)
|
|
[](LICENSE)
|
|
[](https://github.com/sourcegit-scm/sourcegit/releases/latest)
|
|
[](https://github.com/sourcegit-scm/sourcegit/releases)
|
|
|
|
## Highlights
|
|
|
|
* Supports Windows/macOS/Linux
|
|
* Opensource/Free
|
|
* Fast
|
|
* English/Français/Deutsch/Português/Русский/简体中文/繁體中文
|
|
* Built-in light/dark themes
|
|
* Customize theme
|
|
* Visual commit graph
|
|
* Supports SSH access with each remote
|
|
* GIT commands with GUI
|
|
* Clone/Fetch/Pull/Push...
|
|
* Merge/Rebase/Reset/Revert/Amend/Cherry-pick...
|
|
* Amend/Reword
|
|
* Interactive rebase (Basic)
|
|
* Branches
|
|
* Remotes
|
|
* Tags
|
|
* Stashes
|
|
* Submodules
|
|
* Worktrees
|
|
* Archive
|
|
* Diff
|
|
* Save as patch/apply
|
|
* File histories
|
|
* Blame
|
|
* Revision Diffs
|
|
* Branch Diff
|
|
* Image Diff - Side-By-Side/Swipe/Blend
|
|
* Search commits
|
|
* GitFlow
|
|
* Git LFS
|
|
* Issue Link
|
|
* Workspace
|
|
* Using AI to generate commit message (C# port of [anjerodev/commitollama](https://github.com/anjerodev/commitollama))
|
|
|
|
> [!WARNING]
|
|
> **Linux** only tested on **Debian 12** on both **X11** & **Wayland**.
|
|
|
|
## Translation Status
|
|
|
|
[](TRANSLATION.md) [](TRANSLATION.md) [](TRANSLATION.md) [](TRANSLATION.md) [](TRANSLATION.md) [](TRANSLATION.md) [](TRANSLATION.md)
|
|
|
|
## How to Use
|
|
|
|
**To use this tool, you need to install Git(>=2.23.0) 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.
|
|
|
|
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}/.config/SourceGit` or `${HOME}/.sourcegit` |
|
|
| macOS | `${HOME}/Library/Application Support/SourceGit` |
|
|
|
|
> [!TIP]
|
|
> You can open the app data dir from the main menu.
|
|
|
|
For **Windows** users:
|
|
|
|
* **MSYS Git is NOT supported**. Please use official [Git for Windows](https://git-scm.com/download/win) instead.
|
|
* You can install the latest stable from `winget` with follow commands:
|
|
```shell
|
|
winget install SourceGit
|
|
```
|
|
> [!NOTE]
|
|
> `winget` will install this software as a commandline tool. You need run `SourceGit` from console or `Win+R` at the first time. Then you can add it to the taskbar.
|
|
* You can install the latest stable by `scoope` with follow commands:
|
|
```shell
|
|
scoop bucket add extras
|
|
scoop install sourcegit
|
|
```
|
|
* Portable versions can be found in [Releases](https://github.com/sourcegit-scm/sourcegit/releases/latest)
|
|
|
|
For **macOS** users:
|
|
|
|
* Thanks [@ybeapps](https://github.com/ybeapps) for making `SourceGit` available on `Homebrew`. You can simply install it with following command:
|
|
```shell
|
|
brew tap ybeapps/homebrew-sourcegit
|
|
brew install --cask --no-quarantine sourcegit
|
|
```
|
|
* If you want to install `SourceGit.app` from Github Release manually, you need run following command to make sure it works:
|
|
```shell
|
|
sudo xattr -cr /Applications/SourceGit.app
|
|
```
|
|
* Make sure [git-credential-manager](https://github.com/git-ecosystem/git-credential-manager/releases) is installed on your mac.
|
|
* You can run `echo $PATH > ~/Library/Application\ Support/SourceGit/PATH` to generate a custom PATH env file to introduce `PATH` env to SourceGit.
|
|
|
|
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.
|
|
* Maybe you need to set environment variable `AVALONIA_SCREEN_SCALE_FACTORS`. See https://github.com/AvaloniaUI/Avalonia/wiki/Configuring-X11-per-monitor-DPI.
|
|
|
|
## OpenAI
|
|
|
|
This software supports using OpenAI or other AI service that has an OpenAI comaptible HTTP API to generate commit message. You need configurate the service in `Preference` window.
|
|
|
|
For `OpenAI`:
|
|
|
|
* `Server` must be `https://api.openai.com/v1/chat/completions`
|
|
|
|
For other AI service:
|
|
|
|
* The `Server` should fill in a URL equivalent to OpenAI's `https://api.openai.com/v1/chat/completions`. For example, when using `Ollama`, it should be `http://localhost:11434/v1/chat/completions` instead of `http://localhost:11434/api/generate`
|
|
* The `API Key` is optional that depends on the service
|
|
|
|
## External Tools
|
|
|
|
This app supports open repository in external tools listed in the table below.
|
|
|
|
| Tool | Windows | macOS | Linux | KEY IN `external_editors.json` |
|
|
|-------------------------------|---------|-------|-------|--------------------------------|
|
|
| Visual Studio Code | YES | YES | YES | VSCODE |
|
|
| Visual Studio Code - Insiders | YES | YES | YES | VSCODE_INSIDERS |
|
|
| VSCodium | YES | YES | YES | VSCODIUM |
|
|
| JetBrains Fleet | YES | YES | YES | FLEET |
|
|
| Sublime Text | YES | YES | YES | SUBLIME_TEXT |
|
|
| Zed | NO | YES | YES | ZED |
|
|
|
|
> [!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 dir and provide the path directly. For example:
|
|
```json
|
|
{
|
|
"tools": {
|
|
"VSCODE": "D:\\VSCode\\Code.exe"
|
|
}
|
|
}
|
|
```
|
|
|
|
> [!NOTE]
|
|
> This app also supports a lot of `JetBrains` IDEs, installing `JetBrains Toolbox` will help this app to find them.
|
|
|
|
## Screenshots
|
|
|
|
* Dark Theme
|
|
|
|
|
|
|
|
* Light Theme
|
|
|
|
|
|
|
|
* Custom
|
|
|
|
You can find custom themes from [sourcegit-theme](https://github.com/sourcegit-scm/sourcegit-theme.git). And welcome to share your own themes.
|
|
|
|
## Contributing
|
|
|
|
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`.
|
|
|
|
Thanks to all the people who contribute.
|
|
|
|
[](https://github.com/sourcegit-scm/sourcegit/graphs/contributors)
|