Projectumby wleeaf github.com/wleeaf/projectum ↗

Every project, in one window.

The things that pile up around a folder of work — the projects, the study playlists, the loose todos, the notes — tracked in one fast desktop app, and connected to each other. Your data is a .projectum.json sitting next to your work.

$pip install projectumCOPY
Download for Linux All downloads

also: windows .exe · macos .dmg · source — free & MIT, keeps itself updated

Projectum's projects view in the dark theme: a sidebar of tagged projects and a detail panel with live Markdown notes
✓ no servers ✓ no account ✓ no telemetry ✓ one JSON file, atomic writes ✓ MIT licensed
// the folder is the truth

Point it at a folder. Done.

Every subfolder becomes a project — with its size, last-modified time, and git branch read live off a background thread. Mark things done or tested, tag and pin them, write notes in Markdown that renders as you type.

  • syntax markers hide until your cursor enters the phrase
  • command palette over everything — Ctrl+K
  • open in your editor, terminal, or file manager
The Notes tab in the Paper light theme, showing a live-rendered Markdown checklist
The calendar in the Midnight theme: project and playlist spans drawn as bars across June
// relations

Link anything to anything.

A project to a playlist. A todo to next Tuesday. A note to a span of days. Links are undirected and untyped — just "these are related," the way you actually keep track of work — and the calendar is where the date side of the graph comes together.

// learn alongside

Playlists are projects too.

Paste a YouTube playlist URL and Projectum pulls titles and durations with yt-dlp. Tick videos off as you watch, keep per-video notes, refresh without losing your state — and schedule the whole thing on the calendar.

A study playlist in the Light theme with per-video watched state and durations
// your data, literally yours

The database is a file next to your work.

Per-folder state lives in .projectum.json inside the folder itself — commit it with your code or ignore it. Writes are atomic, so an interrupted save can't corrupt anything. Rename a folder and its metadata waits, then comes back.

0 servers, accounts, sign-ins
0 analytics, crash reporters, phone-homes
1 read-only GitHub call to check for updates — and a toggle for it
// <your-folder>/.projectum.json
{
  "projects": [{
    "name": "aurora-engine",
    "tags": ["rust", "core"],
    "completed": false,
    "notes": "# Aurora\n\nRendering core…"
  }],
  "todos": […],
  "playlists": […],
  "note_docs": […]
}
// 19 themes, every one readable

Dark, light, and everything between.

Catppuccin, Nord, Gruvbox, Solarized, Rosé Pine, Tokyo Night — plus a few originals. Every theme is checked in CI against WCAG contrast floors, so muted text never disappears into the background. Switching crossfades.

The Todo tab in the Gruvbox theme
The Projects tab in the default dark theme
// free forever

Your work, organized in a minute.

$pip install projectumCOPY
Download ♥ Sponsor