https://github.com/sayed-ashfaq/iss_tracker
This is a ISS tracker that will track the International Space Station and when it reaches near your location coordinates when it is dark then it will send a mail to inform to look up. if you have a telescope then you can see it.
https://github.com/sayed-ashfaq/iss_tracker
api json
Last synced: 3 months ago
JSON representation
This is a ISS tracker that will track the International Space Station and when it reaches near your location coordinates when it is dark then it will send a mail to inform to look up. if you have a telescope then you can see it.
- Host: GitHub
- URL: https://github.com/sayed-ashfaq/iss_tracker
- Owner: sayed-ashfaq
- Created: 2025-01-23T16:21:51.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-23T16:43:24.000Z (over 1 year ago)
- Last Synced: 2025-06-27T13:45:28.205Z (about 1 year ago)
- Topics: api, json
- Language: Python
- Homepage:
- Size: 13.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ISS Tracker & Notification System (A FUN PROJECT)🌌🚀
**Track the International Space Station (ISS) and get notified when it's near your location during dark hours. Perfect for stargazing enthusiasts with or without a telescope!**
## 📜 Features
- **Location Tracking**: Detects your geographic coordinates.
- **ISS Position**: Tracks the ISS's real-time position in orbit.
- **Nighttime Detection**: Sends alerts only when it's dark outside.
- **Email Notifications**: Get an email prompt to "Look Up!"
## 💻 How It Works
1. The script uses [ISS API](http://open-notify.org/Open-Notify-API/ISS-Location-Now/) for real-time position data.
2. Nighttime conditions are checked using the sunset/sunrise API.
3. When all conditions align, you receive an email to view the ISS.
## 🚀 Setup
1. Clone this repository:
```bash
git clone https://github.com/yourusername/iss_tracker.git
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Add your credentials to `.env`:
```
EMAIL=your_email
PASSWORD=your_email_password
```
## 🎯 Usage
Run the script:
```bash
python iss_tracker.py
```
You'll receive a notification email whenever the ISS is visible at your location during dark hours.
## 📧 Email Preview
**Subject**: "Look Up! The ISS is Here!"
**Body**: "The ISS is currently visible in your area. Step outside, look up, and enjoy the view!"