https://github.com/pkrasicki/issviewer
Spot the International Space Station
https://github.com/pkrasicki/issviewer
international-space-station iss javascript nodejs openstreetmap space web web-application webapp
Last synced: 6 months ago
JSON representation
Spot the International Space Station
- Host: GitHub
- URL: https://github.com/pkrasicki/issviewer
- Owner: pkrasicki
- License: agpl-3.0
- Created: 2019-09-25T13:29:39.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-02-25T09:45:41.000Z (about 2 years ago)
- Last Synced: 2025-07-11T23:04:21.275Z (10 months ago)
- Topics: international-space-station, iss, javascript, nodejs, openstreetmap, space, web, web-application, webapp
- Language: JavaScript
- Homepage: https://issviewer.com
- Size: 3.98 MB
- Stars: 32
- Watchers: 1
- Forks: 4
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ISS Viewer
Track the International Space Station and get pass predictions.
ISS Viewer predicts visible ISS passes for a given location and displays them on a map. It can also calculate and display the station's position in real time.
The app periodically fetches orbital information about ISS from [celestrak.org](https://celestrak.org). The [PyEphem](https://github.com/brandon-rhodes/pyephem) library is then used to predict future passes based on this data and [Satellite.js](https://github.com/shashwatak/satellite-js) is used for calculating the current position.
## Dependencies
- [Node.js 18.x](https://nodejs.org)
- [Redis server](https://redis.io) - used as a cache for API requests.
- [Python 3](https://www.python.org)
- [PyEphem](https://github.com/brandon-rhodes/pyephem)
On Debian GNU/Linux they can be quickly installed by running:
```
sudo apt install nodejs npm redis python3-ephem
```
## Build from source
```
npm install
npm run build
```
For a production build use `npm run build-prod`.
# Run
Make sure redis-server is running (otherwise the app will exit with an error) and run `node app.js` to start the app. Then navigate to `http://localhost:3000`.
For development you can instead run `npx nodemon app.js`. This will restart the backend automatically on changes.
Live version is at: [issviewer.com](https://issviewer.com)