Skip to main content

feeding rss into your channel

Project description

RSSBOT - feed rss into your channel

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 also copy/paste the service file and run it under systemd for
24/7 presence in a IRC channel.

RSSBOT is a contribution back to society and is Public Domain.

SYNOPSIS

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

INSTALL

pipx install rssbot

USAGE

default action is doing nothing:

$ rssbot
$

first argument is a command:

$ rssbot cmd
cfg,cmd,dlt,dne,dpl,fnd,log,met,mod,mre,
nme,pwd,rem,rss,sts,tdo,thr,ver

starting a console requires an option:

$ rssbot -c
>

list of modules:

$ rssbot mod
bsc,err,flt,irc,log,mod,rss,shp,sts,tdo,
thr,udp

to start the rssbot as daemon:

$ rssbot -d
$

add -v if you want to have verbose logging:

$ rssbot -cv
PRG 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 most basic commands:

cfg - irc configuration
cmd - commands
dlt - remove a user
dne - mark todo as done
dpl - sets display items
fnd - find objects
log - log some text
met - add a user
mre - displays cached output
nme - display name of a feed
pwd - sasl nickserv name/pass
rem - removes a rss feed
rss - add a feed
sts - show status
tdo - add todo item
thr - show the running threads

SYSTEMD

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

[Unit]
Description=feeding rss into your channel
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/rssbot -d
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target

then run this:

sudo systemctl enable rssbot --now

default channel/server is #rssbot on localhost

FILES

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

AUTHOR

Bart Thate <bthate@dds.nl>

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rssbot-500.tar.gz (22.2 kB view details)

Uploaded Source

File details

Details for the file rssbot-500.tar.gz.

File metadata

  • Download URL: rssbot-500.tar.gz
  • Upload date:
  • Size: 22.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.2

File hashes

Hashes for rssbot-500.tar.gz
Algorithm Hash digest
SHA256 5fe497938c1c884be692cdfbac04e8e5e876c48b23ae966113e8b19849baa828
MD5 eff3bce82e4a04f3a3b36a35005a07a7
BLAKE2b-256 267ffc6b284028274d3e19e190719ecb3e16b560e82a531487eae799c531f115

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page