Skip to content

JamPilot 0.1.0 — first public release

Choose a tag to compare

View all tags
@jweigend jweigend released this 13 Aug 19:44
· 41 commits to main since this release
v0.1.0
347aafc

The first public release of JamPilot.

Play any song on your computer — Spotify, YouTube, an MP3 — and JamPilot shows
you the chords before you hear them: it delays your system audio by a few
seconds, analyses the fresh signal in that window, and puts the coming chords
on a timeline that every phone and tablet in the room can join with one QR
scan.

▶ 60-second demo

What's in 0.1.0

  • Live chord detection from system audio — a learned recogniser (BTC
    transformer, ported to pure NumPy), 14 chord qualities × 12 roots, boundaries
    pulled onto the audible attack
  • The lead: the delayed playback is the feature — you see every chord
    seconds before it sounds, with a countdown
  • Band sync via QR code: one computer listens, every device on the Wi-Fi is
    a display — no app, no account
  • Instrument views, per device: plain chords, measured bass (C/E) with a
    four-string neck diagram, guitar fretboard shapes, and a keyboard view with
    look-ahead voicings that keep your hand in place
  • Key detection and spelling (♯/♭ chosen to match the key, or forced)
  • Automatic audio routing on Linux (PipeWire/PulseAudio) and Windows
    (driver-free in the common case) — transactional, restored on exit, with
    jampilot cleanup for hard kills; macOS runs via BlackHole
  • One-script setup: ./run.sh / run.cmd builds and repairs the
    environment itself; standalone binary via --bundle
  • 419 tests, reproducible builds

Platforms

Linux is fully tested (the reference platform); macOS and Windows run but have
not had long musical sessions yet — details in the
README.

Get it

git clone https://github.com/jweigend/JamPilot.git && cd JamPilot
./run.sh        # Windows: run.cmd

Feedback wanted

This is an early release, and honest feedback from people who actually rehearse
is worth more than anything else right now: what would make this useful in
your practice room? →
Discussions

More on how it works: HOW-IT-WORKS.md ·
UNDER-THE-HOOD.md

Downloads

Standalone binaries, no Python needed (~200 MB — why):

File Platform SHA-256
jampilot-0.1.0-linux-x86_64.tar.gz Linux x86_64 (glibc ≥ Ubuntu 22.04) 2da038ff…ad9ee2c0
jampilot-0.1.0-macos-arm64.tar.gz macOS Apple Silicon (binary + JamPilot.app) dca4261b…6077a0f4

Linux: needs libportaudio2 and PipeWire/PulseAudio. macOS: needs
BlackHole 2ch; the binaries are
unsigned, so clear the quarantine flag once:
xattr -dr com.apple.quarantine jampilot JamPilot.app.
There is no Intel-macOS or Windows binary: Intel Macs and Windows install
from source (./run.sh / run.cmd is the whole setup).

Assets 4
Loading