Metadata-Version: 2.4
Name: simplebot_mastodon
Version: 0.6.0
Summary: Mastodon/DeltaChat bridge.
Home-page: https://github.com/simplebot-org/simplebot_mastodon
Author: adbenitez
Author-email: adb@arcanechat.me
License: MPL
Keywords: simplebot plugin deltachat mastodon bridge
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Plugins
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Operating System :: OS Independent
Classifier: Topic :: Utilities
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: simplebot>=4.2.0
Requires-Dist: Mastodon.py>=2.0.1
Requires-Dist: html2text>=2024.2.26
Requires-Dist: beautifulsoup4>=4.13.3
Requires-Dist: requests>=2.32.3
Requires-Dist: pydub>=0.25.1
Requires-Dist: SQLAlchemy>=2.0.39
Provides-Extra: test
Requires-Dist: pytest>=8.3.5; extra == "test"
Provides-Extra: dev
Requires-Dist: simplebot>=4.2.0; extra == "dev"
Requires-Dist: Mastodon.py>=2.0.1; extra == "dev"
Requires-Dist: html2text>=2024.2.26; extra == "dev"
Requires-Dist: beautifulsoup4>=4.13.3; extra == "dev"
Requires-Dist: requests>=2.32.3; extra == "dev"
Requires-Dist: pydub>=0.25.1; extra == "dev"
Requires-Dist: SQLAlchemy>=2.0.39; extra == "dev"
Requires-Dist: pytest>=8.3.5; extra == "dev"
Requires-Dist: black>=25.1.0; extra == "dev"
Requires-Dist: mypy>=1.15.0; extra == "dev"
Requires-Dist: isort>=6.0.1; extra == "dev"
Requires-Dist: pylint>=3.3.6; extra == "dev"
Requires-Dist: pylama>=8.4.1; extra == "dev"
Requires-Dist: types-requests>=2.32.0.20250306; extra == "dev"
Requires-Dist: setuptools; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: summary

Mastodon Bridge
===============

.. image:: https://img.shields.io/pypi/v/simplebot_mastodon.svg
   :target: https://pypi.org/project/simplebot_mastodon

.. image:: https://img.shields.io/pypi/pyversions/simplebot_mastodon.svg
   :target: https://pypi.org/project/simplebot_mastodon

.. image:: https://pepy.tech/badge/simplebot_mastodon
   :target: https://pepy.tech/project/simplebot_mastodon

.. image:: https://img.shields.io/pypi/l/simplebot_mastodon.svg
   :target: https://pypi.org/project/simplebot_mastodon

.. image:: https://github.com/simplebot-org/simplebot_mastodon/actions/workflows/python-ci.yml/badge.svg
   :target: https://github.com/simplebot-org/simplebot_mastodon/actions/workflows/python-ci.yml

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
   :target: https://github.com/psf/black

A Mastodon <-> DeltaChat bridge plugin for `SimpleBot`_.

If this plugin has collisions with commands from other plugins in your bot, you can set a command prefix like ``/masto_`` for all commands::

  simplebot -a bot@example.com db -s simplebot_mastodon/cmd_prefix masto_

Install
-------

To install run::

  pip install simplebot-mastodon

User Guide
----------

To log in with OAuth, send a message to the bot::

  /login mastodon.social

replace "mastodon.social" with your instance, the bot will reply with an URL that you should open to grant access to your account, copy the code you will receive and send it to the bot.

To log in with your user and password directly(not recommended)::

  /login mastodon.social me@example.com myPassw0rd

Once you log in, A "Home" and "Notifications" chats will appear, in the Home chat you will receive your Home timeline and any message you send there will be published on Mastodon. In the Notifications chat you will receive all the notifications for your account.

If someone sends you a direct message in a private 1:1 conversation, it will be shown as a new chat where you can chat in private with that person, to start a private chat with some Mastodon user, send::

  /dm friend@example.com

and the chat with "friend@example.com" will pop up.

To logout from your account::

  /logout

For more info and all the available commands(follow, block, mute, etc), send this message to the bot::

  /help


.. _SimpleBot: https://github.com/simplebot-org/simplebot
