Projectum · a wleeaf product
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.
Also for Windows (.exe) and macOS (.dmg) · source code · free, MIT, keeps itself updated
In short
What Projectum is.
Projectum is a free, open-source desktop app that keeps the projects, YouTube study playlists, todos and notes around a folder of work in one window, linked to each other.
Point it at a folder and every subfolder becomes a project. It runs on Linux, Windows and macOS, needs no account or server, and stores its data in a plain .projectum.json file inside the folder, so your work and its notes stay together.
It suits people whose work already lives in folders: developers with a directory of repositories, students working through courses and playlists, and anyone who would rather use one keyboard-driven window than a separate to-do app, notes app and spreadsheet.
- Made by
- wleeaf, an independent software studio
- Platforms
- Linux (AppImage, AUR), Windows (.exe, Scoop), macOS (.dmg, Homebrew), or
pip install projectum - Price
- Free and open source (MIT licence), no paid tier
- Features
- Projects, playlists, todos, notes, links between any two things, a calendar, a command palette, 19 themes
- Your data
- A
.projectum.jsonin each folder; no account, no telemetry - Built with
- Python and PySide6 (Qt), with yt-dlp for playlists
- Source
- github.com/wleeaf/projectum · PyPI
01 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
- A command palette over everything —
Ctrl+K - Open in your editor, terminal or file manager
02 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.
03 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.
04 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.
// <your-folder>/.projectum.json { "projects": [{ "name": "aurora-engine", "tags": ["rust", "core"], "completed": false, "notes": "# Aurora\n\nRendering core…" }], "todos": […], "playlists": […], "note_docs": […] }
05 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.
06 Questions
Frequently asked, plainly answered.
What is Projectum?
Projectum is a free desktop app that keeps everything around a folder of work in one window: the projects in it, YouTube study playlists, todos and Markdown notes, linked to each other and shown on a calendar. It is made by wleeaf and is open source under the MIT licence.
Is Projectum free?
Yes. Projectum is free and MIT licensed, with no paid tier and no account. If it is useful to you, you can sponsor it on GitHub; that is optional.
Which operating systems does it run on?
Linux, Windows and macOS. Download the AppImage, .exe or .dmg from the latest release, install it with pip install projectum (64-bit Python 3.10 or newer), or use Homebrew (brew install --cask wleeaf/tap/projectum), Scoop or the AUR (yay -S projectum). The Windows and macOS builds are unsigned, so the first launch needs “More info → Run anyway” on Windows or right-click → Open on macOS.
Where does Projectum store my data?
Each folder’s projects, playlists, tags, todos and notes live in a .projectum.json file inside that folder, so the data travels with your work and diffs cleanly in Git. Window state, the theme and the relation graph (links.json) live in ~/.config/projectum/, because links can cross folders.
Does Projectum need an account or an internet connection?
No account and no server. Projectum sends no analytics or crash reports. It goes online only to fetch YouTube playlists with yt-dlp when you add or refresh one, and for one read-only GitHub call to check for updates, which you can turn off in Settings.
Does it work with Git repositories?
Yes. Each project shows its size, last-modified time, Git branch and whether it has uncommitted changes, read off the interface thread. You can expand a folder of repositories into nested projects, and commit .projectum.json with your code or add it to .gitignore.
Free, forever
Your work, organised in a minute.
More from wleeaf
Made by the same small studio.
- wleeafThe independent software studio behind Projectum: products, client work and notes.
- wleeaf PlayFree party games you play with friends in the browser, from Okey and Tavla to drawing games.
- KartiyaAn AI tarot reader for Android that reads the cards honestly, in twelve languages.
- Field notesHands-on guides on Linux, self-hosting, networking and the command line.