https://github.com/aschuma/air_tweets
Stay informed on air quality with this simple bot, which posts real-time updates from a configurable sensor on the https://sensor.community network to Mastodon and Bluesky. See it in action by following #feinstaub and #cannstatt on https://mastodon.online/@aschuma or https://bsky.app/profile/aschuma.bsky.social
https://github.com/aschuma/air_tweets
air-quality airrohr bluesky-bot bot feinstaub feinstaubalarm luftdaten mastodon mastodon-bot particulate-matter pm10 python sensor-data
Last synced: 4 days ago
JSON representation
Stay informed on air quality with this simple bot, which posts real-time updates from a configurable sensor on the https://sensor.community network to Mastodon and Bluesky. See it in action by following #feinstaub and #cannstatt on https://mastodon.online/@aschuma or https://bsky.app/profile/aschuma.bsky.social
- Host: GitHub
- URL: https://github.com/aschuma/air_tweets
- Owner: aschuma
- License: mit
- Created: 2018-01-21T21:00:01.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2025-07-08T18:46:03.000Z (3 months ago)
- Last Synced: 2025-10-03T22:38:34.444Z (10 days ago)
- Topics: air-quality, airrohr, bluesky-bot, bot, feinstaub, feinstaubalarm, luftdaten, mastodon, mastodon-bot, particulate-matter, pm10, python, sensor-data
- Language: Python
- Homepage: https://aschuma.github.io/air_tweets/
- Size: 681 KB
- Stars: 5
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
```
:::. ::: :::::::.. ::::::::::::.:: . .:::.,:::::: .,:::::::::::::::::: .::::::.
;;`;; ;;; ;;;;``;;;; ;;;;;;;;''''';;, ;; ;;;' ;;;;'''' ;;;;'''';;;;;;;;'''';;;` `
,[[ '[[, [[[ [[[,/[[[' [[ '[[, [[, [[' [[cccc [[cccc [[ '[==/[[[[,
c$$$cc$$$c $$$ $$$$$$c $$ Y$c$$$c$P $$"""" $$"""" $$ ''' $
888 888, 888 888b "88bo, 88, "88"888 888oo,__ 888oo,__ 88, 88b dP
YMM ""` MMM MMMM "W" MMM "M "M" """"YUMMM""""YUMMM MMM "YMmMY"
```
# Tweets air quality measurement results of particulate matter (Feinstaub) (http://luftdaten.info)
This source code is for a Mastodon / Bluesky bot that monitors particulate matter (Feinstaub) for a single sensor from the https://sensor.community network. The bot will automatically publish a tweet when the PM10 particulate matter exceeds a configurable threshold, such as 50 µg/m³."
A tweet might look like this:
This repository provides a cron job written in python 3. After a tweet submission no further tweets
are created for a configurable period.
# Installation
- Create a Mastodont account, obtain an access token, see https://docs.joinmastodon.org/client/token for further details.
- Make sure python 3 is installed on your dev machine.
- Clone this repository
- Create a virtual environment, you may obtain more information about the steps below here: http://docs.python-guide.org/en/latest/dev/virtualenvs/
```
virtualenv venv -p /usr/bin/python3
source venv/bin/activate
pip3 install -r requirements.txt
```
- Copy the file ```config.py-template``` to ```config.py```, adjust the setup. At least you should alter the following values as starting point.
```
# database, last tweet timestamp
conf_storage = "/tmp/.air_tweet"
# the sensor IDs (temperature is optional. If you provide an ID, consider updating the templates accordingly)
conf_particle_sensor_id = 90887
conf_temperature_sensor_id = None
# url used to fetch the avg sensor of the last hour
[..]
# sensor graph grafana image to embed in the tweet (optional)
# conf_luftdaten_graph_url = "http://192.168.0.43:3000/render/d-solo/eDF152mRk/twitter?panelId=2&orgId=1&from={}&to={}&width=800&height=500&tz=UTC%2B02%3A00"
conf_luftdaten_graph_url = None
conf_luftdaten_graph_mime_type = "image/png"
# PM 10 limit
conf_limit_pm_10_0 = 50
# stuff to embed in the tweet - link to sensor community map
conf_luftdaten_map_url = "https://maps.sensor.community/#15/48.8040/9.2280"
# quiet period after a tweet has been published
conf_quiet_period_in_hours = 6
# mastodon credentials
mastodon_enabled = True
mastodon_api_base_url = 'https://mastodon.online'
mastodon_access_token = ''
# bluesky credentials
bluesky_enabled = False
bluesky_handle = '....bsky.social'
bluesky_password = '...'
[..]
```
- Setup a cron job
```
*/15 * * * * cd /home/pi/projects/air_tweets && venv/bin/python tweet.py > /dev/null 2>&1
```
# Contribution
Please feel free to issue a bug report or submit a PR. Any helping hand is welcome.
Be aware that my primary coding language is Java. So currently some code portions might not follow python best practices.