Metadata-Version: 2.4
Name: mastodon-notifications-to-email
Version: 0.1.0
Summary: Send Mastodon/GoToSocial notifications as emails
License-Expression: MIT
Project-URL: Homepage, https://codeberg.org/eht16/mastodon_notifications_to_email
Project-URL: Bug Tracker, https://codeberg.org/eht16/mastodon_notifications_to_email/issues
Keywords: mastodon,gotosocial,notification
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Communications
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Mastodon.py
Requires-Dist: markdownify
Dynamic: license-file

# Mastodon Notifications To Email

Send Mastodon/GoToSocial notifications as emails.

The generated emails look similar to the notification emails sent by Mastodon.
Some Mastodon-like platform implementations like GoToSocial do not send notifications
via email by itself and then this small script comes into play.

It can be used as cronjob or long running process, e.g. with Systemd or in a Docker container.

## Installation and setup

mastodon_notifications_to_email requires Python 3.11 or newer.
The easiest method is to install directly from pypi using pip:

    pip install mastodon-notifications-to-email

Dependencies:
  - Mastodon.py
  - markdownify

Alternatively, you can skip installation and just execute the script:

    uv run mastodon_notifications_to_email

Before using mastodon_notifications_to_email, you need to create a configuration file called
`mastodon_notifications_to_email.conf`. mastodon_notifications_to_email will search
for the file in the following locations (in that order):

  - ~/.config/mastodon_notifications_to_email.conf
  - mastodon_notifications_to_email.conf (in current working directory)

An example configuration file can be found in the sources or online
at https://codeberg.org/eht16/mastodon_notifications_to_email/raw/branch/master/mastodon_notifications_to_email.conf.example.

For details on the configuration options, consider the comments in the
example configuration file.

## Usage

Run only once (e.g. as cronjob):

    mastodon_notifications_to_email

Run in foreground:

    mastodon_notifications_to_email -f

### Command line options

    usage: mastodon_notifications_to_email.py [-h] [-v] [-f] [-c FILE]

    options:
      -h, --help         show this help message and exit
      -v, --verbose      Show more log messages (default: False)
      -f, --foreground   Keep running in foreground (default: False)
      -c, --config FILE  configuration file path (default: None)

## Disclaimer

Use this tool at your own risk only.
There is no warranty at all.

## Author

Enrico Tröger <enrico.troeger@uvena.de>
