HERALD

NAME

    herald - RSS-to-Email via SSH

FILE FORMAT

    Feed configs are plain text files with directives:

    =: email [email protected]       Recipient email address
    =: cron 0 8 * * *               Standard cron (5 fields)
    =: digest true                  Combine items (default: true)
    =: inline false                 Include content (default: false)
    => https://example.com/feed     RSS/Atom feed URL
    => https://blog.com/rss "Blog"  Feed with display name

    Example feeds.txt:
    =: email [email protected]
    =: cron 0 8 * * *
    =: digest true
    => https://dunkirk.sh/atom.xml
    => https://news.ycombinator.com/rss
tor.com/rss
nator.com/rss

COMMANDS

    ls                  List uploaded feed configs
    cat           Display config file contents
    rm            Delete a config file
    activate      Reactivate a deactivated config
    deactivate    Stop emails for a config
    run           Manually trigger feed fetch and email
    logs                View recent delivery logs
    View recent delivery logs
 logs

EXAMPLES

    # Upload a config
    scp -P 2223 feeds.txt [email protected]:

    # Get your fingerprint (for web dashboard)
    # Your dashboard will be at:
    # https://herald.dunkirk.sh/
    ssh -p 2223 [email protected]

    # Check status
    ssh -p 2223 [email protected] ls

    # View config
    ssh -p 2223 [email protected] cat feeds.txt

    # Manual run
    ssh -p 2223 [email protected] run feeds.txt
s.txt
 run feeds.txt