Skip to content
/ rssirc Public

rssirc is an IRC bot which follows RSS feeds.

License

Notifications You must be signed in to change notification settings

n7st/rssirc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

4a7151e · Jan 16, 2024

History

31 Commits
Jan 16, 2024
Aug 17, 2020
Feb 20, 2023
Aug 17, 2020
Jan 16, 2024
Jul 11, 2020
Jul 11, 2020
Jul 11, 2020
Aug 17, 2020
Jan 16, 2024
Jan 16, 2024

Repository files navigation

rssirc

rssirc is an IRC bot which follows RSS feeds.

Installation

Using a pre-compiled binary

Download a binary for your system from the releases page.

Configuration

Linux

Configuration is read from $HOME/.config/netsplit/rssirc/config.yaml. If you are not providing a custom filename, this file must exist.

Example configuration

log_level: info
irc:
    channels:
        - "#firstchannel"
        - "#secondchannel"
    server: irc.snoonet.org
    port: 6697
    ident: rssbottest
    max_reconnect: 3
    modes: +B
    nickname: rssbottest
    nickserv_account: my-nickserv-account
    nickserv_password: my-nickserv-password
    use_tls: true

    # Additional options:
    # debug: true # Enable IRC debugging
rss:
    -
        feed_url: https://www.nasa.gov/rss/dyn/breaking_news.rss
        # poll_delay is in minutes and must be 1 or greater.
        # The default is hourly.
        poll_delay: 60
        # max_history defines the cached RSS feed item length
        max_history: 3
        # channels defines which IRC channels notifications for new feed items
        # will be sent to
        channels:
            - "#firstchannel"
            - "#secondchannel"

Running

% rssirc

Optional custom config filename

% rssirc path/to/config.yaml

Limitations

  • Only new items from followed RSS feeds will be displayed in the IRC channels. This is by design and means that the bot can safely be restarted without duplicate notifications for new feed items.

License

MIT. See LICENSE.txt.