{"id":13830212,"url":"https://github.com/mykle1/MMM-ISS","last_synced_at":"2025-07-09T11:32:18.103Z","repository":{"id":91842943,"uuid":"122897898","full_name":"mykle1/MMM-ISS","owner":"mykle1","description":"Know when the International Space Station is visible to you, based on your latitude and longitude.","archived":false,"fork":false,"pushed_at":"2020-12-28T03:05:55.000Z","size":297,"stargazers_count":15,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-07T21:15:53.901Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/mykle1.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}},"created_at":"2018-02-26T01:52:20.000Z","updated_at":"2024-09-22T18:17:27.000Z","dependencies_parsed_at":"2023-05-06T01:13:53.219Z","dependency_job_id":null,"html_url":"https://github.com/mykle1/MMM-ISS","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mykle1/MMM-ISS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mykle1%2FMMM-ISS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mykle1%2FMMM-ISS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mykle1%2FMMM-ISS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mykle1%2FMMM-ISS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mykle1","download_url":"https://codeload.github.com/mykle1/MMM-ISS/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mykle1%2FMMM-ISS/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264450556,"owners_count":23610194,"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-08-04T10:00:57.340Z","updated_at":"2025-07-09T11:32:17.724Z","avatar_url":"https://github.com/mykle1.png","language":"JavaScript","funding_links":[],"categories":["Entertainment"],"sub_categories":[],"readme":"## MMM-ISS\r\n\r\nKnow when the International Space Station is visible. Based on your latitude and longitude.\r\n\r\n## Cool Fact\r\n\r\nThe International Space Station travels in orbit around Earth at a speed of roughly 17,150 miles per hour.\r\nThat's about 5 miles per second! This means the ISS orbits Earth (and sees a sunrise) once every 92 minutes!\r\n\r\n## Can I see it without a telescope?\r\n\r\nYou sure as hell can! Every so often, you can see the ISS in your night sky. To us on Earth, it looks like \r\na bright star moving quickly above the horizon. Visible to the naked eye, the ISS is best seen at dawn and dusk.\r\nIt is the third brightest object in the sky. \r\n\r\n## Multiple instances\r\n\r\n* Simply add another config entry\r\n\r\n## What you get\r\n\r\n* The current altitude of the ISS\r\n\r\n* The current velocity of the ISS\r\n\r\n* The date and time of the next sighting for your location\r\n\r\n* Length of time the ISS will be visible\r\n\r\n* The direction you should be looking to see the ISS when it appears\r\n\r\n## Examples\r\n\r\n![](images/1.PNG) ![](images/2.png)\r\n\r\n## Installation\r\n\r\n* `git clone https://github.com/mykle1/MMM-ISS` into the `~/MagicMirror/modules` directory.\r\n\r\n* No dependencies, yet! :-)\r\n\r\n\r\n## Config.js entry and options\r\n\r\n### Location not in the United States\r\n\r\n```\r\n{\r\ndisabled: false,\r\nmodule: 'MMM-ISS',\r\nposition: 'top center',\r\nconfig: {\r\n    country: \"Japan\",\r\n    city: \"Tokyo\",\r\n    lat: \"42.6977\",                // latitude\r\n    lng: \"23.3219\",                // longitude\r\n    units: \"km\",                   // mi = miles, mph / km = kilometers, km/h\r\n    useHeader: false,              // true if you want a header\r\n    header: \"\",                    // Any text you want. useHeader must be true\r\n    updateInterval: 5 * 60 * 1000,\r\n  }\r\n},\r\n```\r\n### Location inside the United States\r\n\r\n```\r\n{\r\ndisabled: false,\r\nmodule: 'MMM-ISS',\r\nposition: 'middle_center',\r\nconfig: {\r\n    country: \"United States\",\r\n    regionState: \"New York\",       // Requires state\r\n    city: \"New York\",              // Requires city\r\n    lat: \"40.565819\",              // latitude\r\n    lng: \"-74.117500\",             // longitude\r\n    units: \"mi\",                   // mi = miles, mph / km = kilometers, km/h\r\n    useHeader: false,              // true if you want a header\r\n    header: \"\",                    // Any text you want. useHeader must be true\r\n    updateInterval: 5 * 60 * 1000,\r\n   }\r\n},\r\n```\r\n## Attention = Note from user about location issues\r\n\r\n@timma11 wrote:\r\n@Mykle1, Thanks for making these modules. I have 2 of yours installed. Might I suggest adding to the readme that the module can’t use every location and that it can only use ones listed on the findthesation.nasa.gov site.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmykle1%2FMMM-ISS","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmykle1%2FMMM-ISS","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmykle1%2FMMM-ISS/lists"}