{"id":20960575,"url":"https://github.com/natronics/iss-notify","last_synced_at":"2025-06-12T15:38:42.362Z","repository":{"id":136468164,"uuid":"1868391","full_name":"natronics/ISS-Notify","owner":"natronics","description":"Lights up when the International Space Station is overhead","archived":false,"fork":false,"pushed_at":"2014-09-07T18:30:46.000Z","size":839,"stargazers_count":48,"open_issues_count":0,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-14T07:34:52.290Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/natronics.png","metadata":{"files":{"readme":"README.markdown","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-06-08T23:58:29.000Z","updated_at":"2023-10-21T13:33:20.000Z","dependencies_parsed_at":"2023-03-12T16:21:09.054Z","dependency_job_id":null,"html_url":"https://github.com/natronics/ISS-Notify","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/natronics/ISS-Notify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natronics%2FISS-Notify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natronics%2FISS-Notify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natronics%2FISS-Notify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natronics%2FISS-Notify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/natronics","download_url":"https://codeload.github.com/natronics/ISS-Notify/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natronics%2FISS-Notify/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259494950,"owners_count":22866597,"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","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":[],"created_at":"2024-11-19T01:59:37.652Z","updated_at":"2025-06-12T15:38:42.336Z","avatar_url":"https://github.com/natronics.png","language":"Python","readme":"This is an old software project that puts an icon on certain linux desktops.\n\n**Looking for the light-up hardware project? See:**\n\n# \u003chttps://github.com/open-notify\u003e\n\n\n\n### Python Gnome-Panel Applet for International Space Station Passes\n\nThis is a quick and dirty python app that runs in the Gnome panel and acts as an alarm for when the [Internations Space Station](http://en.wikipedia.org/wiki/International_Space_Station) is overhead.\n\nWhen loaded it downloads a list of upcoming passes from [heavens-above.com](http://heavens-above.com).  It then goes to sleep and the next time the ISS is overhead it turns red and, optionally, lights LED's on an ardruino.\n\n\n### To install:\n\nMake sure you have the right packages installed\n\n    $ sudo apt-get install python python-gnomeapplet python-serial\n\nThen install it\n\n    $ sudo ./install.sh\n\nAfter the gnome pannel restarts right click and choose \"add to panel\". ISS-Notify should appear in the list.\n\n### To update:\n\nGet the latest code (`git pull`) then remove the applet from your panel if it's running and try\n\n    $ sudo ./uninstall.sh\n    $ sudo ./install.sh\n\n### To uninstall:\n\n    $ sudo ./uninstall.sh\n\n### To test:\n\n    $ ./ISS-notify-applet.py -debug\n \nThis will run the applet in it's own window and you can see print statements in the terminal you called if from. Great for debuging.  \n\n### Setting your location:\n\nFind this line in ISS-notify-applet.py\n\n    class PyApplet():\n      ha = HeavensAbove(45.47361, -122.64931, 100, \"PST\")\n\nand change the latitude and longitude to your location.\n\n    ha = HeavensAbove(latitude, longitude, altitude, timezone)\n\n### Connection to notification lamp\n\nSee the circuit diagram and firmware in the arduino folder. You might have to set some udev rules to get a predictable name for the python app.\n\nFind this line in ISS-notify-applet.py\n\n    class lamp():\n      device = '/dev/ttyACM0'\n\nMake `/dev/ttyACM0` the right thing (`dmesg | tail` is often useful). Example of the udev rule that worked for me\n\n    SUBSYSTEMS==\"usb\", ATTRS{idVendor}==\"16c0\", ATTRS{idProduct}==\"04[789]?\", MODE:=\"0666\"\n    KERNEL==\"ttyACM*\", ATTRS{idVendor}==\"16c0\", ATTRS{idProduct}==\"04[789]?\", SYMLINK+=\"ttyUSB00%n\", MODE:=\"0666\", ENV{ID_MM_DEVICE_IGNORE}=\"1\"\n\n### License\n\n\u0026copy; 2011 [Nathan Bergey](http://twitter.com/natronics)\n\nThis program is free software; you can redistribute it and/ormodify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.\n \nThis program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details at \u003chttp://www.gnu.org/copyleft/gpl.html\u003e\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatronics%2Fiss-notify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnatronics%2Fiss-notify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatronics%2Fiss-notify/lists"}