TagGen v1.2.5 "Frogmouth"
TagGen v1.2.5 "Frogmouth"
Highlights:
- K-parallel POD5 routing (
--pod5-parallel NCLI flag + GUI SpinButton). Bin-packed buckets across N concurrentpod5 subsetprocesses share the OS-page-cached input. Measured 7.1× routing speedup vs v1.2.4 on a 14-sample / 92 GB nanopore run (Kaya HPCworkpartition, 16 CPUs / 32 GB, K=8). Total wall-time 3065 s → 1127 s (2.7×). - macOS support (Apple Silicon arm64). Drag-to-Applications
.dmg, relocatable bundle, and full build documentation inBUILD_MACOS.md. macOS Tahoe (>=15) Gatekeeper compatible via native Mach-O launcher (installer/applauncher.c). - Windows distribution now ships a self-contained portable ZIP (
taggen-v1.2.5-windows-x86_64.zip) with ~70 bundled GTK3 DLLs + themes + icon loaders. No system-wide install needed. - Linux build uses
release-static(LDC 1.42, statically-linked phobos/druntime); only system glibc + GTK3 needed at runtime.
This release rolls up four patch versions (1.2.2 → 1.2.5). See CHANGELOG.md for full details. Key fixes between 1.2.1 and 1.2.5 include the POD5 routing bug against modern dorado FASTQ output (Found 0 read_ids — fixed in v1.2.3 by splitting read id on any whitespace including TAB).
Downloads
| Platform | File | Notes |
|---|---|---|
| Linux x86_64 | taggen-linux-x86_64 |
chmod +x and run. Needs GTK3 runtime for GUI: sudo apt install libgtk-3-0 / sudo pacman -S gtk3. |
| Windows x86_64 | taggen-v1.2.5-windows-x86_64.zip |
Extract anywhere → taggen-windows/taggen.exe. Bundled GTK3 DLLs, no system install required. |
| macOS arm64 (Apple Silicon) | TagGen-1.2.5-macos-arm64.dmg |
Drag TagGen.app to Applications. First launch: right-click → Open (ad-hoc signed, not Apple-notarised). |
POD5 co-demultiplexing additionally requires the pod5 Python CLI: pip install pod5.
SHA-256
5be1a78f14836fc2d2b271ce4401aaf44d97b86100ddbad28756e02b7de83ef4 taggen-linux-x86_64
2ca593f60b15a722ddc183785ce6013b10e823e92a0c856864133bc5d9e964e3 taggen-v1.2.5-windows-x86_64.zip
a673424b4234e8560d3f04d833dd2a12e5414d16f3d7d2b4f0008f122b47e201 TagGen-1.2.5-macos-arm64.dmg
Changelog (recent patches)
v1.2.5 "Frogmouth" (2026-05-13)
- POD5 routing fans out across K concurrent
pod5 subsetprocesses (--pod5-parallel N). Bin-packed (LPT heuristic) so buckets finish at roughly the same wall time. Measured 7.1× routing speedup vs 1.2.4.
v1.2.4 "Emu" (2026-05-13)
- Single combined
pod5 subsetcall replaces per-sample calls (~1.3× routing speedup from setup amortisation). - macOS
.appnative Mach-O launcher (fixes Tahoe Gatekeeper_LSOpenURLsWithCompletionHandler() error -10669). - TagGen confirmed LDC 1.42+ compatible.
v1.2.3 "Dingo" (2026-05-13)
- FASTQ parser fix: read IDs now split on any whitespace (TAB or space). Modern dorado uses SAM-style TAB-separated aux tags; v1.2.1/1.2.2 captured the entire TSV header line as the read id, breaking POD5 routing (
pod5 subsetreported "Found 0 read_ids"). Closed the cluster-side regression that affected all dorado-basecalled inputs.
v1.2.2 "Cassowary" (2026-05-13)
- Defensive POD5 read-id normalisation (lowercase + strip
read_prefix) for non-dorado pipelines that emit uppercase or prefixed UUIDs. - Failed-routing CSV preservation via
TAGGEN_DEBUG_POD5=1.
v1.2.1 "Bilby" (2026-05-07)
- Fixed
--pod5co-demultiplexing: switched topod5 subset --csvmapping with positional inputs and--missing-ok.
Building from source
See README.md § Installation, BUILD_MACOS.md, and WINDOWS_BUILD.md.