fediplug/README.md
Nova e32a092e6a
Switch to Poetry for dependency and venv management (#20)
Co-authored-by: Mæve Rey <42996147+m-rey@users.noreply.github.com>
2023-03-02 22:43:11 +01:00

1.2 KiB

fediplug

A Mastodon client that automatically vibrates your buttplug.io devices as people on your timeline toot instructions.

getting started

Use poetry install from Poetry to install the Python dependencies and set up the fediplug script inside the virtual environment.

You can use the fediplug script with either poetry run fediplug or by entering the Pipenv shell with poetry shell and just running fediplug.

registering and logging in

To register fediplug to your instance, use fediplug register example.com.

To log in to your instance, use fediplug login example.com.

streaming

Use fediplug stream example.com to start the stream. You'll need to log in the first time.

Toots that include the hashtag #fediplug will trigger the buttplug.io device.

If new #fediplug toots come in while instructions are being executed, they will be queued and executed later.

If there's a recent #fediplug toot in your timeline, it'll be pulled up and executed before the stream starts.

filtering

You can also filter instructions by user, so only their instructions are executed. Just add them to the command line after the server name, e.g. fediplug stream example.com @user @otheruser@example.net.