sup-tweak-labels - Man Page

batch modification of message state already in index


sup-tweak-labels [options] source ...


Batch modification of message state for messages already in the index.

Supported source URI schemes can be seen by running “sup-add --help”.



One or more labels (comma-separated) to add to every message from the specified sources (default: )

-r STRING, --remove STRING

One or more labels (comma-separated) to remove from every message from the specified sources, if those labels are present (default: )

-q QUERY, --query QUERY

A Sup search query

Other Options

-v,  --verbose

Print message ids as they’re processed

-e,  --very-verbose

Print message names and subjects as they’re processed


Scan over all sources

-n,  --dry-run

Don’t actually modify the index. Probably only useful with --verbose


Show version information

-h,  --help

Show help message

See Also

sup(1), sup-add(1)

Reporting Bugs

You are welcome to submit bug reports to the Sup issue tracker, located at


Contact Information

The Sup web page:


Code repository:


Sup Wiki:


Sup IRC channel:

#sup @

Mailing list:

Archives: <>


Sup was originally written by William Morgan <> and is now developed and maintained by the Sup developers.

Referenced By

sup(1), sup-sync(1), sup-sync-back-maildir(1).

April 9, 2012 Sup User Manuel