# masto-bridges (formerly masto-gitsocial-bridge)

## CalDAV to Masto (and back again)

Post directly from your (CalDAV) calendar, and follow your feeds from your calendar!

See [config](#Config) below for how to set up for your calendar.

Compatible with mobile too!

![Post from your calendar, get your feed from your calendar](img/masto-caldav.png)

### From Calendar to Masto

Make a new calendar event with
- Event title/summary: your username `user@instance.com` or just `user`. Calendar entries that don't
  match your username will not be posted (since they aren't from you!)
- Notes/Description: The content of your post!
- Time, date, duration, repetition: don't matter for now!
- The absence of a URL in the "location" field is used to make sure we don't echo posts we make from the real masto

### From Masto to Calendar

When running `masto_bridgebot` with `MASTOBRIDGE_ENABLE_CALDAV=true` and 
`MASTOBRIDGE_STREAM_MODE="home"`, your home feed should already be posting to your calendar!

To make it so only your posts are added to your calendar, set the stream mode to `'list'`

## git-social

bridge between mastodon and bcrypt's [git-social](https://github.com/diracdeltas/tweets)

### From git to masto

Post on git-social...

![Post on git social: This is what we call infrastructure shitposting](img/git-to-masto_0.png)

Bridge to mastodon

![Post on mastodon, same text but with link to the git commit](img/git-to-masto_1.png)

### From masto to git

Post on mastodon...

![Post on mastodon: This is the future of decentralized communication](img/masto-to-git_0.png)

Bridge to git-social

![Post on git social: same post, but with link to tweet](img/masto-to-git_1.png)

# Features

Everything in this package is a bug and not a feature.

# Setup

## Installation

I'm not going to uh, make this good or put it on pypi or anything.

So you should clone this and install it with poetry, (otherwise
you have to modify the below `post-commit` action to activate the
venv where it is installed correctly)

```shell
git clone https://git.jon-e.net/jonny/masto-gitsocial-bridge
cd masto-gitsocial-bridge
poetry install
```

## Make masto token

~ check with your instance's policies before doing something bad like this ~

From your masto instance's homepage...

- Preferences (in hamburger menu top right if page is narrow)
- Development tab
- New Application

The bot needs permissions (I'm honestly not sure you need to give all of `read`, but 
`Mastodon.py`'s `me()` method seems to need a lot of them. idk.)
- `read`
- `write:lists` - the bot only streams your posts by making a list with just you on it
- `write:statuses` - to xpost, dummy!

Then copy the resulting access token for use in configuration...

## Config

See `masto_git_bridge.config.Config` for the required configuration values.

The config object uses Pydantic to load either from an `.env` file or 
from environment variables, for example, make an `.env` file in the cloned
repository directory like

```
MASTOBRIDGE_LOGDIR="/wherever/you/want/to/put/logs"

MASTOBRIDGE_MASTO_URL="https://social.coop"
MASTOBRIDGE_MASTO_TOKEN="<mastodon bot access token>"

MASTOBRIDGE_ENABLE_GIT=false
MASTOBRIDGE_GIT_REPO="/path/to/your/git-social/tweets"
MASTOBRIDGE_GIT_REMOTE_URL="https://git.jon-e.net/jonny/tweets"

MASTOBRIDGE_ENABLE_CALDAV=true
MASTOBRIDGE_CALDAV_URL="https://your.caldav.calendar/wherever"
MASTOBRIDGE_CALDAV_USER="<caldav username>"
MASTOBRIDGE_CALDAV_PASSWORD="<caldav password>"
MASTOBRIDGE_CALDAV_CALENDAR_NAME="<name of calendar to use for feeds and posts>"

# "home" (for streaming your home feed to bridges)
# or "list" for streaming a list with just your account in it to bridges
MASTOBRIDGE_STREAM_MODE="home" 

```

This is assuming you don't need any sort of authentication/local password
on your local git repository in order to commit or push to it.

## `post-commit` action

In your git-social repository, make a `post-commit` action (`.git/hooks/post-commit`)
that looks something like this (see the [sample](post-commit.sample))

```bash
#!/bin/bash
# Assuming we have installed the package using poetry from a git repository
# lmao I did not say we handled virtual environments well in this package

cd <path/to/masto-gitsocial-bridge>
poetry run post_last_commit

# otherwise activate whatever venv you have installed the package in and
# call masto_git_bridge.main:post_last_commit, which is
# installed as an entrypoint script by poetry
```

# Usage

The post-commit action should run anytime you commit a post to git-social, but to post
from mastodon you'll have to run the bot, which listens for your posts and reposts them to 
git-social (only if they are "public" or "unlisted").

```bash
poetry run masto_gitbot
# or 
# >>> poetry shell
# >>> masto_bridgebot
# or however else you run python entrypoint scripts
# hell you could do python -m masto_bridges.main:masto_gitbot
# i think?
```

# Warnings & Gotchas

If you ever enable this, you should promptly disable it