A bot that posts images to the Fediverse https://blog.froth.zone/sam/the-end-of-an-era
This repository has been archived on 2023-05-27. You can view files and clone it, but cannot push or open issues or pull requests.
Find a file
Renovate Bot 1f05a046b0
All checks were successful
continuous-integration/drone/pr Build is passing
continuous-integration/drone/push Build is passing
Update dependency typescript to v4.8.4
2022-09-27 20:01:38 +00:00
.vscode Update dependencies 2022-05-09 17:23:29 +02:00
.yarn Update dependency typescript to v4.8.4 2022-09-27 20:01:38 +00:00
src revert JSON comments upgrade, make HTTP error more verbose 2022-07-30 16:06:08 +02:00
.drone.yml Fix pkg builds 2022-05-12 13:38:50 +02:00
.eslintignore Booru support (#1) 2022-03-15 19:13:35 +00:00
.eslintrc.json Booru support (#1) 2022-03-15 19:13:35 +00:00
.gitignore Update dependencies 2022-05-09 17:23:29 +02:00
.prettierignore Booru support (#1) 2022-03-15 19:13:35 +00:00
.yarnrc.yml Fix pkg builds 2022-05-12 13:38:50 +02:00
config.sample.jsonc Booru support (#1) 2022-03-15 19:13:35 +00:00
LICENSE Lint & Relicense 2022-06-11 14:11:33 +02:00
package.json Update dependency typescript to v4.8.4 2022-09-27 20:01:38 +00:00
README.md Update dependencies 2022-05-09 17:23:29 +02:00
renovate.json Update dependencies 2022-05-09 17:23:29 +02:00
tsconfig.json Update dependencies 2022-05-09 17:23:29 +02:00
yarn.lock Update dependency typescript to v4.8.4 2022-09-27 20:01:38 +00:00

fediverse-imagebot

Build Status

A bot that posts local and booru images to the Fediverse.

Compatible with Mastodon, Misskey and Pleroma!

MIGRATING MAJOR VERSIONS

See the wiki.

Boorus supported

The full list of boorus supported is found here.

Downloading the bot

There are currently two ways to do this, either with a pre-built binary or building from source. Both are listed below.

Downloading pre-built binaries

Download prebuilt binaries from here. (currently supports x86_64 and arm64 on Linux [glibc or musl], macOS and Windows)

  1. Run the bot with the -w flag to have it generate a configuration file to the local directory.

  2. Edit it for your use case.

  1. Run the bot by launching the executable!

Running from Source

  1. You need to have npm and nodejs installed.
  • Node 15 or greater is required.
  1. Install yarn:
    corepack enable
    Check https://yarnpkg.com/getting-started/install for more information.

  2. Clone the repository:
    git clone https://git.froth.zone/sam/fediverse-imagebot.git

  3. Install dependencies:
    yarn

  4. Build:
    yarn build

  5. Edit the config file:
    cp config.sample.jsonc config.jsonc

  6. Run the bot:
    yarn bot

You're done! The bot should post a local image to the fediverse instance of your choosing!

Automating the bot

TODO: Elaborate more

The bot can be automated to post images at set times using a cronjob.
Example cron configuration:

0 * * * * cd /path/to/fediverse-imagebot && /usr/local/bin/yarn bot -c ./config.sample.jsonc

This example will run the bot every hour on the hour with no message using images from the default images directory.

An example of this pleroma configuration can be found at https://froth.zone/rinbot.