Perun

Perun

What it does: Privacy-first run tracker, rebuilt on the Logos stack as an Android app and a Basecamp module

Stage: Full Release

Licence: MIT or Apache-2.0 (licence files in the repository)

Build · Use · Code · User reviews

Verified on 4 November 2026 against README and commit of 11 October 2026.

Perun is a privacy-first run tracker with an Android app that sends runs over Logos Messaging (Logos Delivery) to a Basecamp module on the desktop. It is published by the GitHub user vpavlin.

What it does

• Records runs on an Android phone with GPS, also in the background, and shows them on the phone.
• Sends a run to the user's Basecamp with "Sync to Basecamp" over Logos Delivery. The app uses the phone's shared Loam node when it is installed, and otherwise runs its own node.
• Receives runs in perun_core, the Basecamp core module, which decodes the track, computes splits, elevation, pace and heart rate, and stores them in SQLite.
• Shows the runs in Perun Analytics (perun_analytics), the desktop Basecamp view.
• Can run perun_core headless as an always-on hub.
• Uses a shared wire contract with a compact track codec, so that a normal run fits in one 150 KB Delivery message.
• Keeps the blockchain out of scope for now. Logos Storage is an optional backup and is not on the sync path.

Stage: Full Release. The README says "the Android app and the Basecamp core + view are released", and adds that "the desktop is Linux x64 only for now". The original React web app now lives in a separate repository, vpavlin/perun-legacy. The README does not say whether it is an official Logos project.

Use it

1. Android: add the F-Droid repository from apps.vpavlin.xyz and install Perun. The README recommends installing Loam as well. It runs on arm64 phones.
2. Desktop: this needs Basecamp 0.3 on Linux x64. Add https://apps.vpavlin.xyz/logos-repo.json in Basecamp's package manager, then install Perun Analytics. It pulls in perun_core.
3. Instead of the repository, a portable .lgx from a GitHub Release can be installed with lgpm install URL --to ./modules, where URL is the release file.

Build it

• nix build ./module#lgx-portable builds a portable bundle. The README says to always build the portable variant, not .#lgx.
• Pushing a module-v* tag makes CI build the perun_analytics portable .lgx for linux-amd64 and attach it to a GitHub Release.
• After a release, scripts/gen-repo-index.sh vX.Y.Z refreshes repo/index.json, which is then committed.

Releases

The latest tags are module-v0.6.0 and mobile-v1.12.0, both dated 16 July 2026. module/metadata.json gives perun_analytics version 0.9.0, and core/metadata.json gives perun_core version 0.10.4.

See also

• Basecamp
• Tools
• Logos Messaging
• KYM

Sources

• perun README, GitHub, last commit 11 October 2026
• module/metadata.json and core/metadata.json, GitHub
• perun tags, GitHub

Page status: Stub. Stub · Outline · Usable · Guide · Star. Anyone can improve this page and change its status.