Skip to content

Latest commit

 

History

History
62 lines (44 loc) · 3.31 KB

README-Mastodon.md

File metadata and controls

62 lines (44 loc) · 3.31 KB
Raw

Send a Mastodon Post for each new vessel in VesselAlert

This utility enables sending Mastodon posts of new events. Ever since Twitter started to restrict posting about locations of vessels, are encouraging people to post to Mastodon,

There are two major parts to install this. Each of these parts is described below.

  • You must have a Mastodon account and create an Application in it.
  • You must follow the instructions below to configure VesselAlert to use the credentials that Mastodon provides you during this sign-up process.

Signing up for a Mastodon Account and creating an Application

Mastodon is a distributed social media service. This means, that you have your choice of Mastodon servers to create and maintain your account on. Any of them will work (as long as they allow bots), but we recommend joining this one. It's the one where many of us post results of our SDR and radio reception endeavors: https://airwaves.social/

Once you have an account, please do the following:

  • On the bottom left, click </> Development

  • Create a new Application by clicking the button, then:
    • Give it a name (for example, "VesselAlert")
    • Add a URL (if you don't have one, use something like "https://airwaves.social/@myhandle" (replace myhandle by your Mastodon handle))
    • Make sure that the following scopes are selected (important!!!): read, write, follow
    • Press Submit at the bottom of the page image

image

  • Open the Application and (important!!!) note the Access Token image

image

Configuring VesselAlert to use Mastodon

Please set the following parameters in your docker-compose.yml file:

MASTODON_SERVER=airwaves.social
MASTODON_ACCESS_TOKEN=vsafdwafewarewdcvdsafwaefaewfdw
MASTODON=ON

Replace by the applicable server name and access token. For other parameters, see the included sample docker-compose.yml.

Summary of License Terms

Copyright (C) 2022-2023, Ramon F. Kolb (kx1t)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.