Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gehaxelt/python-rss2irc
A simple IRC bot which fetches and posts RSS feeds
https://github.com/gehaxelt/python-rss2irc
Last synced: 5 days ago
JSON representation
A simple IRC bot which fetches and posts RSS feeds
- Host: GitHub
- URL: https://github.com/gehaxelt/python-rss2irc
- Owner: gehaxelt
- License: mit
- Created: 2016-05-12T22:18:14.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-05-23T01:07:56.000Z (over 1 year ago)
- Last Synced: 2024-08-05T21:28:14.446Z (3 months ago)
- Language: Python
- Size: 91.8 KB
- Stars: 30
- Watchers: 5
- Forks: 18
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
Python RSS-2-IRC bot
====
This is a simple bot which fetches RSS feeds and posts them to an IRC channel.
# Requirements
- python3
- pip3
- venv (`Available by default in Python 3.3+`)
# Features
- Saves feeds and news items in a sqlite database
- Fetches every feed in a separate thread
- Posts new news items to an IRC channel
- Sends information via private messages
- SSL connection support
- Full utf-8 support
- Nick login support
- Delayed post during conversation
- Keywords in news title filtering support
- Customizable post colors
- Automatic join to channel on kick
# Bot's commands:
```
Help:
Send all commands as a private message
- !help Prints this help
- !list Prints all feeds
- !stats Prints some statistics
- !last Prints the last 10 entries
- !lastfeed Prints the last 10 entries from a specific feed
```
# Setup
Clone this repository and change into the directory. Create a new virtualenv and activate it:
```
python3 -m venv venv
source venv/bin/activate
```
Proceed with the installation of all dependencies:
```
pip3 install -r requirements.txt
```
Copy the sample files:
```
cp config.py.sample config.py
cp feeds.sql.sample feeds.sql
```
Edit `config.py` to fit your needs and IRC settings. All feeds from `feeds.sql` will be imported on the first start.
You might want to update all feeds before connecting to the IRC server to prevent spamming the channel (and optionally a ban from your IRC server). Either set `update_before_connecting = True` in the `config.py` or run the update script before starting the bot:
```
python3 feedupdater.py
```
To start the bot, run:
```
python3 main.py
```
or in background:
```
python3 main.py 2>&1 > newsbot.log &
```
If you want to run this as a systemd service, you can use the `rss2irc.service` file after adjusting the paths in there.
# Adding feeds
To add a new feed, edit the `feeds.sql` and import it to your sqlite database:
```
sqlite3 feeds.db < feeds.sql
```
And restart the bot.
# License
See [LICENSE](./LICENSE.md) for more information.