Kirill's homepage

Course Shelf

Mon, 01 Jan 0001 00:00:00 +0000

What it’s for

Courses from Udemy and Coursera, conference and workshop recordings often sit on disk as plain folders. Course Shelf scans such a folder and builds a catalogue of courses, sections and lessons. The catalogue opens in the browser and in the mobile app. The files stay where they are: Course Shelf neither copies nor transcodes them.

Library

Catalogue from the folder tree. Folders and file names define courses, sections and lesson order. The scan attaches subtitles and materials that sit next to each video.
course.json for fine control. A file in the course folder sets titles, lesson order and metadata on top of what the scan inferred.
Metadata from the web. Scrapers fetch covers, descriptions, instructors and tags from Udemy, Coursera and YouTube. Other sites work through declarative scraper definitions and a generic schema.org and OpenGraph parser.
Single-course rescan. One course updates without a pass over the whole library.

Watching

Streaming without transcoding. Video goes over HTTP with byte ranges, so seeking responds at once.
Progress. The player remembers the position, resumes from it and rolls into the next lesson. Past 90% a lesson counts as complete.
Home shows lessons in progress, recent additions, finished courses and the week’s watch time.
Browse with filters by status, library, length and instructor. Filters live in the URL, so a link reopens the same shelf.
Notes and bookmarks. Each lesson takes a Markdown note and bookmarks at any second. Notes are visible to their author only.

Transcripts and search

Local transcription. whisper.cpp transcribes lessons without subtitles on the same server, with no cloud API.
Search finds courses and individual lessons in one query and shows the matching snippet. On desktop it opens as a command palette.
Transcript next to the player. A ?t= link opens a lesson at the right second.
Quizzes. An LLM writes questions for a lesson: local llama.cpp or a model through OpenRouter.

Mobile app

Flutter client for iOS and Android with the same catalogue.
Downloads. Lessons download with resume after a dropped connection and stay encrypted on the device.
Offline. Position, notes and bookmarks save on the device and sync when the connection returns. If the server holds newer progress, the server’s version stands.

Multiple users

Explicit access. USER and ADMIN roles, with access granted per library or per course.
Administration. Instance overview, user management, and signing in as a user to see their catalogue.
Backups. One button runs pg_dump and returns a link to the archive. Media files stay out of it: Course Shelf doesn’t own them.

Under the hood

A monorepo of three apps: a NestJS backend, a Nuxt web client and a Flutter client. The API is described once, in OpenAPI 3.1 and AsyncAPI 3.0, and the TypeScript and Dart clients are generated from it. The backend rejects requests the spec doesn’t describe, and CI fails when code drifts from the contract. Scan and job events reach the clients through Centrifugo. The interface ships in English and Russian.

Coriolis Companion

Mon, 01 Jan 0001 00:00:00 +0000

What it’s for

Coriolis: The Third Horizon is a science-fiction RPG from Free League with an Arabian Nights flavour. The app replaces paper sheets and keeps the table in one shared state: every member of a session sees the same rolls, Darkness Points and chat. A fan project, not affiliated with the publisher.

For players

Character sheet true to the Coriolis rules: icons, concept, upbringing, attributes from 1 to 5, general and advanced skills, talents, gear, conditions, encumbrance, critical injuries.
Dice. A D6 pool with pushed rolls: sixes are successes, and ones on a push hand the GM Darkness Points.
Public share link to a read-only sheet, with a separate toggle for GM notes. The link can be revoked.
JSON export of sheets, ships and history.
Offline. Reading works everywhere. The web client queues edits in a ServiceWorker, the mobile app in a Hive cache, and both queues sync when the connection returns.

For game masters

Ship sheets: 20 ship classes, modules, crew positions, hull, energy, signature, armor, problems.
Game sessions: a single invite link, member roles, an archive and a Darkness Point tracker with history.
NPCs and encounters: pre-generated and custom NPCs, an encounter builder with initiative, rounds and turns.
A real-time table. Rolls, Darkness Points and chat reach every member through Centrifugo. Chat covers session-wide messages, private whispers, blocking and system messages.

Under the hood

Three clients on one backend: a Nuxt SPA, a Flutter app for iOS and Android and a NestJS backend with Postgres, Redis and Centrifugo. The API is described in OpenAPI and AsyncAPI, the TypeScript and Dart clients are generated from the spec, and CI fails on drift. The interface ships in English, Russian, Ukrainian and Greek, with key parity checked in CI. Telemetry flows through OpenTelemetry into Grafana, errors into Sentry.

