TMSU(1)

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

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

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

REPORTING BUGS
Please report any bugs to the project mailing list <ml@tmsu.org> or add to the issue tracker via http://tmsu.org/.

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.