44340fde8f
* added poc * added check for sqlite db * added events test * draft docker-compose-test.yml * improved docker-compose * added support for postgres migrations * add documentation * added some qol to migrations * added migration generation script * removed settings.toml * waiting for postgress in script * commented script * added sample web config * fixed tests * mock memory db * reviewed PR |
||
---|---|---|
.github/workflows | ||
api_documentation | ||
doc | ||
etc | ||
mobilizon_reshare | ||
sample_settings/docker_web | ||
scripts | ||
tests | ||
.coveragerc | ||
.envrc | ||
.gitignore | ||
.pre-commit-config.yaml | ||
.pre-commit-hooks.yaml | ||
Dockerfile | ||
LICENSE | ||
README.md | ||
README.rst | ||
channels-lock.scm | ||
docker-compose-migration.yml | ||
docker-compose-web.yml | ||
docker-compose.yml | ||
guix.scm | ||
manifest.scm | ||
poetry.lock | ||
pyproject.toml | ||
settings.toml | ||
setup.cfg |
README.md
The goal of mobilizon_reshare
is to provide a suite to reshare Mobilizon events on a broad selection of platforms. This
tool enables an organization to automate their social media strategy in regards
to events and their promotion.
Platforms
mobilizon-reshare
currently supports the following social platforms:
- Mastodon
- Telegram
- Zulip
Usage
Scheduling and temporal logic
The tool is designed to work in combination with a scheduler that executes it at
regular intervals. mobilizon_reshare
allows fine-grained control over the logic to decide when
to publish an event, with the minimization of human effort as its first priority.
Installation
mobilizon_reshare
is distributed through Pypi and DockerHub. Use
$ pip install mobilizon-reshare
to install the tool in your system or virtualenv.
This should install the command mobilizon-reshare
in your system. Use it to access the CLI and discover the available
commands and their description.
Guix package
If you run Guix you can install mobilizon-reshare
by adding our Guix channel to your .config/guix/channels.scm
.
To run mobilizon-reshare
from master you can run the following command from the root of the repository:
$ guix time-machine -C channels-lock.scm -- install -L . mobilizon-reshare.git
Run on your local system
Once you have installed mobilizon_reshare
you can schedule the refresh from Mobilizon with your system's cron
:
$ sudo crontab -l
*/15 * * * * mobilizon-reshare start
Deploying through Docker Compose
To run mobilizon_reshare
in a production environment you can use the image published to DockerHub. We also provide an example docker-compose.yml
.
Contributing
We welcome contributions from anybody. Currently our process is not structured but feel free to open or take issues through Github in case you want to help us. We have setup some instructions to setup a development environment here.