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 Twitter and Mastodon. See it in action by following #feinstaub and #cannstatt on https://mastodon.online/@aschuma or https://twitter.com/twaschuma
:::. ::: :::::::.. ::::::::::::.:: . .:::.,:::::: .,:::::::::::::::::: .::::::.
;;`;; ;;; ;;;;``;;;; ;;;;;;;;''''';;, ;; ;;;' ;;;;'''' ;;;;'''';;;;;;;;'''';;;` `
,[[ '[[, [[[ [[[,/[[[' [[ '[[, [[, [[' [[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"
This source code is for a Mastodon or Twitter 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.
⚠️ The Twitter support will be deprecated some time in the future. Please refer to the ‘r3.0.0’ tag to access the latest functioning code for Twitter.
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
conf_particle_sensor_id = 609
conf_temperature_sensor_id = 610
# url used to fetch the avg sensor of the last hour
conf_url_pm_sensor = "http://api.luftdaten.info/static/v2/data.1h.json"
conf_url_th_sensor = "http://api.luftdaten.info/static/v2/data.1h.json"
# sensor graph to embed in the tweet, provided for example by a graphana image renderer
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_mime_type = "image/png"
# PM 10 limit
conf_limit_pm_10_0 = 50
# quiet period after a tweet has been published
conf_quiet_period_in_hours = 6
# stuff to embed in the tweet
conf_luftdaten_map_url = "http://deutschland.maps.luftdaten.info/#13/48.8066/9.2372"
conf_msg_preamble = "#feinstaub in #cannstatt:"
# twitter credentials
twitter_enabled = True
twitter_consumer_key = 'Abq...'
twitter_consumer_secret = 'nep...'
twitter_access_token = '43...'
twitter_access_token_secret = 'pq...'
# mastodon credentials
mastodon_enabled = True
mastodon_api_base_url = 'https://mastodon.online'
mastodon_access_token = 'sE98...'
Setup a cron job
*/15 * * * * cd /home/pi/projects/air_tweets && venv/bin/python tweet.py > /dev/null 2>&1
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.