SUP-TWEAK-LABELS(1)

📦 version 1.4, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 SUP-TWEAK-LABELS(1) — bestie edition 💅

ok so you found the manual page for sup-tweak-labels, and honestly? it's giving "I have 4000 unread emails and I refuse to click each one." let's get into it 🫶

✨ NAME ✨

sup-tweak-labels — batch modification of message state already in index

like, you already indexed everything, and now you wanna change the labels on a whole pile of messages at once instead of one by one. that's the whole vibe. 💖

🌸 SYNOPSIS 🌸

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

sources go at the end, options go wherever, classic. ✨

🦋 DESCRIPTION 🦋

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

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

that's it, that's the description, she's brief but she's powerful. 👑

💖 OPTIONS 💖

  • -a STRING, --add STRING — 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. she's not like other verboses 💅
  • --all-sources — scan over all sources 🌈
  • -n, --dry-run — don't actually modify the index. probably only useful with --verbose 🙈
  • --version — show version information ⭐
  • -h, --help — show help message 🫶

🧚 SEE ALSO 🧚

sup(1), sup-add(1)

go read those too, they're part of the family. 💜

💀 REPORTING BUGS 💀

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

<https://github.com/sup-heliotrope/sup/issues>

not me begging you to file the bug instead of just suffering in silence 😭 please, the maintainers want to know.

🌸 CONTACT INFORMATION 🌸

  • The Sup web page:
<http://supmua.org/>
  • Code repository:
<https://github.com/sup-heliotrope/sup/>
  • Sup Wiki:
<https://github.com/sup-heliotrope/sup/wiki/>
  • Sup IRC channel:
#sup @ freenode.net
  • Mailing list:
supmua@googlegroups.com

supmua+subscribe@googlegroups.com

Archives: <https://groups.google.com/d/forum/supmua/>

Copyright © 2006-2009 William Morgan <mworgan-sup@masanjin.net>

Copyright @ 2013-2014 Sup developers

Permission is granted to copy and distribute this manual under the terms of the GNU General Public License; either version 2 or (at your option) any later version.

that's the GPL doing its thing, no cap. ⚖️

💜 AUTHORS 💜

Sup was originally written by William Morgan <wmorgan-sup@masanjin.net> and is now developed and maintained by the Sup developers.

and that's the whole page bestie, you're officially educated 💖✨

this edition of the Sup User Manuel dropped April 9, 2012, brought to you by the Sup User Manuel herself — go forth and tweak those labels, you absolute icon 🎀🦋

📦 where this page comes from