SUP-RECOVER-SOURCES(1)

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

💖 sup-recover-sources(1) 💖

okay bestie, so this is the man page for sup-recover-sources, part of the Sup mail setup, and honestly it's giving rescue mission energy 🦋

✨ NAME ✨

sup-recover-sources — rebuild a lost Sup source configuration file 🎀

🌸 SYNOPSIS 🌸

sup-recover-sources [options] [source uri...]

💅 DESCRIPTION 💅

So basically, this little icon rebuilds a lost sources.yaml file for you. How? It reads messages from a list of sources and then, for each source, it figures out the most prevalent source_id field of the messages from that source in the index. lowkey genius honestly ✨

The only non-deterministic component to this is that if the same message appears in multiple sources, those sources may be mis-diagnosed by this program. 🙈 like, it's doing its best but it can get confused, no cap.

Here's the vibe check on the logic: if the first N messages (that's --scan-num below, iykyk) all have the same source_id in the index, the source will be added to sources.yaml. Otherwise, the distribution will be printed, and you will have to add it by hand. 😭 so close yet so far.

Also, heads up bestie — the offset pointer into the sources will be set to the end of the source, so you will have to run sup-import --rebuild for each new source after doing this. fr fr, don't skip that part. 💀

👑 OPTIONS 👑

  • --unusual — Mark sources as 'unusual'. Only usual sources will be polled by hand (default: false) 🫶
  • --archive — Mark sources as 'archive'. New messages from these sources will not appear in the inbox (default: false) 🍓
  • --scan-num N — Number of messages to scan per source (default: 10) 🔍
  • -h, --help — Show help message 💖

🎀 FILES 🎀

  • $HOME/.sup/sources.yaml — Configuration file for Sup mail sources ✨

🌈 SEE ALSO 🌈

sup(1), sup-config(1), sup-add(1), sup-import(1) 💜

💀 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 your bugs properly, the devs will literally love you for it 🫶

🦋 CONTACT INFORMATION 🦋

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.

💖 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 — this was Sup User Manual, dated April 9, 2012, and the source/version line is SUP-RECOVER-SOURCES(1). go forth and recover those sources, you main character 💅✨

📦 where this page comes from