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

Uploaded Source

File details

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

File metadata

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

File hashes

Hashes for rssbot-504.tar.gz
Algorithm Hash digest
SHA256 e539d57a95d9b8614561e154a66e2ac9470dd8f6ce3a3d6502affdd797715657
MD5 e40b673b377628e8f6b65506eec82ae1
BLAKE2b-256 73ea9c8297f692c47bb191235d5a1734994c0ca08e5a760b62721715563f4f77

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