Skip to content
GothHeitPublic

About

Personal file catalog organized by tags instead of folders. Native Win32 C++, with an in-app viewer for images, videos and books.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

168 Commits

Folders and files

Repository files navigation

Corpus

Platform C++17 License

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.

Filtering by tags, then opening a picture, a video and a book

The file grid with the tag sidebar A video playing in the viewer
A picture in the viewer with its tags An EPUB in the reader

What it does

  • 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.

Download

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.

Music from other programs

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 --next puts them first. With nothing playing, they play right away.

Build

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-gui

That 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.

Searching

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 1988 finds files with both words
  • {film -watched} finds films you haven't watched
  • {movie (isshi OR katsuhiro)} finds movies with either tag
  • pdf {university} finds files tagged university with "pdf" in the path
  • ext:psd finds files with that extension, inbox: files with no maison/* or ref/* 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 tagged music/kanye or anything under it, like music/kanye/mbdtf

Clicking tags in the sidebar writes these for you.

Boards

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).

Shortcuts

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.

About

Personal file catalog organized by tags instead of folders. Native Win32 C++, with an in-app viewer for images, videos and books.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages