Skip to content

TagGen v1.2.5 "Frogmouth"

Choose a tag to compare

@shnickol shnickol released this 13 May 15:34
· 1 commit to main since this release

TagGen v1.2.5 "Frogmouth"

Highlights:

  • K-parallel POD5 routing (--pod5-parallel N CLI flag + GUI SpinButton). Bin-packed buckets across N concurrent pod5 subset processes share the OS-page-cached input. Measured 7.1× routing speedup vs v1.2.4 on a 14-sample / 92 GB nanopore run (Kaya HPC work partition, 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 in BUILD_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 subset processes (--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 subset call replaces per-sample calls (~1.3× routing speedup from setup amortisation).
  • macOS .app native 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 subset reported "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 --pod5 co-demultiplexing: switched to pod5 subset --csv mapping with positional inputs and --missing-ok.

Building from source

See README.md § Installation, BUILD_MACOS.md, and WINDOWS_BUILD.md.