Skip to content

smolBlackCat/progress-tracker

Repository files navigation

progress-logo Progress

Simple Kanban board manager

GitHub Release Flathub Downloads GitHub License Build Status

App Windows

Progress is a Kanban board management app designed to be simple yet flexible for most workflows. Whether you're managing software projects or organsing daily tasks, Progress keeps things straightforward. Built with C++ with GTK4 and LibAdwaita.

Dependencies

  • gtkmm-4 (>= 4.10.0)
  • libadwaita1 (>= 1.5)
  • tinyxml2 (>= 10.0.0)
  • spdlog (>= 1.12)
  • crossguid (built-in)

Installation

Flatpak

flathub-badge

flatpak install flathub io.github.smolblackcat.Progress

Debian-based

Progress is available for installation on Debian/Ubuntu based systems. Note that the package is built on Ubuntu 24.04 and might not work on every Debian-based system. For instance, this package may or may not work on Debian Stable.

Arch Linux (AUR)

Progress is available on the AUR (Arch User Repository). You can install it using the yay command-line application:

yay -S progress-tracker

Windows

For Windows systems, Progress is available as a standard Windows installer executable or as a compressed file containing the application's binary and its dependencies. These builds target 64-bit systems, so make sure the host operating system is also 64-bit.

Building From Source

Alternative for those who want to contribute to the project somehow or want a custom build. Ensure all dependencies are installed beforehand and verify whether the system's C++ compiler is C++20 compliant.

Linux

  1. Install the dependencies

    # Catch2 is not necessary if you're not going to build tests
    sudo apt install cmake libgtkmm-4.0-dev libadwaita-1-dev libtinyxml2-dev \
     libspdlog-dev gettext catch2
  2. Clone the project's repository

    git clone https://github.com/smolBlackCat/progress-tracker.git --recursive
  3. Configure and compile the project.

    cd progress-tracker/
    
    cmake -S . -B build/ -DCMAKE_INSTALL_PREFIX=/usr -DDEVELOPMENT=OFF
    cmake --build build/
  4. Install the project

    # There's no need for sudo if you set to a local install prefix
    # (e.g. ~/.local/)
    sudo ninja install -C build/
    sudo glib-compile-schemas /usr/share/glib-2.0/schemas/

Windows

MSYS2 is a build platform utilised by the project for porting Progress to Windows operating systems. Ensure that the platform is installed before proceeding.

  1. Install the dependencies

    # This snippet assumes you're running on the UCRT64 environment
    pacman -Syu mingw-w64-ucrt-x86_64-cmake mingw-w64-ucrt-x86_64-python mingw-w64-ucrt-x86_64-gtkmm-4.0 mingw-w64-ucrt-x86_64-libadwaita mingw-w64-ucrt-x86_64-tinyxml2 mingw-w64-ucrt-x86_64-gettext mingw-w64-ucrt-x86_64-catch mingw-w64-ucrt-x86_64-spdlog mingw-w64-ucrt-x86_64-nsis git
  2. Clone the project's repository

    git clone https://github.com/smolBlackCat/progress-tracker.git --recursive
  3. Configure and compile project

    cd progress-tracker/
    cmake -S . -B build/ -DDEVELOPMENT=OFF
    cmake --build build/
  4. Build the Progress installer and ZIP file

    cd build/
    
    # Builds a Windows installer executable
    cpack

Consider Supporting the Project

ko-fi