NAME

tmsu - tag files and view them in a tag-based virtual filesystem

SYNOPSIS

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

DESCRIPTION

TMSU is a program for organising files by associating them with tags. A tag based view of the files can be mounted as a virtual filesystem so that the files can be accessed via tag from any other program.

GLOBAL OPTIONS

-v, --verbose

show verbose messages

-h, --help

show help and exit

-V, --version

show version inforamtion and exit

-D PATH, --database=PATH

use the specified database

--colour

use colour: '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. 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 <[email protected]>.

REPORTING BUGS

Please report any bugs to the project mailing list <[email protected]> or add to the issue tracker via http://tmsu.org/.

COPYRIGHT

Copyright © 2011-2015 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.