{"id":15792804,"url":"https://github.com/marioruiz/aurora-detector","last_synced_at":"2025-09-13T07:44:27.296Z","repository":{"id":98522609,"uuid":"126321572","full_name":"MarioRuiz/aurora-detector","owner":"MarioRuiz","description":"Using a 360 camera, Ricoh Theta S, and some ruby code, we can detect when a northern light is shining on the sky, take a picture, record a video, notify by email, twitter...","archived":false,"fork":false,"pushed_at":"2018-03-28T15:07:33.000Z","size":20,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-07T10:53:11.370Z","etag":null,"topics":["360","360-photo","aurora","image-processing","ruby"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MarioRuiz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-22T10:55:16.000Z","updated_at":"2023-10-21T23:02:18.000Z","dependencies_parsed_at":"2023-04-18T11:58:28.860Z","dependency_job_id":null,"html_url":"https://github.com/MarioRuiz/aurora-detector","commit_stats":{"total_commits":5,"total_committers":2,"mean_commits":2.5,"dds":"0.19999999999999996","last_synced_commit":"7e9007fa2a9592f8014dddcb5041b23204675c43"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MarioRuiz/aurora-detector","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarioRuiz%2Faurora-detector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarioRuiz%2Faurora-detector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarioRuiz%2Faurora-detector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarioRuiz%2Faurora-detector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MarioRuiz","download_url":"https://codeload.github.com/MarioRuiz/aurora-detector/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MarioRuiz%2Faurora-detector/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274935969,"owners_count":25376834,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["360","360-photo","aurora","image-processing","ruby"],"created_at":"2024-10-04T23:04:42.223Z","updated_at":"2025-09-13T07:44:27.267Z","avatar_url":"https://github.com/MarioRuiz.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aurora Detector\n\nDetects using a 360 camera if a northern light is showing in the sky and take the actions you want: take a picture, video, notify on twitter...\n\nSince we use a 360 camera the whole sky is analyzed just with one picture.\n\nThe Aurora Detector is only working from sunset to sunrise and in case it is not completely cloudy.\n\nAnalyzes only the part of the picture that could be considered the sky.\n\n## Setup\n\n### What you need\n\n* 360 Camera. I'm using a Ricoh Theta S but can be easily adapted to the one you choose. Open Spherical Camera API from Google: https://developers.google.com/streetview/open-spherical-camera/\n* A charger for the camera (can disconnect the WIFI connection) or a battery bank.\n* Since the camera will be outside I recommend a cover case and maybe some heating system.\n* A computer (Raspberry 3 for example) with WIFI connection and internet connection not using the same WIFI connection, for example, Ethernet\n\n### Installation\n* Install Ruby 2.4+ on the computer\n* Install mini_magick gem: https://github.com/minimagick/minimagick\n* Download the project from github\n* Edit aurora_detector_settings.rb at your convinience\n\n```ruby\n# to get the latitude and longitude of your location:\n# https://mynasadata.larc.nasa.gov/latitudelongitude-finder/\nLATITUDE = 64.126521\nLONGITUDE = -21.817439\n\n# To be able to know the weather conditions get it on\n# https://openweathermap.org/appid\nWEATHER_API_KEY = \"xxxx\"\n\n# percentage from top of the captured image to analyze (sky)\nHORIZON = 35\n\n# under this percentage of clouds we will analyze the sky\nCLOUDY_LIMIT = 70\n\n# Shutter speed: between 5-25 seconds. 5 when auroras moving fast\nSHUTTER_SPEED = 5\n\n# ISO sensitivity: 1600\nISO = 1600\n```\n\n## Using it\n1. Turn on the Ricoh Theta S camera, be sure WIFI is on.\n2. Connect to the WIFI of the camera from the computer\n3. Be sure you have internet connection on the computer using a network cable for example\n4. In command line go to your Aurora Detector folder and run in command line:\n```\nruby aurora_detector.rb\n```\n\nThe logs file will be created: aurora_detector.log\n\nIn case it is later than the sunset time but earlier than the sunrise time the Aurora Detector will be analyzing the sky searching for northern lights.\n\nThe last image taken to analyze will be in files folder with the name image.jpg\n\nIn case an aurora is detected then it will be called the method 'alert' and it will be taken pictures for three minutes every 10 or 20 seconds, depending on how strong is the northern light. \n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/marioruiz/aurora-detector\n\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarioruiz%2Faurora-detector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarioruiz%2Faurora-detector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarioruiz%2Faurora-detector/lists"}