packages/index.html at main · PiTracLM/packages · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>PiTrac APT Repository</title>
    <style>
        body {
            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
            line-height: 1.6;
            margin: 0;
            padding: 0;
            background-color: #f5f5f5;
            color: #333;
        }
        .container {
            max-width: 1000px;
            margin: 0 auto;
            padding: 20px;
            background-color: white;
            box-shadow: 0 0 10px rgba(0,0,0,0.1);
            margin-top: 20px;
            border-radius: 8px;
        }
        h1 {
            color: #2c3e50;
            border-bottom: 3px solid #3498db;
            padding-bottom: 10px;
        }
        h2 {
            color: #34495e;
            margin-top: 30px;
        }
        .highlight {
            background-color: #ecf0f1;
            padding: 15px;
            border-left: 4px solid #3498db;
            margin: 20px 0;
            border-radius: 4px;
        }
        .code {
            background-color: #2c3e50;
            color: #ecf0f1;
            padding: 15px;
            border-radius: 4px;
            font-family: 'Courier New', monospace;
            overflow-x: auto;
            margin: 15px 0;
        }
        .warning {
            background-color: #fff3cd;
            color: #856404;
            padding: 15px;
            border: 1px solid #ffeaa7;
            border-radius: 4px;
            margin: 15px 0;
        }
        .info {
            background-color: #d1ecf1;
            color: #0c5460;
            padding: 15px;
            border: 1px solid #bee5eb;
            border-radius: 4px;
            margin: 15px 0;
        }
        table {
            width: 100%;
            border-collapse: collapse;
            margin: 20px 0;
        }
        th, td {
            padding: 12px;
            text-align: left;
            border-bottom: 1px solid #ddd;
        }
        th {
            background-color: #34495e;
            color: white;
        }
        .footer {
            text-align: center;
            margin-top: 40px;
            padding: 20px;
            background-color: #ecf0f1;
            border-radius: 4px;
        }
        .badge {
            display: inline-block;
            padding: 4px 8px;
            background-color: #3498db;
            color: white;
            border-radius: 12px;
            font-size: 0.8em;
            margin: 2px;
        }
    </style>
</head>
<body>
    <div class="container">
        <h1>PiTrac APT Repository</h1>

        <div class="highlight">
            <p><strong>Welcome to the PiTrac APT repository!</strong> This repository provides Debian packages optimized for Raspberry Pi 5 (ARM64) systems, including computer vision libraries and the PiTrac application. We support both <strong>Debian 12 (Bookworm)</strong> and <strong>Debian 13 (Trixie)</strong>.</p>
        </div>

        <h2>Available Packages</h2>
        <table>
            <thead>
                <tr>
                    <th>Package</th>
                    <th>Description</th>
                    <th>Architecture</th>
                    <th>Distributions</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td><strong>pitrac</strong></td>
                    <td>Main PiTrac application for computer vision and tracking</td>
                    <td><span class="badge">arm64</span></td>
                    <td><span class="badge">bookworm</span> <span class="badge">trixie</span></td>
                </tr>
                <tr>
                    <td><strong>libopencv4.11</strong></td>
                    <td>OpenCV 4.11.0 computer vision library (optimized build with DNN)</td>
                    <td><span class="badge">arm64</span></td>
                    <td><span class="badge">bookworm</span> <span class="badge">trixie</span></td>
                </tr>
                <tr>
                    <td><strong>liblgpio1</strong></td>
                    <td>GPIO library for Raspberry Pi (0.2.2)</td>
                    <td><span class="badge">arm64</span></td>
                    <td><span class="badge">bookworm</span> <span class="badge">trixie</span></td>
                </tr>
                <tr>
                    <td><strong>libmsgpack-cxx-dev</strong></td>
                    <td>MessagePack C++ serialization library (6.1.1 Bookworm, 7.0.0 Trixie)</td>
                    <td><span class="badge">arm64</span></td>
                    <td><span class="badge">bookworm</span> <span class="badge">trixie</span></td>
                </tr>
                <tr>
                    <td><strong>libactivemq-cpp</strong></td>
                    <td>ActiveMQ-CPP messaging library (3.9.5)</td>
                    <td><span class="badge">arm64</span></td>
                    <td><span class="badge">bookworm</span> <span class="badge">trixie</span></td>
                </tr>
                <tr>
                    <td><strong>libonnxruntime1.17.3</strong></td>
                    <td>ONNX Runtime with XNNPACK (stable, optimized for Pi5)</td>
                    <td><span class="badge">arm64</span></td>
                    <td><span class="badge">bookworm</span> <span class="badge">trixie</span></td>
                </tr>
            </tbody>
        </table>

        <h2>Quick Installation</h2>

        <div class="warning">
            <p><strong>Important:</strong> Choose the correct distribution for your Raspberry Pi. Check your version with: <code>cat /etc/debian_version</code> (12.x = Bookworm, 13.x = Trixie) or <code>lsb_release -cs</code></p>
        </div>

        <h3>For Debian 12 (Bookworm)</h3>

        <h4>Step 1: Add Repository</h4>
        <div class="code">
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
</div>

        <h4>Step 2: Add GPG Key</h4>
        <div class="code">
