Coder Social home page Coder Social logo

hajekr / aurora-forecast Goto Github PK

View Code? Open in Web Editor NEW
5.0 1.0 0.0 1.4 MB

Provides on-demand 3-day forecast of Kp index for Garmin InReach devices.

Python 86.56% Dockerfile 8.48% Shell 4.95%
garmin aurora inreach inreach-messages auroraborealis

aurora-forecast's Introduction

Aurora Forecast for Garmin inReach

Provides on-demand 3-day forecast of Kp index for Garmin InReach devices.

Know a chance of northern lights observation even in remote places.

Aurora observed in Urho Kekkonen NP

How to use for free

From Garmin inReach device, send an email with an arbitrary text to [email protected] recipient.

Within 10 minutes, you will get message with Kp index forecast.

Kp for 3hr blocks UTC time.
12/03: 54312222
13/03: 21111134
14/03: 56444334

Data is sourced from NOAA Geomagnetic Activity Observation and Forecast.

As you can see in source report, each number represents forecast for 3-hour window, e.g. 00-03, 03-06, etc. Time is in UTC, so you'll need to recalculate for your position. For example Finland is 2 hours ahead of UTC, so first number represents 02-05 window.

If you want to save fees for outgoing message, you can add email above as a recipient of a preset message. I usually need only 2 preset messages - to notify start and end of the hike, so third one can be reserved to get aurora forecast if weather conditions are favorable that night. For incoming message, 1 text message is spent from your inReach credit.

Service is provided for free, since it only uses free tier services and open data source.

I provide no guarantee, should there be any issue with the service, please report.

How it works

Message from inReach device is delivered to email with accompanying information about position and link to Garmin map, which allows reply to the message.

Email address mentioned above is periodically scanned for new incoming message. Content of the message is ignored, but link to Garmin map is used to send a reply with current aurora forecast.

Every email is replied once, but you can request multiple forecasts per day.

How to run own service

You may consider information provided in inReach message as sensitive. It contains your location and provides link with reply form which can be misused.

If you prefer to keep messages in own mailbox, you can simply run your own service. Just send inReach message to your own email and schedule provided notify-aurora.py script to check for inReach emails and reply to them.

Script can be deployed and scheduled for free with Heroku. As an email, you can use any free mail service providing IMAP access. I recommend creating dedicated email and not using regular personal email for security reasons.

If using the script as-is, you'll need to provide following environment variables for email access:

  • IMAP_URL - url of IMAP server of your email provider, e.g. imap.gmail.com
  • IMAP_LOGIN - login for IMAP (usually your email address)
  • IMAP_PASSWORD - password for IMAP (usually your email password)

How to improve

Do you have any questions?

Do you have any ideas for improvement?

Feel free to leave a comment or open a pull request in GitHub repo.

aurora-forecast's People

Stargazers

 avatar  avatar  avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.