Skip to content
View VirInvictus's full-sized avatar
💭
probably somewhere floating in the void
💭
probably somewhere floating in the void

Highlights

  • Pro

Block or report VirInvictus

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
VirInvictus/README.md

VIR · INVICTVS

the unconquered. ex libris Brandon LaRocque.

programmer. curator. former chef. nearly twenty years in kitchens and mining camps before The C Programming Language, read at night between shifts. now a computer engineering student with a CS degree underway. the credential follows the practice.

i build native linux desktop software for people who treat their library as worth maintaining. my focus is on rich metadata, strict organization, and local-first architectures—i try to carry librarian vibes into the codebase. rust with gtk4, c built with meson, python where the standard library reaches. it runs on your machine and answers to you.

no cloud.  no docker.  no electron.  no telemetry.  no accounts.  no vc.
your data on your disk: sqlite in WAL, single-writer worker, read-only pool, FTS5.
compile-time boundaries over code-review rules.  hard ceilings over soft benchmarks.
local-first, or it doesn't ship.

applications

  • Viaduct · a fast, local-first rss reader that treats articles as text, not web pages. An opinionated Rust port of NetNewsWire Rust · GTK4 · shipping v3.3.1
  • Conservatory · my take on a calibre for audio. music, podcasts, and audiobooks - all through libmpv. far from finished but i like it Rust · GTK4 · shipping v0.4.1

books & calibre tooling

  • CalibreQuarry · ultimately, a front-end for cquarry. A handful of auditing and organizing tools for Calibre. Python · tqdm · complete v3.19.0
  • Bindery · comprehensively audit and repair broken epubs with a lightning-fast persistent Java daemon. native calibre db integration through cquarry, lossy watermark stripping, safe HTML tag unwrapping, and content damage flagging (ocr, foreign language). epubcheck-clean. Python · tqdm · complete v0.14.0
  • Carrel · a single-user reading room for one curated calibre library. no login, metadata.db attached read-only at the connection, and calibre's own search grammar where upstream had none: author:"King" used to return 0 results, now 55. wings, a hierarchical category browser, ctrl-k over 6,975 destinations, and live statistics. code rides in a companion fork, Carrel-calibre-web. Python · CSS · shipping v0.9.2

music & audio tooling

  • Lattice · cli for music collectors. library trees, integrity checks, cover and tag audits. the filesystem is the source of truth. Python · complete v4.14.0
  • deadbeef-cui · faceted, foobar2000-columns library browser plugin for the DeaDBeeF player. C · complete v1.3.3

koreader

  • Colophon · native statistics viewer for koreader. imports a copy of statistics.sqlite3, draws its own cairo charts, ships the reading analytics nobody else has. Rust · GTK4 · shipping v2.1.1
  • Dead Reckoning · navigation-cockpit preset for koreader's bookends plugin: session pace, chapter eta, projected finish date, chapter ticks on the progress bar. Lua · complete
  • 2-kobo-style-sleepscreen-banner-prettified · koreader user patch: redraws the sleep screen as a kobo-style floating card over your cover, with a random highlight as a pull-quote. a prettified fork of zenixlabs' patch. Lua · complete
  • 1-timezone · koreader user patch: forces a correct posix timezone inside the process (setenv + tzset), fixing the clock, time sync, and autowarmth on framework-less installs where no TZ is set. Lua · complete

shared libraries

  • cquarry · a lightweight, canonical python package providing read-only access to calibre's metadata.db and a full parser for calibre's search expression grammar. powers CalibreQuarry, Hermitage, Bindery, and Carrel. Python · stdlib · complete
  • vir-search · a shared rust library for parsing calibre-style search expressions into a typed AST. used by Atrium and Conservatory. Rust · complete v1.0.1
  • vir-tui · a lightweight python library providing a robust terminal ui (curses grid menus, pagers, prompts) for CLI tools without the bloat of textual. used by CalibreQuarry and Lattice. Python · complete v1.0.0
  • vir-gtk · a shared gtk4 styling library for native linux apps, extracting the Kanagawa theme engine. Rust · GTK4 · complete v1.0.1

games & engines

  • Hearthfall · grimdark clan-survival for the terminal. seasonal turns, a fog-black map, and a finite clan split between foraging, exploring, and war. scouting reveals enemy composition, so the fun lives in the preparation rather than the swing. the engine is stdlib-only pure logic with no i/o and no rendering, driveable from a repl; every draw goes through one seeded rng, so a seed replays a run exactly. Python · Textual
  • opends · reverse-engineering toolkit for ssi's dark sun crpgs (1993–94). a disassembler and byte-exact reassembler for the games' undocumented gpl bytecode vm, plus gff/sprite/save editors. bring your own gog copy. Rust · Python

the full thirty, with screenshots and the long writeups, live in the codex → virinvictus.github.io

elsewhere

Rust · C · Python · GTK4 · SQLite · Meson, with a soft spot for Ruby.

support

if any of this is useful to you and you'd like to chip in:

Pinned Loading

  1. Lattice Lattice Public

    CLI/TUI for music collections: ~20 read-only audit/visualization modes (library trees, integrity checks, cover/metadata audit, stats, playlists), plus seven write-capable companion scripts that *do…

    Python 9

  2. Bindery Bindery Public

    High-speed EPUB repair surgeon with a persistent Java validation daemon, safe HTML unwrapping, and native Calibre integration.

    Python

  3. CalibreQuarry CalibreQuarry Public

    CLI toolkit that reads Calibre `metadata.db` directly for catalogs, stats, audits, exports, and Calibre-parity search (`search.py`, a faithful stdlib port of Calibre's expression grammar: field pre…

    Python

  4. Carrel-calibre-web Carrel-calibre-web Public

    Forked from janeczku/calibre-web

    The Carrel fork of Calibre-Web: no login and localhost-only, a trimmed feature surface, read-only reading-status badges, Wings virtual-library browsing, and metadata.db attached read-only so writes…

    Fluent

  5. Colophon Colophon Public

    Native GTK4 statistics viewer for KOReader. Imports a *copy* of `statistics.sqlite3` (staged, validated, opened read-only, never touching the live file on the device) and turns it into a wide catal…

    Rust

  6. rd-cli rd-cli Public

    Dependency-free command-line client for Raindrop.io: read, add, edit, reorganize, and remove bookmarks, collections, tags, and highlights from the terminal, with designed ANSI output (colour on a T…

    Python 1