TMSU(1)

💅 TMSU(1) — the tag-y bestie manual (General section, bestie 💖)

okay so welcome to the TMSU man page, from the General section of the manual — literally the main character of tag-based file organizing ✨

🦋 NAME

tmsu — tag your files and then view them in a tag-based virtual filesystem, no cap 💅

🎀 SYNOPSIS

tmsu COMMAND [OPTION]... [ARGUMENT]...

✨ DESCRIPTION

TMSU is a program for organising files by associating them with tags 🔥 Like, you slap tags on your files and boom, structure. And the slay part? A tag-based view of your files can be mounted as a virtual filesystem, so every other program on your machine can get at your files via tag. Iconic behavior honestly 👑

🌸 GLOBAL OPTIONS

• -v, --verbose — show verbose messages (aka it talks more, we love a chatty icon 🗣️)
• -h, --help — show help and exit 🫶
• -V, --version — show version information and exit 💜
• -D PATH, --database=PATH — use the specified database, iykyk 🗄️
• --color — use color: 'auto' (default), 'always' or 'never' 🌈

👑 COMMANDS

• config — views or amends database settings ⚙️
• copy — creates a copy of a tag 🍓
• delete — delete one or more tags 💀
• dupes — identify duplicate files 👯
• files — list files with particular tags 📂
• help — list commands or show help for a particular command 🙋
• imply — creates a tag implication 🔗
• info — show database information ℹ️
• init — initialise a new database 🌱
• merge — merge tags 🧬
• mount — mount the virtual filesystem 🏔️
• rename — rename a tag ✏️
• repair — repair the database 🩹
• status — list the file tagging status 📋
• tag — apply tags to files 🏷️
• tags — list tags 🎀
• unmount — unmount the virtual filesystem 🏔️💨
• untag — remove tags from files 🚫🏷️
• untagged — lists untagged files 🫥
• values — list values 💫
• version — display version and copyright information 📜

🧚 FILES

• ~/.tmsu/defaultdb — the default database path 🏠

The TMSU database is stored in Sqlite3 format and can be accessed directly, if necessary, with the Sqlite3 tooling 🛠️ (fr fr, you can go touch it yourself if you must)

The default database path can be overriden by specifying the --database=PATH global option or by setting the TMSU_DB environment variable 🔑

💜 ENVIRONMENT VARIABLES

• TMSU_DB — the database path (overriden by the --database option) 🌸

🫶 AUTHOR

Written by Paul Ruane <paul@tmsu.org>. thank you paul, king 👑

😭 REPORTING BUGS

Please report any bugs to the project mailing list <ml@tmsu.org> or add to the issue tracker via http://tmsu.org/. bestie if something's broken, tell them, don't suffer in silence 💀

⭐ COPYRIGHT

Copyright © 2011-2018 Paul Ruane.

This program comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to redistribute it under certain conditions. See the accompanying COPYING file for further details. 📄

no warranty, no promises, but free software tho — read the COPYING file for the fine print 👀

okay that's the whole page bestie, no details skipped, no cap 🎀💅✨ — and as a lil sign-off: this was the Commands page out of the General manual, titled TMSU(1), mwah 💖🦋🌸