hgw/mercury
hgw
/
mercury
1
Fork 0
Code Issues Pull Requests Packages Wiki Activity
Simple & Customisable RSS Client for IRC
45 Commits 1 Branch 0 Tags 298 KiB
JavaScript 99.5%
Dockerfile 0.5%
Go to file
hgw e536d8f22a Upgrade to Node 18 2023-10-02 02:11:26 +00:00
.screens update readme w/ screenshot 2023-10-02 02:11:24 +00:00
commands fix alias case-sensitivity + fix endless options workers 2023-10-02 02:11:26 +00:00
config Add somewhat decent error handling finally 2023-10-02 02:11:26 +00:00
.dockerignore new readme and dockerignore 2023-10-02 02:11:24 +00:00
.gitignore options command init, add set subfunction 2023-10-02 02:11:25 +00:00
Dockerfile Upgrade to Node 18 2023-10-02 02:11:26 +00:00
LICENSE init 2023-10-02 02:11:23 +00:00
README.md Change readme info surrounding usersettings.json 2023-10-02 02:11:26 +00:00
bot.js Add somewhat decent error handling finally 2023-10-02 02:11:26 +00:00
docker-compose.yml this shit now works 2023-10-02 02:11:24 +00:00
package-lock.json options command init, add set subfunction 2023-10-02 02:11:25 +00:00
package.json options command init, add set subfunction 2023-10-02 02:11:25 +00:00

README.md

Mercury

Simple & Customisable RSS Client for IRC.

This bot is not completed, expect bugs/crashes/errors. Use in production is disadvised at this stage.

m!feed Example

Commands

  • m!feed [USER/FEED/ALIAS] [ENTRIES] - Return the last x amount of entries from any RSS feed or your own saved feeds (if you have saved feeds)
  • m!twitter [USER] [ENTRIES] - Return the last x amount of tweets from a particular user.
  • m!opt [CATEGORY] [OPTION] [VALUE] - Control bot options, see wiki for info on usage.

Deployment

  1. Install Docker (required) and Docker Compose (optional, but strongly recommended, this guide assumes you have it)
  2. Rename config/example.default.json to config/default.json and modify it accordingly. A list of variables and their descriptions can be found in this repos wiki. You do not need to do anything with example.usersettings.json unless you wish to predefine settings prior to the bots first start, the usersettings file will be made on the first run if it does not exist.
  3. Run docker compose up to begin. Append -d to start in the background and --build if you make any changes to any files.

Support

If you need assistance with installation or usage, join #5000 on irc.supernets.org

TODO

Once the following are completed, I will consider this project functional and ready to use in production.

  • Grab RSS feeds via URL
  • Allow users to save feeds and easily grab them all at once (needs tweaking still but mostly done)
  • Alias support
  • Grab feeds at set intervals and post new content in a set channel
  • Migrate from a JSON file to a DB for user settings
  • Extensive testing and applicable error handling, also more descriptive error messages
  • Ensure wiki is updated
  • Publish Docker image so the client does not need to be built by end users

License

This software is licensed under the ISC License, its full text can be found here.

Some required packages may be using licenses other than the ISC License. A full list of packages can be found in package-lock.json and their licenses can be found on their respective homepages/repositories.