TMSU review
A powerful open-source tagging tool for technical users who prefer the command line.
Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026
TMSU is an open-source command-line utility for organizing files with tags and tag values. It is aimed at technically oriented individuals and developers who prefer filesystem tools over graphical file managers. Users can apply tags to individual or multiple files, query those tags with Boolean and comparison operators, and access results through a mountable virtual filesystem. TMSU also supports query-based filesystem directories, letting tagged views work with other programs while the original files remain unchanged.
Its strongest capability is the depth of its tagging model. Tag values add structure beyond simple labels, while and, or, not, and comparison operators support targeted file queries. Tags can also be managed through virtual filesystem directories and links. When files move or change, TMSU can repair database references and fingerprints. Shell-integrated command-line help and Zsh completion make the workflow more practical for users already comfortable in a terminal. The separate metadata database is useful when preserving the contents and structure of original files matters.
TMSU is free and open source across Linux, macOS, and Windows, making it a focused option for tag-based organization without a paid tier. Its narrow scope is also its main boundary: the listed feature set does not include graphical panes, tabs, archives, renaming, or integrations. The repository lists v0.7.5 as the latest release from December 2019 and v0.8.0 as in development, so current maintenance activity is uncertain. Choose TMSU if flexible tagging and virtual filesystem access matter more than a conventional file-manager interface; choose another tool if you need broad desktop file-management features or a graphical workflow.
TMSU pros and cons
- Where it wins
- Powerful Boolean queries with and, or, not, and comparison operators
- Keeps original files unchanged while storing metadata separately
- Works on Linux, macOS, and Windows with virtual filesystem views
- Where it doesn't
- Command-line focus may not suit users seeking graphical file management
- No listed panes, tabs, archives, renaming, or integrations
- Latest listed release is v0.7.5 from December 2019
TMSU fact sheet, pricing and score →
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update