burkmak

Mon, 01 Jan 0001 00:00:00 +0000

What it’s for

Articles saved for later get lost across tabs and bookmarks. burkmak gathers them into one library on your own server, extracts the text without ads and sends it to a Kobo e-reader with no firmware hacks. Highlights and notes go to Obsidian.

Saving

From anywhere. Save a link from the web app, the mobile app, the Android share sheet or a browser bookmarklet.
Metadata in the background. Title, site, excerpt and lead image appear without a page reload, over SSE.
Text right away. Extraction runs on save, so the reader, OPDS and Kobo get the article ready to read.
Organising. Tags, read states (unread, read, archived) and favourites. Every user has a separate library.

Reading

Readability-based reader. The article without ads or clutter. The copy stays even if the original disappears.
Images are cached on your own server.
Full-text search across title, URL and article body on SQLite FTS5.
Highlights in colour, with notes attached.
Light and dark themes.

Kobo

OPDS catalogue with covers, pagination and search. Articles download as EPUB and KEPUB, and a stock Kobo adds the catalogue from its settings.
Native sync over the Kobo store protocol. The e-reader pulls new articles when it connects, and reading state flows back: an article finished on the Kobo turns read in burkmak, and one archived in the app leaves the device. HTTPS is required. The protocol passes a full simulation; the pass on a physical device is still ahead.

Obsidian

Markdown export. The API returns an article as a note with its source, metadata, highlights and notes. A repeat export updates the same note.
Obsidian plugin syncs the export into your vault.

Under the hood

A NestJS backend on SQLite, a Nuxt web client and a Flutter mobile client. A worker on top of the database runs background jobs and events reach clients over SSE, so there are no external services: the local stack is two containers. The API is described in OpenAPI, and the TypeScript and Dart clients are generated from the spec.

todoer

Mon, 01 Jan 0001 00:00:00 +0000

What it’s for

Personal tasks, projects, priorities and tags in the spirit of Todoist and Things, on your own server. The defining requirement is offline: every client holds a full replica and answers “what’s on today” without a network.

What works

Sync. One endpoint, POST /api/v1/sync, takes operations and returns changes. Conflicts resolve per field, last write wins. Tombstones get pruned, and a client with a stale cursor receives a fresh snapshot.
CLI. todoer add, list and outbox work against a local SQLite replica. Each operation enters a queue first and keeps its id across retries, so running add twice doesn’t create a duplicate.
For scripts and agents. --json output and exit codes you can branch on: exit code 5 means the server was unreachable and the operation waits in the queue.

Planned

Projects and tags from quick-add, recurring tasks.
Views: list, kanban, calendar.
The web client and the Flutter app.
A habit tracker in version two.

Under the hood

NestJS 11, Prisma and Postgres 18. There is no REST CRUD: every write goes through the sync protocol. The contract lives in OpenAPI, and express-openapi-validator enforces it in both directions. The repository started from the project-skeleton template.

Split Monkey

Mon, 01 Jan 0001 00:00:00 +0000

What it’s for

Trainers like monkeytype measure speed and accuracy, but they don’t know which keyboard you type on. After a move to a split board that isn’t enough: you need to see the imbalance between hands, the slow fingers and what layers cost you. Split Monkey knows the physical layout and the keymap of the keyboard and breaks the stats down along them. The target hardware is a Lily58 running QMK configured through Vial.

Shipyard

Mon, 01 Jan 0001 00:00:00 +0000

What it’s for

The rules a project follows when agents write code tend to get copied from repository to repository and drift apart. Shipyard splits them into two pieces: a Claude Code plugin with skills and a repository template with the process files. A fix to a skill reaches every project through /plugin update.

The shipyard plugin

Six skills, each firing at its own moment:

task-stack keeps the task stack: before any task bigger than a one-line fix, when a task blocks and when one ships.
lane-discipline keeps parallel agents from colliding.
ci-gates tells a green pull request from one that only looks green and finds required checks that never ran.
issue-bookkeeping reconciles the issue tracker with what reached main.
deploy-verify puts a release on a host and checks which version the host runs.
release-audit audits the product before a release.

The /bootstrap command sets up a fresh repository from the template once: it fills the placeholders, writes the first ADR and opens the first task.