{"id":17967824,"url":"https://github.com/simonprickett/iss-tracker","last_synced_at":"2026-03-05T22:33:39.594Z","repository":{"id":209905540,"uuid":"725231586","full_name":"simonprickett/iss-tracker","owner":"simonprickett","description":"ISS Tracker Project for small device front ends e.g. Pimoroni Badger 2040W, Pimoroni GFX Pack, others...","archived":false,"fork":false,"pushed_at":"2025-03-31T12:25:57.000Z","size":270,"stargazers_count":10,"open_issues_count":4,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-31T13:42:06.560Z","etag":null,"topics":["badger2040w","google-cloud-functions","google-geocoding-api","iss","micropython","nodejs","space-station"],"latest_commit_sha":null,"homepage":"","language":"Python","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/simonprickett.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":"2023-11-29T17:57:33.000Z","updated_at":"2025-03-31T13:18:32.000Z","dependencies_parsed_at":"2023-11-29T19:26:13.280Z","dependency_job_id":"f32fe923-6663-45e3-87a7-7a7bd13383d3","html_url":"https://github.com/simonprickett/iss-tracker","commit_stats":null,"previous_names":["simonprickett/iss-tracker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/simonprickett/iss-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonprickett%2Fiss-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonprickett%2Fiss-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonprickett%2Fiss-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonprickett%2Fiss-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simonprickett","download_url":"https://codeload.github.com/simonprickett/iss-tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonprickett%2Fiss-tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30152903,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T21:15:50.531Z","status":"ssl_error","status_checked_at":"2026-03-05T21:15:11.173Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["badger2040w","google-cloud-functions","google-geocoding-api","iss","micropython","nodejs","space-station"],"created_at":"2024-10-29T14:09:48.608Z","updated_at":"2026-03-05T22:33:39.552Z","avatar_url":"https://github.com/simonprickett.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ISS Tracker\n\nTODO introduction and architecture.\n\nHere it is running on the Badger 2040w device...\n\n![Project running on a Badger 2040w device](running_on_badger.jpg)\n\nI did a live stream about this project: [Watch it here](https://www.youtube.com/watch?v=zSsMsijupz0) and don't forget to subscribe and get notified whenever I'm live.  Thanks!\n\n## Back End Cloud Function\n\nTODO\n\n### Deploying to Google Cloud\n\nTODO commentary on how this works...\n\n```\ncd cloud-functions/iss-locator\ngcloud functions deploy isslocator --gen2 --runtime=nodejs18 --source=. --entry-point=isslocator --trigger-http --region=europe-west2 --set-env-vars GEONAMES_USER=your_geonames_account,GEOCODER_API_KEY=your_google_api_key,CLIENT_PASSPHRASES=\"valid_passphrase_1|valid_passphrase_2|valid_passphrase_n\"\n```\n\n## Front End for Pimoroni Badger 2040w\n\nTODO\n\n### Copying Files to the Device\n\nFirst, delete all existing files from your Badger 2040w.  Then copy all of the following to the root of the Badger 2040w's filesystem:\n\n* `phew` (folder plus all files contained in it)\n* `templates` (folder plus all files contained in it)\n* `config.py`\n* `iss.jpg`\n* `main.py`\n* `worldmap.jpg`\n\n### Configuration\n\nEdit the copy of `config.py` that is on your device.  Change the following lines:\n\n```\nISS_SERVICE_URL=\"YOUR CLOUD FUNCTION URL HERE\"\n```\n\nReplace the placeholder text with the full URL to your Google Cloud function, for example `https://europe-west2-someorg.cloudfunctions.net/isslocator/`.\n\n```\nISS_SERVICE_PASSPHRASE=\"YOUR CLOUD FUNCTION ACCESS TOKEN HERE\"\n```\n\nReplace the placeholder text with one of the client passphrase values you configured when deploying your Google Cloud function.\n\nGive your device a unique ID so that it can be identified more easily in Google Cloud when it calls the Cloud Function to get the ISS position.  Replace this with your choice of device ID (e.g. `mydevice` or `1234`).\n\n```\nDEVICE_ID=\"YOUR DEVICE ID HERE\"\n```\n\n### Setup Process\n\nReset the Badger 2040w to start the setup process.  It should start up and expose a WiFi access point whose SSID is \"ISSTracker\".\n\nConnect to this with your phone and follow the setup process in the web portal that pops up.  You'll need to provide your WiFi SSID and password as well as your location's latitude and longitude values.\n\nSave the changes in the form using the \"Save Settings\" button.  The device should reboot and attempt to connect to your network.  If successful, it should start to track the International Space Station.\n\nIf the device can't connect to your WiFi network or you provided incorrect details, it will display an error message.  Press both the A and C buttons together to reset it and try again.\n\n### Reset Process\n\nIf you need to change the WiFi details (because you've take the device somewhere else for example) or you want to change your location, press both the A and C buttons while on the map screen to reset the device.\n\n### Limitations\n\nThis project only works on WiFi networks with SSID and password.  It is unlikely to work on public WiFi networks that use captive portals for signup or accepting terms and conditions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonprickett%2Fiss-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimonprickett%2Fiss-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonprickett%2Fiss-tracker/lists"}