FETCHYAHOO(1)

📦 version 2.14.7, in ubuntu jammy

💅 FETCHYAHOO(1) — General Commands Manual, but make it cute 💅

okay so bestie, this is fetchyahoo(1), living in the General Commands Manual section, and before we even get going the page just says bg. right up top. no context. no explanation. iconic behavior honestly. anyway—

✨ NAME ✨

fetchyahoo — grab your mail off Yahoo!'s webmail service 🦋

🌸 SYNOPSIS 🌸

fetchyahoo [options]

💖 DESCRIPTION 💖

So. FetchYahoo is a Perl script that downloads your mail from a Yahoo! account straight down to a local mail spool. It exists to be the replacement for fetchmail for all the girlies using Yahoo! mail, because Yahoo!'s POP service is no longer free — yes really, that's the whole reason. 😭

It pulls messages into a local mail spool, and that includes all parts and attachments, no skimping. After that it deletes the messages unless you specifically ask it not to. And if you want, it can also forward messages to an email address you pick, and then just keep doing that on a repeat interval like the dedicated little daemon it is. periodt. 💅

🎀 OPTIONS 🎀

This program follows the usual GNU command line syntax, bestie — long options start with two dashes (-). Here's the rundown of options below. For even more info, go check the HTML documentation. 👑

  • --help — shows you a lil summary of the options.
  • --version — shows the version of the program.
  • --quiet, --noquiet — suppress (or don't suppress) the non-error messages. shhh 🤫
  • --noerrors, --errors — suppress (or don't suppress) the error messages.
  • --configfile=CONFIG-FILE — use CONFIG-FILE as your configuration file.
  • --username=USERNAME — use USERNAME as the Yahoo! login.
  • --password=PASSWORD — use PASSWORD as your Yahoo! password. (keep it secret, keep it safe 🫶)
  • --spoolfile=SPOOL — set SPOOL as the file to spool messages to; but if --pipe is also in the mix, then SPOOL is a program that accepts messages from standard input (like procmail). yes, it shape-shifts.
  • --https --nohttps — use insecure plaintext or secure HTTPS to log in. the default is HTTPS, because obviously. 🔒
  • --append — append messages to the SPOOL. this is the default behavior, it's the chill one.
  • --pipe — pipe messages to the program SPOOL instead of appending to SPOOL.
  • --overwrite — overwrite SPOOL instead of appending to it. destructive energy, be careful 💀
  • --folder=FOLDER — pick the folder on Yahoo! to download messages from. (default is Inbox.)
  • --newonly — only download new messages. (default is to download all messages, so this is the picky option ✨)
  • --allmsgs — download all the messages. all of them. every single one. 👑
  • --nodelete, --delete — don't delete (or do delete) messages after they get downloaded.
  • --nodownload, --download — don't download messages; however, they will still be deleted unless --nodelete is also specified. (--download is the default.) > ⚠️ read that again bestie, no-download does NOT mean no-delete. 😭
  • --listmessages, --nolistmessages — list messages in the mail folder. (--nolistmessages is the default.)
  • --onlylistmessages — only list messages in the mail folder. this one is literally a combo of --listmessages, --nodownload and --nodelete all holding hands 🫶
  • --emptybulk — empty the Bulk folder before downloading messages.
  • --emptytrashbefore — empty the trash before downloading messages.
  • --emptytrashafter — empty the trash after downloading messages.
  • --noempty — do not empty trash or bulk. (Default.) it's giving "leave no trace."
  • --leaveunread — leave the messages marked as unread on the server.
  • --markread — mark the messages you downloaded as read. (Default.)
  • --repeatinterval=N — check for mail every N minutes.
  • --statusonly, --nostatusonly — just get the number of messages. (--nostatusonly is the default.)
  • --getexternal, --nogetexternal — retrieve messages from external mailboxes too. (--nogetexternal is the default.)
  • --externalmailboxes=boxes,list — retrieve messages from only this comma-separated list of external mailboxes.
  • --maxmessages=N — maximum number of messages to download (default is 100). > ⚠️ setting this over 100 may cause problems. fr fr.
  • --warninglevel=N — warn if more than N% of your storage quota is used. never warn if N=0 (default is 0).
  • --nofromline, --includefromline — omit (or include) the leading "From " in messages that get appended or piped. (--includefromline is the default.)
  • --logout, --nologout — log out (or don't log out) of Yahoo! when you exit. (--nologout is the default.)
  • --proxyhost=s — hostname to use for the proxy (default is off).
  • --proxyport=N — port to use for the proxy (default is 80).
  • --proxyuser=s — username to use for proxy authentication (default is no authentication).
  • --proxypass=s — password to use for proxy authentication (default is no authentication).
  • --imaphost=s — hostname to use for IMAP (default is off).
  • --imapport=N — port to use for IMAP (default is 143).
  • --imapuser=s — username to use for IMAP authentication (no default).
  • --imappass=s — password to use for IMAP authentication (no default).
  • --imapmailbox=s — IMAP mailbox to use (default is INBOX).
  • --repeatinterval=N — check for mail every N minutes (daemon mode). yes this option shows up twice in the original and I am keeping both because I keep EVERY detail, that's the rule 💜
  • --md5hex — print the MD5 hex hash value of a password you type in interactively. 🔐

📁 FILES 📁

  • /etc/fetchyahoorc
  • $HOME/.fetchyahoorc

These are the configuration files for FetchYahoo. And an example configuration file lives at /usr/share/doc/fetchyahoo/examples/ if you wanna peek at a template. 🎀

🦋 SEE ALSO 🦋

procmail(1) and /usr/share/doc/fetchyahoo/index.html

👑 AUTHOR 👑

FetchYahoo was written by Ravi Ramkissoon <ravi_ramkissoon@yahoo.com>.

This manual page was written by Chris Lawrence <lawrencc@debian.org>, for the Debian GNU/Linux system (but may be used by others). slay.

and that's the whole page, bestie 💖 this is FETCHYAHOO(1) from the General Commands Manual, dated September 20, 2002 — yeah, a whole legend from 2002, still iconic, still serving ✨ stay hydrated, back up your spool, and don't run --overwrite unless you mean it 🫶🎀

📦 where this page comes from