Skip to main content

R S S B O T

!!

NAME


RSSBOT - 24/7 feed fetcher.

DESCRIPTION


RSSBOT is a python3 bot able to display rss feeds in your channel.

It provides all the tools to program a bot, such as disk perisistence
for configuration files, event handler to handle the client/server
connection, code to introspect modules for commands, deferred
exception handling to not crash on an error, a parser to parse
commandline options and values, etc.

You can copy/paste the service file and run it under systemd for
24/7 presence in a IRC channel.

SYNOPSIS


rssbot <cmd> [key=val]
rssbot [-c] [-v]
rssbotd

INSTALL


pipx install rssbot

USAGE


default action is doing nothing

$ rssbot
$

first argument is a command


$ rssbot cmd
cfg,cmd,dpl,mre,nme,pwd,rem,rss,ver

starting a console requires an option


$ rssbot -c
>

to start the rssbot as daemon


$ rssbot -d
$

add -v if you want to have verbose logging


$ rssbot -cv
RSSBOT started Wed Nov 8 15:38:56 2023 CVI
>

CONFIGURATION

irc configuration is done with the cli interface using the cfg command


$ rssbot cfg server=<server>
$ rssbot cfg channel=<channel>
$ rssbot cfg nick=<nick>

sasl need a nickserv nick/password pair to generate a password for sasl


$ rssbot pwd <nsnick> <nspass>
$ rssbot cfg password=<frompwd>

rss has several configuration commands


$ rssbot rss <url>
$ rssbot dpl <url> <item1,item2>
$ rssbot rem <url>
$ rssbot nme <url> <name>

COMMANDS

here is a list of the commands (use rssbot <cmd>)


cfg - irc configuration
cmd - commands
dpl - sets display items
mre - displays cached output
pwd - sasl nickserv name/pass
rem - removes a rss feed
rss - add a feed

SYSTEMD

save the following it in /etc/systems/system/rssbot.service and replace “<user>” with the user running pipx


[Unit]
Description=24/7 feed fetcher
Requires=network.target
After=network.target

[Service]
Type=simple
User=<user>
Group=<user>
WorkingDirectory=/home/<user>/.rssbot
ExecStart=/home/<user>/.local/pipx/venvs/rssbot/bin/rssbotd
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target


if you don’t have a ~/.rssbot directory you need to create it


$ mkdir ~/.rssbot

then run this


$ sudo systemctl enable rssbot –now

default channel/server is #rssbot on localhost

FILES


~/.rssbot
~/.local/bin/rssbot
~/.local/bin/rssbotd
~/.local/pipx/venvs/rssbot/

AUTHOR


Bart Thate <objx@proton.me>

COPYRIGHT


RSSBOT is Public Domain.

Metadata

Release files for rssbot 512

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rssbot 512
File Size Uploaded Provenance Actions
rssbot-512.tar.gz 23.1 kB Without provenance Details for rssbot-512.tar.gz

Release files / rssbot-512.tar.gz

Download URL rssbot-512.tar.gz
Size 23.1 kB
Tags Source
SHA-256 checksum
How to use checksums
549a7ceae80a245ca25a8334e01757dc42d8b0d527e8426234d1319594f506f3
BLAKE2b-256 checksum
How to use checksums
ff36ca461d47ddfb3fe52d06429d49b0b6c41eaa13aedb27237bae3e9349744b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.2

Security for rssbot 512

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

512 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page