MastodonBot/README.md
2024-12-17 21:06:42 +01:00

2.4 KiB

Mastodon-Bot

This is a bot which is built to post a daily message about mapcomplete-usage.

How it works

It fetches latest changesets from OsmCha, processes them and posts them to Mastodon.

Changesets which have the add-image-tag are downloaded from the OSM-api and crawled for images, of which some are picked to add to the posts.

Note that the image selection process is opinionated: some themes (artwork, nature, trees, ...) have a higher probability of being picked. Furthermore, it tries to pick at most one image per contributor - so images by the same contributor will only be used if there are more images to add than contributors.

Instances

There are currently two bot accounts using this code:

Enabling mentions

If you want to be mentioned by this bot:

  • [Edit your OSM profile], make it include <a href='https://<mastodon-host>/@<your-username/' rel='me'>My fediverse acount</a>
  • Make edits with MapComplete
  • On Mastodon, edit your profile. Put a link to your profile (https://www.openstreetmap.org/user/<your profile>) in the "extra fields":

image

  • Save the changes and inspect your mastodon profile. The link to your OSM-account should receive a checkmark (and might become green, depending on the mastodon client)

Disabling mentions

You can indicate this to the bot in the following way:

On Mastodon

  • You can mute or block the bot so that you won't see the posts. Your user account on OpenStreetMap or your Mastodon-username will still be mentioned in the posts
  • You can add the hashtag #nobot or #no-mapcomplete-bot to your profile description. The bot will not mention you with your Mastodon-handle, but it will still post your OSM-username, your pictures and a report of your contributions

On your OSM-user profile:

  • Add #no-bot or #no-mapcomplete-bot to your user profile and your contributions (map changes and pictures) will not be included in the bot at all
  • Add #nobotmention or #nomapcompletebotmention to your user profile. Your contributions and pictures will still be listed in the bot, with your OSM-username. However, your OSM-username will not be replaced by your Mastodon-handle, thus not pinging you.