Metadata-Version: 2.1
Name: tootbot
Version: 5.1.0
Summary: A Python bot that looks up posts from specified subreddits and automatically posts them on Mastodon
Home-page: https://codeberg.org/MarvinsMastodonTools/tootbot
License: GPL-3.0-only
Author: marvin8
Author-email: marvin8@tuta.io
Requires-Python: >=3.7.3,<4.0.0
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: Mastodon.py (>=1.5.1,<2.0.0)
Requires-Dist: Pillow (>=9.0.1,<10.0.0)
Requires-Dist: arrow (>=1.2.2,<2.0.0)
Requires-Dist: asyncpraw (>=7.5.0,<8.0.0)
Requires-Dist: beautifulsoup4 (>=4.10.0,<5.0.0)
Requires-Dist: coloredlogs (>=15.0.1,<16.0.0)
Requires-Dist: gfycat (>=0.2.2,<0.3.0)
Requires-Dist: httpx (>=0.23.0,<0.24.0)
Requires-Dist: imgurpython (>=1.1.7,<2.0.0)
Requires-Dist: lxml (>=4.8.0,<5.0.0)
Requires-Dist: outdated (>=0.2.1,<0.3.0)
Requires-Dist: python-magic (>=0.4.25,<0.5.0)
Requires-Dist: rich (>=12.0.0,<13.0.0)
Requires-Dist: tqdm (>=4.64.0,<5.0.0)
Project-URL: Bug Tracker, https://codeberg.org/MarvinsMastodonTools/tootbot/issues
Project-URL: Changelog, https://codeberg.org/MarvinsMastodonTools/tootbot/src/branch/main/CHANGELOG.md
Project-URL: Repository, https://codeberg.org/MarvinsMastodonTools/tootbot
Project-URL: Wiki, https://codeberg.org/MarvinsMastodonTools/tootbot/wiki
Description-Content-Type: text/markdown

# Tootbot

This is a Python bot that looks up posts from specified subreddits and automatically posts them on [Mastodon][1].
It is based on [reddit-twitter-bot][2].

---

### !!! This version of Tootbot no longer supports posting to Twitter. !!!

If you need twitter functionality look into [reddit-twitter-bot][2] as a possible alternative.

### !!! This version of Tootbot no longer supports deleting old toots. !!!

If you'd like to delete older toots from your Mastodon account look into [MastodonAmnesia][3] as a tool that might
work for you.


---

**Features:**

* Tootbot posts to [Mastodon][1]
* Media from direct links, Gfycat, Imgur, Reddit, and Giphy is automatically attached in the social media post.
  Tootbot attaches up to the first 4 pictures for imgur albums and reddit gallery posts.
* Links that do not contain media can be skipped, ideal for meme accounts like [@babyelephantgifs][4]
* NSFW content, spoilers, and self-posts can be filtered
* Tootbot can monitor multiple subreddits at once
* Tootbot is fully open-source, so you don't have to give an external service full access to your social media accounts
* Tootbot also checks the sha256 checksum of media files to stop posting of the same media file from different subreddits.
* Tootbot can ping a [Healthchecks][5] instance for monitoring continuous operation of Tootbot
* Optionally throttle down frequency of tooting when mastodon errors are detected.

## Disclaimer

The developers of Tootbot hold no liability for what you do with this script or what happens to you by using this
script. Abusing this script *can* get you banned from Mastodon, so make sure to read up on proper usage of the API
for each site.

## Setup and usage

For instructions on setting up and using Tootbot, please visit [the wiki][6]

## Supporting Tootbot

There are a number of ways you can support Tootbot:

- Create an issue with problems or ideas you have with/for Tootboot
- You can [buy me a coffee][7].
- You can send me small change in Monero to the address below:

Monero donation address:
`87C65WhSDMhg4GfCBoiy861XTB6DL2MwHT3SWudhjR3LMeGEJG8zeZZ9y4Exrtx5ihavXyfSEschtH4JqHFQS2k1Hmn2Lkt`

[1]: https://joinmastodon.org/
[2]: https://github.com/rhiever/reddit-twitter-bot
[3]: https://pypi.org/project/mastodonamnesia/
[4]: https://botsin.space/@babyelephantgifs
[5]: https://healthchecks.io/
[6]: https://codeberg.org/MarvinsMastodonTools/tootbot/wiki
[7]: https://www.buymeacoffee.com/marvin8

