PiTrac APT Repository

Welcome to the PiTrac APT repository! This repository provides Debian packages optimized for Raspberry Pi 5 (ARM64) systems, including computer vision libraries and the PiTrac application. We support both Debian 12 (Bookworm) and Debian 13 (Trixie).

Available Packages

Package	Description	Architecture	Distributions
pitrac	Main PiTrac application for computer vision and tracking	arm64	bookworm trixie
libopencv4.11	OpenCV 4.11.0 computer vision library (optimized build with DNN)	arm64	bookworm trixie
liblgpio1	GPIO library for Raspberry Pi (0.2.2)	arm64	bookworm trixie
libmsgpack-cxx-dev	MessagePack C++ serialization library (6.1.1 Bookworm, 7.0.0 Trixie)	arm64	bookworm trixie
libactivemq-cpp	ActiveMQ-CPP messaging library (3.9.5)	arm64	bookworm trixie
libonnxruntime1.17.3	ONNX Runtime with XNNPACK (stable, optimized for Pi5)	arm64	bookworm trixie

Quick Installation

Important: Choose the correct distribution for your Raspberry Pi. Check your version with: cat /etc/debian_version (12.x = Bookworm, 13.x = Trixie) or lsb_release -cs

For Debian 12 (Bookworm)

Step 1: Add Repository

echo 'deb [arch=arm64 signed-by=/usr/share/keyrings/pitrac.gpg] https://pitraclm.github.io/packages bookworm main' | sudo tee /etc/apt/sources.list.d/pitrac.list

Step 2: Add GPG Key

curl -fsSL https://pitraclm.github.io/packages/pitrac-repo.asc | sudo gpg --dearmor -o /usr/share/keyrings/pitrac.gpg

Step 3: Update and Install

sudo apt update sudo apt install pitrac # Or install specific packages sudo apt install libopencv4.11 liblgpio1 libmsgpack-cxx-dev sudo apt install libonnxruntime1.17.3 # ONNX Runtime for Bookworm

For Debian 13 (Trixie)

Step 1: Add Repository

echo 'deb [arch=arm64 signed-by=/usr/share/keyrings/pitrac.gpg] https://pitraclm.github.io/packages trixie main' | sudo tee /etc/apt/sources.list.d/pitrac.list

Step 2: Add GPG Key

curl -fsSL https://pitraclm.github.io/packages/pitrac-repo.asc | sudo gpg --dearmor -o /usr/share/keyrings/pitrac.gpg

Step 3: Update and Install

sudo apt update sudo apt install pitrac # Or install specific packages sudo apt install libopencv4.11 liblgpio1 libmsgpack-cxx-dev sudo apt install libonnxruntime1.17.3

Manual Package Installation

You can also download and install individual packages manually:

# Download a specific package wget https://pitraclm.github.io/packages/pool/main/p/pitrac/pitrac_latest_arm64.deb # Install manually sudo dpkg -i pitrac_latest_arm64.deb sudo apt-get install -f # Fix any missing dependencies

Repository Structure

This repository follows the standard Debian repository format with multi-distribution support:

dists/bookworm/ - Debian 12 (Bookworm) metadata and package indices
dists/trixie/ - Debian 13 (Trixie) metadata and package indices
pool/main/ - Package files organized by source package name (shared where appropriate)
InRelease, Release - Repository metadata and signatures for each distribution

Distribution Differences: Most packages are identical across distributions. Both use ONNX Runtime 1.17.3 (1.22.x has Pi5 performance issues). Trixie uses msgpack 7.0.0, Bookworm uses 6.1.1.

Architecture Support: This repository currently supports arm64 architecture only, specifically optimized for Raspberry Pi 5. Packages may not work on other architectures or older Raspberry Pi models.

Package Information

To get detailed information about available packages:

# Search for PiTrac packages apt search pitrac # Show package information apt show pitrac # List all files in a package dpkg -L pitrac

Troubleshooting

Common Issues

GPG Key Errors: Make sure you've added the repository GPG key
Architecture Mismatch: Ensure you're running on a 64-bit ARM system (Raspberry Pi 5)
Dependency Issues: Run sudo apt-get install -f to fix broken dependencies

Check Repository Status

# Verify repository is accessible (Bookworm) curl -I https://pitraclm.github.io/packages/dists/bookworm/Release # Verify repository is accessible (Trixie) curl -I https://pitraclm.github.io/packages/dists/trixie/Release # Check package cache apt-cache policy pitrac # Verify you're using the correct distribution cat /etc/apt/sources.list.d/pitrac.list

Documentation & Support

Build Information

Packages in this repository are automatically built and deployed using GitHub Actions. All packages are:

Built from source with optimizations for ARM64 (Raspberry Pi 5)
Built separately for Debian 12 (Bookworm) and Debian 13 (Trixie)
Tested for basic installation and functionality on each distribution
Signed with GPG keys for security
Updated automatically when source code changes

Note on Compatibility: Due to binary ABI changes between Debian versions (especially the 64-bit time_t transition in Trixie), packages must be rebuilt for each distribution. Always use the packages matching your Debian version.

Last Updated: This repository is continuously updated. Check the build status for the latest information.