Skip to main content

feeding rss into your channel

Project description

R S S B O T

!!

NAME


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 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]

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
sts - show status
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


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

AUTHOR


Bart Thate <libbotx@gmail.com>

COPYRIGHT


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

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-503.tar.gz (18.9 kB view details)

Uploaded Source

File details

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

File metadata

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

File hashes

Hashes for rssbot-503.tar.gz
Algorithm Hash digest
SHA256 1fad3fcfdb92a1e245b0672bda02bc1e66d00325d12edbe32da97da4c191d374
MD5 e792150c02ff435a30141bb393eaf711
BLAKE2b-256 6dd37adee6fea43aa816cf08def0b80863f4e447a5c49120b26bc2af267e25c9

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