160 lines
No EOL
4.9 KiB
Markdown
160 lines
No EOL
4.9 KiB
Markdown
# 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!
|
|
|
|
|
|
|
|
### 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...
|
|
|
|
|
|
|
|
Bridge to mastodon
|
|
|
|
|
|
|
|
### From masto to git
|
|
|
|
Post on mastodon...
|
|
|
|
|
|
|
|
Bridge to git-social
|
|
|
|
|
|
|
|
# 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 |