A catalog for my personal files. I wanted something to tag the files I already have and find them again without digging through folders, so I built it.
Drop in a folder, tag what's inside, then search by name and tags together. Pictures, videos, music and books open inside the app. Everything else opens in its default program. Corpus only remembers where your files are: it never copies or changes them, unless you rename a file or send it to the Recycle Bin from inside the app.
It's a native Windows app in C++ (Win32 and Direct2D, no UI framework), one .exe, library stored in SQLite.
![]() |
![]() |
![]() |
![]() |
- Imports whole folders (drag them in, or Ctrl+O). Each folder can become a tag, shown as a tree in the sidebar (a folder inside another is
Music/Album). Imported folders are watched, so new files show up on their own. - Tags many files at once with Ctrl+T, or by dragging files onto a tag in the sidebar. Tags can be renamed, merged and deleted, a whole branch at a time.
- Searches by name and tag in one box, see below.
- Views pictures (anything Windows can decode, plus PSD), plays videos and music with libmpv (FLAC, MP3, WAV, M4A, OGG, OPUS, AAC, with their embedded covers), and reads PDF, CBZ, EPUB, text, Markdown and HTML. Books reopen where you stopped.
- Undo and redo for tag edits and removing files from the library (Ctrl+Z, Ctrl+Y).
- Drag files out of the grid into Explorer or a chat, or copy them with Ctrl+C.
- Finds files again after you move them outside Corpus (the Missing view).
- Backs up the library on start, and can export and restore from Settings.
Grab Corpus.exe from the releases page. It's a single file: put it anywhere and run it. The library lives in %LOCALAPPDATA%\Corpus, and Corpus.exe --library <file.db> uses another one. "Open in another window" in a file's right-click menu shows it in a second Corpus window with its own player, so music in the main window keeps playing. Keep the library on a local drive; SQLite doesn't work well on network shares.
Scripts and assistants can drive the music without bringing the window up. These never show a message; the exit code is 0 when it worked, 1 when it didn't, and 2 for a bad command line.
Corpus.exe --export-music <file.json>writes every song in the library and exits, without opening a window. The library is only read, so this works while Corpus is open. Each song is{"path", "title", "artist", "album", "genre", "tags"}; the title falls back to the file name, and the other fields are empty when the song doesn't say.Corpus.exe --play [--shuffle] <files...>replaces the list and plays it in the strip, without opening the viewer or taking the focus. If Corpus isn't running, it starts minimized.Corpus.exe --queue <files...>adds songs to the end of the queue, and--nextputs them first. With nothing playing, they play right away.
Corpus cross-compiles to Windows with MinGW-w64, from Linux or WSL:
sudo apt install cmake g++ mingw-w64
git clone https://github.com/GothHeit/Corpus.git
cd Corpus
cmake -B build-gui -DCMAKE_TOOLCHAIN_FILE=cmake/mingw-toolchain.cmake
cmake --build build-guiThat gives you build-gui/Corpus.exe.
Video playback needs libmpv-2.dll, Corpus's own LGPL build of libmpv (about 60 MB, mpv and FFmpeg without their GPL parts). It is made with mpv-winbuild-cmake after applying tools/libmpv-lgpl/recipe-changes.patch to it. To embed the DLL in Corpus.exe (compressed, so the .exe stays a single file), put it in build-gui before configuring, or configure again afterwards:
cp /path/to/libmpv-2.dll build-gui/
# or: powershell.exe -NoProfile -File "$(wslpath -w tools/get-libmpv.ps1)" -Source <libmpv-2.dll or its address>You can also pick another libmpv-2.dll in Settings > Advanced > Video engine. Corpus uses it from the next start instead of the built-in one, and falls back to the built-in one if it doesn't load. The file isn't checked.
Without it everything else works, and videos and music open in their default program.
The core library and the CLI build on Linux with plain cmake -B build && cmake --build build, which also builds the tests.
Plain words must all appear in a file's path or tags, in any order, ignoring case and accents. Tags go in braces and can use AND, OR, NOT (uppercase), - and parentheses:
akira 1988finds files with both words{film -watched}finds films you haven't watched{movie (isshi OR katsuhiro)}finds movies with either tagpdf {university}finds files taggeduniversitywith "pdf" in the pathext:psdfinds files with that extension,inbox:files with nomaison/*orref/*tag, and"blood luster"a phrase in a path or tag name (_counts as a space). They need no braces; put a-in front to leave them out. Inside braces they work too, and|means OR ({ext:psd | ext:png}).{music/kanye}finds files taggedmusic/kanyeor anything under it, likemusic/kanye/mbdtf
Clicking tags in the sidebar writes these for you.
A board is a view of the catalog, not a separate place: a saved search whose files you lay out on a canvas. Click Boards in the sidebar and press + (or Ctrl+N) to make one from what the search box says now. The search box stays the only query box: the board's search is what you type there, and the tags you click in the sidebar change it as usual.
- Files the search finds wait in a tray under the canvas, and are never placed by themselves. Drag one up (or double-click it, or press P), or use Place all.
- Drag a file to move it, drag its corner to resize it, press
]or[to bring it to the front or send it back, Del to take it off the board. Drag empty space to pan, use the wheel to zoom, Home to fit everything. - Export PNG... (Ctrl+E) draws the board into one picture.
- A file the search no longer finds is hidden but remembers its place, and comes back there if the search finds it again.
- Boards are kept in the catalog next to your tags (no extra file).
Library:
- Enter: open. Space: quick look.
- Ctrl+F: search. Ctrl+T: tag the selection. Ctrl+O: add a folder.
- Ctrl+Z / Ctrl+Y: undo / redo. Ctrl+C: copy files.
- Ctrl+I: info pane. Ctrl+B: sidebar. Ctrl+, : settings.
- Ctrl+A: select all. Esc: clear selection.
- F2: rename. Del: remove from the library. Shift+Del: Recycle Bin.
Viewer:
- Left / Right: previous / next file. Home / End: first / last.
-
- / - / 0: zoom. Z: actual size. F: fullscreen. Esc: close.
- Ctrl+T: show the file's tags, with a field to add more (Enter adds, Tab completes, Esc hides).
- Videos and music: Space or K play/pause, Left / Right seek (step while paused, Ctrl+Left / Right always step), Up / Down volume, M mute, [ / ] speed, Backspace normal speed.
- Music plays on to the next track in the results. Esc keeps it playing in a strip under the grid; click its name to come back.
- Books: Left / Right turn pages, Space scrolls, W fit width, R reading direction.




