Linux Packaging

Location: docs/packaging/os-specific/linux/
Platforms: Nix, Flatpak, distribution packages Latest Version: 0.0.5-1


Overview

ProjT Launcher supports multiple Linux packaging formats to reach different user bases and distribution requirements.


Packaging Formats

Nix / NixOS

The recommended method for reproducible builds.

Location: nix/, flake.nix

# Build
nix build .#projtlauncher

# Run without installing
nix run .#projtlauncher

# Development shell
nix develop

See nix.md for detailed instructions.

Flatpak

Sandboxed application format.

Location: docs/packaging/os-specific/linux/flathub/

The Flatpak manifest is maintained separately for Flathub submission.

Distribution Packages

ProjT Launcher is packaged for various distributions:

Distribution Package Status
Arch Linux (AUR) projtlauncher Community
Fedora COPR projtlauncher Community
openSUSE OBS projtlauncher Community

Check Repology for current availability.


Building for Distribution

Requirements

  • CMake 3.22+
  • Qt 6.x
  • C++20 compiler
  • Ninja (recommended)

Build Commands

cmake -B build \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_INSTALL_PREFIX=/usr \
  -DLauncher_BUILD_PLATFORM=linux
cmake --build build
DESTDIR="$pkgdir" cmake --install build

Platform Identifier

Set Launcher_BUILD_PLATFORM to identify your distribution:

-DLauncher_BUILD_PLATFORM=archlinux
-DLauncher_BUILD_PLATFORM=fedora
-DLauncher_BUILD_PLATFORM=flatpak

Desktop Integration

Desktop File

Installed to /usr/share/applications/:

org.projecttick.ProjTLauncher.desktop

Icon

Installed to /usr/share/icons/hicolor/:

org.projecttick.ProjTLauncher.svg

AppStream Metadata

Installed to /usr/share/metainfo/:

org.projecttick.ProjTLauncher.metainfo.xml

Related Documentation

Was this handbook page helpful?

Last updated: February 19, 2026 Edit on GitHub