Post cool planes to fedi!
  • Python 88.6%
  • Shell 11.4%
Find a file
2026-05-03 16:42:20 +02:00
.gitignore Initial commit 2026-03-26 20:24:23 +01:00
cooldown.json empty file for initial start 2026-04-06 22:39:46 +02:00
fedi-plane-bot.service fixed stupid messup with variable naming 2026-04-07 00:07:31 +02:00
fedi-plane-bot.timer added timer and servive to run bot regularly 2026-04-02 15:50:22 +02:00
geo_measures_regs.txt added registries of known geo and calibaraiton flights 2026-04-06 22:35:42 +02:00
get_data.sh this is gonna get ugly, i should try that in python 2026-03-26 22:23:00 +01:00
ideas.txt curls for locations 2026-04-07 00:07:51 +02:00
interesting_planes.txt.model moved from Model names to Type Designators 2026-04-02 22:47:36 +02:00
LICENSE Initial commit 2026-03-26 20:24:23 +01:00
README.md updated readme 2026-04-02 19:22:11 +02:00
req.py made url http 2026-05-03 15:51:18 +02:00
start.sh added env vars 2026-05-03 16:41:50 +02:00
type_designators.txt added new plane and helicopter types 2026-05-03 16:42:20 +02:00

planes-fedi-bot

Post cool planes to fedi!

The idea

Idea is, that the account looks like Gaige is out plane spotting and posts when she sees certain planes. These planes are listed in interesting_planes.txt. The focus point where she looks for planes is near EDDF (Frankfurt international airport) with a range of 50 nautical miles around that point.

As data foundation serves the airplanes.live API since it is free and has basically no rate limiting (one request per second). This will lead to uncensored, yet occasionally incomplete data when compared to other plane tracking services.

The bot (or rather little lump of python code) is written with a GoToSocial instance in mind, but since GTS uses the Mastodon API it should work with other activitypub instances as well.

Future

ToDos

  • Add a cooldown of 3h, so that Gaige doesn't post about the same plane twice

  • systemd timer to make the bot run periodically, as of now 15mins is the target

  • Expand the text Gaige posts to make it more suited to the plane she sees, adding more variety

  • Change the initial filtering from Models to ICAO Type Designators to cover more Models with less effort

Gaige, you and me get to learn Type Designators of planes :3c