A stylized file manager filters documents by Manuals, Reference, and Video Editing tags, highlighting a matching PDF.
My Downloads folder is a landfill with a search bar, and I suspect yours is too. MakeUseOf writer Oluwademilade Afolabi pointed TagStudio at his Downloads folder. It found 29,972 files, and none of them had to move. TagStudio is a free, open-source tag-based file organizer. This write-up covers what the app does, how the test went, and where it can trip you up.

A stylized file manager filters documents by Manuals, Reference, and Video Editing tags, highlighting a matching PDF. The problem: one file, three homes​

A folder tree asks you to pick one location per file. Real files rarely cooperate. A PDF manual for a video-editing tool could sit under software documentation, video editing or general reference, and putting it in one place means losing it from the other two.

Tags fix that by attaching several labels to a single file. The file stays at its original path, and you find it by purpose instead of by location.

What TagStudio is​

According to the project's GitHub repository, TagStudio is a layer on top of your existing folders and file structure that doesn't require you to move or duplicate files. The project compares this to how Obsidian vaults work. The app runs on Windows, macOS and Linux.

The author tested Alpha 9.6.4 on Windows 11. The project's GitHub Releases page lists that build as the latest, dated October 2. The release notes describe per-tag category display options, info buttons in the tag editor, extra settings for the tag and field bars, a changelog window and bug fixes. They also say 9.7.0 is expected to follow with several major changes.

The alpha label matters, and the project's own roadmap shows many planned features still unbuilt.

How to set up a library​

The steps below come from the MakeUseOf walkthrough, cross-checked against TagStudio's documentation.

  1. Download the Windows build from the project's GitHub Releases page, then extract or install it and launch the app.
  2. Choose Open/Create Library from the welcome screen, or press Ctrl+O. In the menu bar this is File > Open/Create Library.
  3. Pick the folder you want organized. The author chose Downloads, subfolders included.
  4. Let the first scan finish. The files then appear in a thumbnail grid.

The docs say that if a .TagStudio folder doesn't already exist, TagStudio creates one and automatically scans the folder for files. That hidden folder holds the catalog. Per the library documentation, it contains the ts_library.sqlite database, an optional .ts_ignore file, a backups folder and a thumbs folder. Your files are not moved, copied or modified.

The interface has a thumbnail grid in the middle and sorting and thumbnail-size controls along the top. A preview and details panel sits on the right. Selecting a file shows its name, location, dates and size.

Tagging files​

  1. Click a file's thumbnail so the right-hand inspector opens.
  2. Click Add Tag or press Ctrl+T. The documentation says this opens the Tag Bar, a combined search and creation bar.
  3. Type a tag name and press Enter. If the tag doesn't exist, it is created and applied. If it does, the underlined suggestion is applied.
  4. Repeat for further tags. The author gave one PDF the tags Video Editing, Manuals and Reference.

Two details from the docs are useful:

  • Holding Shift while pressing Enter force-creates a tag from the text, whatever the search results show. That helps when a new name partly overlaps an existing tag, such as "Cub" next to "Cube".
  • You can select several files with Ctrl-click and tag them in one go. The author applied "Software Manuals" to four manuals this way, and a search for the tag returned all four.

Searching: where the payoff is​

Searching for "Video Editing" AND Manuals returned only the PDF from about 30,000 entries. The author reports the search took 0.02 seconds. That figure is one person's observation on one machine, not a benchmark, so don't treat it as a promise for your hardware or library.

The documentation confirms the search syntax:

  • AND returns entries matching both sides. It is the default when you put terms side by side.
  • OR returns entries matching either side.
  • NOT excludes whatever follows it.
  • Parentheses group terms, so (Tag1 OR Tag2) AND Tag3 works as you'd expect.
  • Multiword tags need quotation marks, or underscores in place of spaces.
  • path: searches filenames and paths by substring. Lowercase searches are case-insensitive, while mixed-case searches are case-sensitive.
  • special: untagged lists files that still have no tags, which makes it a handy to-do list.

Tag search also matches tag names, shorthands and aliases, and lets a tag stand in for its parent tags. A parent tag such as "Documents" can therefore catch children like "Manuals", if you build that hierarchy.

Limits to know before you commit​

  • Windows search can't see the tags. The tags live in TagStudio's own database. They are not written into the files as metadata, so File Explorer filters won't find them. You have to search inside TagStudio.
  • Fields aren't searchable yet. You can add text or date fields to a file, but the search documentation says field search is not yet in the program. Tags do the real work for now.
  • Tags are per-library. Global tags shared across libraries are planned but not available.
  • Moving or renaming files outside the app can break links. Moved files can often be recovered through Tools > Fix Unlinked Entries, followed by Search & Relink. The documentation warns that renamed files can't be relinked. If several candidates share the original filename, TagStudio currently ignores those match groups. Treat relinking as best-effort.
  • No simultaneous multi-user access. Libraries can sit on external or network drives, but the docs say simultaneous access by multiple users isn't currently supported.

Handling a big backlog​

Tagging 30,000 files by hand is not realistic. Three features help:

  • Folders to Tags. This tool turns your existing folder hierarchy into starter tags. The author says it previews the proposed hierarchy before applying it. Expect to clean up the names afterward. The 9.6.4 release notes mention fixes to this feature.
  • Refresh behavior. TagStudio scans for new or changed files when you open a library. The docs say you can turn this off for very large libraries or slow drives. You can refresh by hand with Ctrl+R or File > Refresh Directories.
  • Ignore rules. The .ts_ignore file works much like .gitignore. The docs say it only applies when scanning for new files and doesn't remove files already in the library.

Backups: two layers​

Libraries save automatically as you work. For a manual snapshot, use File > Save Library Backup or Ctrl+Shift+S. The docs say backups currently include only the ts_library.sqlite file, and they are stored under .TagStudio/backups/.

Your actual documents are not in that backup, so you still need a separate backup of the files. Losing the .TagStudio folder would lose every tag, though not the files.

Practical advice​

This is my own analysis, not something the sources state:

  • Try it on a copy first. Start with a manageable folder before pointing the app at a 30,000-file Downloads pile. The author tested on his real folder, but an alpha deserves a gentler first date.
  • Write down your naming rules early. The author warns about ending up with many labels that mean the same thing. Aliases help.
  • Treat it as a second layer. Folders still tell you where a file lives. Tags tell you what it is for. You pay for that with the upkeep of a second system, and it only works if you actually use the app to search.
  • Don't expect automatic sorting. TagStudio doesn't classify anything for you. Every useful tag is one you or the Folders to Tags macro created.

Verdict​

TagStudio deals with the oldest annoyance in file management: a file that belongs in several places. The test shows the workflow is quick to start, with a few clicks to a library and a keyboard-friendly tagging flow. The search syntax is expressive. The trade-offs are an alpha label, tags that live outside Windows' own search, and a relinking process that can't recover everything.

If your folders are already neat, you may not need it. If you keep finding the same PDF in three unrelated projects, it's worth an afternoon on a test folder.

 

References

  1. Thousands of files don't need thousands of folders when you have this app MakeUseOf 2026-11-06T19:30:17+00:00
  2. TagStudio: A User-Focused Photo & File Management System github.com
  3. Libraries - TagStudio docs.tagstud.io