Understand your Git history!
Go to file
2023-02-17 13:40:25 +01:00
.github Update build.yml 2023-01-25 09:50:48 +01:00
cmake non environment text must be only once in otherwise the flatpak appdata test will fail. So make the description to be and add paragraphs to the others 2022-06-09 10:27:16 +02:00
conf colorize badges 2023-01-23 11:11:44 +01:00
dep * Fix local installation paths on Linux, see issue #393 2023-01-23 22:28:15 +01:00
docs Update changelog.md 2023-01-27 13:37:43 +01:00
flatpak-builder Use customized flatpak builder Docker image 2022-12-16 07:35:48 +01:00
l10n fix translation install directory 2023-02-17 13:40:18 +01:00
pack install icons with appropriate name 2023-02-17 13:40:25 +01:00
rsrc Merge pull request #253 from Murmele/changeStartupWMClass 2023-01-22 11:19:27 +01:00
src set correct path for the executable 2023-02-17 13:40:25 +01:00
test Merge pull request #347 from H-4ND-H/credential-store 2023-01-30 09:15:32 +01:00
.clang-format add code formatting 2022-05-01 09:19:07 +02:00
.gitignore add ignore 2020-11-19 19:11:35 +01:00
.gitmodules change url of lexilla 2022-05-01 11:15:33 +02:00
cl-fmt.sh Fix formatting and formatting scripts 2022-10-16 17:35:23 +02:00
cmake-format.json Fix formatting and formatting scripts 2022-10-16 17:35:23 +02:00
CMakeLists.txt WIP 2023-01-25 09:48:27 +01:00
LICENSE.md let LICENSE.md also be in the source dir, so we have always one valid there 2023-01-23 11:37:30 +01:00
LICENSE.md.in update copyright and license year automatically 2023-01-23 09:50:50 +01:00
README.md use development tag instead of latest, because it might lead to confusion 2022-11-10 08:36:34 +01:00

Gittyup Status Matrix Donate Liberapay

Download Gittyup on Flathub

Gittyup

Gittyup is a graphical Git client designed to help you understand and manage your source code history. The latest stable release is available either as pre-built flatpak for Linux, 32 / 64 binary for Windows, macOS, or can be built from source by following the directions below.

The latest development version is available pre-built as well.

Gittyup is a continuation of the GitAhead client.

Gittyup

Table of contents

Features

To get an overview of the current features please have a look at the GitHub Page

How to Get Help

Ask questions about building or using Gittyup on Stack Overflow by including the gittyup tag. Remember to search for existing questions before creating a new one.

Report bugs in Gittyup by opening an issue in the issue tracker. Remember to search for existing issues before creating a new one.

If you still need help, check out our Matrix channel Gittyup:matrix.org.

Build Environment

  • C++11 compiler
    • Windows - MSVC >= 2017 recommended
    • Linux - GCC >= 6.2 recommended
    • macOS - Xcode >= 10.1 recommended
  • CMake >= 3.3.1
  • Ninja (optional)

Dependencies

External dependencies can be satisfied by system libraries or installed separately. Included dependencies are submodules of this repository. Some submodules are optional or may also be satisfied by system libraries.

External Dependencies

  • Qt (required >= 5.12)

Included Dependencies

  • libgit2 (required)
  • cmark (required)
  • git (only needed for the credential helpers)
  • libssh2 (needed by libgit2 for SSH support)
  • openssl (needed by libssh2 and libgit2 on some platforms)

Note that building OpenSSL on Windows requires Perl and NASM.

How to Build

Initialize Submodules

git submodule init
git submodule update

Build OpenSSL

# Start from root of gittyup repo.
cd dep/openssl/openssl

Windows:

perl Configure VC-WIN64A
nmake

macOS (Intel):

./Configure darwin64-x86_64-cc no-shared
make

macOS (Apple Silicon)

./Configure darwin64-arm64-cc no-shared
make

Linux:

./config -fPIC
make

Configure Build

# Start from root of gittyup repo.
mkdir -p build/release
cd build/release
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ../..

If you have Qt installed in a non-standard location, you may have to specify the path to Qt by passing -DCMAKE_PREFIX_PATH=<path-to-qt> where <path-to-qt> points to the Qt install directory that contains bin, lib, etc.

Build

ninja

How to Install

Linux

The easiest way to install Gittyup is by using Flatpak.

Arch Linux

Install the gittyup package from the Arch User Repository.

git clone https://aur.archlinux.org/gittyup.git
cd gittyup
makepkg -si

Or use an AUR helper. Install gittyup-git for the VCS build.

Mac OS

Homebrew

Install the gittyup cask from Homebrew.

brew install gittyup

Flatpak from terminal

If you want a more pure console use, this script run flatpak version disowning the process and silence the output pushing it to /dev/null. Just save the script somewhere in your path, for example /usr/bin (or ~/.local/bin if you have exported it), give execution permissions chmod +x, and run gittyup from your terminal.

#!/bin/bash
DIR=$(dirname "${BASH_SOURCE[0]}")
function run_disown() {
    "$@" & disown
}
function run_disown_silence(){
    run_disown "$@" 1>/dev/null 2>/dev/null
}
run_disown_silence flatpak run com.github.Murmele.Gittyup

How to Contribute

We welcome contributions of all kinds, including bug fixes, new features, documentation and translations. By contributing, you agree to release your contributions under the terms of the license.

Contribute by following the typical GitHub workflow for pull requests. Fork the repository and make changes on a new named branch. Create pull requests against the master branch. Follow the seven guidelines to writing a great commit message.

License

Gittyup and its predecessor GitAhead are licensed under the MIT license. See LICENSE.md for details.