91 lines
2.4 KiB
Markdown
91 lines
2.4 KiB
Markdown
**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 5 / 6 / 7 / 8)
|
|
* [cmake](https://cmake.org/) (tested: 3.9 / 3.12)
|
|
* [boost](http://www.boost.org/) (tested: 1.65 / 1.62)
|
|
* [curlpp](http://www.curlpp.org/) (tested: 0.8)
|
|
* [mastodon-cpp](https://schlomp.space/tastytea/mastodon-cpp) (at least:
|
|
0.105.0)
|
|
* [jsoncpp](https://github.com/open-source-parsers/jsoncpp) (tested: 1.8 / 1.7)
|
|
|
|
## Get sourcecode
|
|
|
|
### Development version
|
|
|
|
git clone https://schlomp.space/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,
|
|
"titles_only": false,
|
|
"skip":
|
|
[
|
|
"If the entry starts with this, skip it",
|
|
"Skip me too!"
|
|
],
|
|
"fixes":
|
|
[
|
|
"delete this",
|
|
"<p>[Rr]ead more(\.{3}|…)</p>"
|
|
],
|
|
"append": "#bot"
|
|
}
|
|
}
|
|
|
|
|
|
## Error codes
|
|
|
|
Same as
|
|
[mastodon-cpp](https://schlomp.space/tastytea/mastodon-cpp/src/branch/master/README.md#error-codes),
|
|
plus:
|
|
|
|
| Code | Explanation |
|
|
| --------: |:----------------------------------------|
|
|
| 1 | Could not send post for unknown reasons |
|
|
|
|
# Copyright
|
|
|
|
``` text
|
|
Copyright © 2018, 2019 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.
|
|
```
|