feed2toot/README.md

69 lines
2 KiB
Markdown
Raw Normal View History

2017-04-09 10:30:48 +02:00
### Feed2toot
2017-04-10 11:13:35 +02:00
Feed2toot automatically parses rss feeds, identifies new posts and posts them on the [Mastodon](https://mastodon.social) social network.
For the full documentation, [read it online](https://feed2toot.readthedocs.io/en/latest/).
2017-04-09 10:30:48 +02:00
If you would like, you can [support the development of this project on Liberapay](https://liberapay.com/carlchenet/).
Alternatively you can donate cryptocurrencies:
2017-09-04 09:55:38 +02:00
- BTC: 1AW12Zw93rx4NzWn5evcG7RNNEM2RSLmAC
2017-04-27 18:36:47 +02:00
- XMR: 43GGv8KzVhxehv832FWPTF7FSVuWjuBarFd17QP163uxMaFyoqwmDf1aiRtS5jWgCiRsi73yqedNJJ6V1La2joznKHGAhDi
2017-04-09 10:30:48 +02:00
### Quick Install
* Install Feed2toot from PyPI
# pip3 install feed2toot
* Install Feed2toot from sources
*(see the installation guide for full details)
[Installation Guide](http://feed2toot.readthedocs.io/en/latest/install.html)*
2017-04-09 10:30:48 +02:00
2019-08-27 19:08:33 +02:00
# tar zxvf feed2toot-0.12.tar.gz
2017-04-09 10:30:48 +02:00
# cd feed2toot
# python3 setup.py install
# # or
# python3 setup.py install --install-scripts=/usr/bin
### Create the authorization for the Feed2toot app
* Just launch the following command::
$ register_feed2toot_app
2017-04-09 10:30:48 +02:00
### Use Feed2toot
* Create or modify feed2toot.ini file in order to configure feed2toot:
[mastodon]
2017-04-10 10:59:53 +02:00
instance_url=https://mastodon.social
2017-04-09 10:30:48 +02:00
user_credentials=feed2toot_usercred.txt
client_credentials=feed2toot_clientcred.txt
; Default visibility is public, but you can override it:
; toot_visibility=unlisted
2017-04-09 10:30:48 +02:00
[cache]
cachefile=cache.db
[rss]
uri=https://www.journalduhacker.net/rss
toot={title} {link}
2017-04-09 10:30:48 +02:00
[hashtaglist]
several_words_hashtags_list=hashtags.txt
* Launch Feed2toot
$ feed2toot -c /path/to/feed2toot.ini
### Authors
* Carl Chenet <chaica@ohmytux.com>
* Antoine Beaupré <anarcat@debian.org>
* First developed by Todd Eddy
### License
This software comes under the terms of the GPLv3+. Previously under MIT license. See the LICENSE file for the complete text of the license.