mastorss/README.md

2.1 KiB

mastorss dumps RSS feeds into a mastodon account. Supports RSS 2.0 but not RSS 0.92. Does not support Atom at the moment.

<item>s in feeds must have <link>, <title> and <description>.

The documentation is far from complete, sorry.

Install

Dependencies

  • Tested OS: Linux
  • C++ compiler (tested: gcc 6.4, clang 5.0)
  • cmake (tested: 3.9.6)
  • boost (tested: 1.63.0)
  • curlpp (tested: 0.8.1)
  • mastodon-cpp (at least: 0.8.6)
  • jsoncpp (tested: 1.8.4)

Get sourcecode

Development version

git clone https://github.com/tastytea/mastorss.git

Compile

mkdir build
cd build/
cmake ..
make

Install

Install with make install.

Usage

Put watchwords.json into ~/.config/mastorss/. Launch with profile name. The first occurence of every watchword in an RSS item will be turned into a hashtag. For profile-specific watchwords see the example in watchwords.json. In the first run only the newest entry is tooted.

The profile can't be named "global".

Example config file

${HOME}/.config/mastorss/config-example.json

{
    "example": {
        "instance": "botsin.space",
        "feedurl": "https:\/\/example.com\/feed.rss",
        "access_token": "123abc",
        "max_size": "400",
        "skip":
        [
            "If the entry starts with this, skip it",
            "Skip me too!"
        ],
        "fixes":
        [
            "delete this",
            "[Rr]ead more(\.{3}|…)"
        ]
    }
}

Error codes

Same as mastodon-cpp

Copyright

Copyright © 2018 tastytea <tastytea@tastytea.de>.
License GPLv3: GNU GPL version 3 <https://www.gnu.org/licenses/gpl-3.0.html>.
This program comes with ABSOLUTELY NO WARRANTY. This is free software,
and you are welcome to redistribute it under certain conditions.