curl -fsSL https://pitraclm.github.io/packages/pitrac-repo.asc | sudo gpg --dearmor -o /usr/share/keyrings/pitrac.gpg
</div>

        <h4>Step 3: Update and Install</h4>
        <div class="code">
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
</div>

        <h3>For Debian 13 (Trixie)</h3>

        <h4>Step 1: Add Repository</h4>
        <div class="code">
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
</div>

        <h4>Step 2: Add GPG Key</h4>
        <div class="code">
curl -fsSL https://pitraclm.github.io/packages/pitrac-repo.asc | sudo gpg --dearmor -o /usr/share/keyrings/pitrac.gpg
</div>

        <h4>Step 3: Update and Install</h4>
        <div class="code">
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
</div>

        <h2>Manual Package Installation</h2>
        <p>You can also download and install individual packages manually:</p>
        <div class="code">
# 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
</div>

        <h2>Repository Structure</h2>
        <p>This repository follows the standard Debian repository format with multi-distribution support:</p>
        <ul>
            <li><code>dists/bookworm/</code> - Debian 12 (Bookworm) metadata and package indices</li>
            <li><code>dists/trixie/</code> - Debian 13 (Trixie) metadata and package indices</li>
            <li><code>pool/main/</code> - Package files organized by source package name (shared where appropriate)</li>
            <li><code>InRelease</code>, <code>Release</code> - Repository metadata and signatures for each distribution</li>
        </ul>

        <div class="info">
            <p><strong>Distribution Differences:</strong> 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.</p>
        </div>

        <div class="warning">
            <p><strong>Architecture Support:</strong> This repository currently supports <strong>arm64</strong> architecture only, specifically optimized for Raspberry Pi 5. Packages may not work on other architectures or older Raspberry Pi models.</p>
        </div>

        <h2>Package Information</h2>
        <p>To get detailed information about available packages:</p>
        <div class="code">
# Search for PiTrac packages
apt search pitrac

# Show package information
apt show pitrac

# List all files in a package
dpkg -L pitrac
</div>

        <h2>Troubleshooting</h2>

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

        <h3>Check Repository Status</h3>
        <div class="code">
# 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
</div>

        <h2>Documentation & Support</h2>
        <ul>
            <li><a href="https://github.com/pitraclm/packages">Repository Source Code</a></li>
            <li><a href="https://github.com/pitraclm/packages/issues">Report Issues</a></li>
            <li><a href="https://github.com/pitraclm/packages/releases">Release Notes</a></li>
        </ul>

        <h2>Build Information</h2>
        <p>Packages in this repository are automatically built and deployed using GitHub Actions. All packages are:</p>
        <ul>
            <li>Built from source with optimizations for ARM64 (Raspberry Pi 5)</li>
            <li>Built separately for Debian 12 (Bookworm) and Debian 13 (Trixie)</li>
            <li>Tested for basic installation and functionality on each distribution</li>
            <li>Signed with GPG keys for security</li>
            <li>Updated automatically when source code changes</li>
        </ul>

        <div class="info">
            <p><strong>Note on Compatibility:</strong> 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.</p>
        </div>

        <div class="info">
            <p><strong>Last Updated:</strong> This repository is continuously updated. Check the <a href="https://github.com/pitraclm/packages/actions">build status</a> for the latest information.</p>
        </div>

        <div class="footer">
            <p>
                <strong>PiTrac APT Repository</strong><br>
                Optimized packages for Raspberry Pi 5 | ARM64 Architecture<br>
                Supporting Debian 12 (Bookworm) and Debian 13 (Trixie)<br>
                <small>Generated automatically by GitHub Actions</small>
            </p>
        </div>
    </div>
</body>
</html>