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!
- 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!"
- The script uses ISS API for real-time position data.
- Nighttime conditions are checked using the sunset/sunrise API.
- When all conditions align, you receive an email to view the ISS.
- Clone this repository:
git clone https://github.com/yourusername/iss_tracker.git
- Install dependencies:
pip install -r requirements.txt
- Add your credentials to
.env
:EMAIL=your_email PASSWORD=your_email_password
Run the script:
python iss_tracker.py
You'll receive a notification email whenever the ISS is visible at your location during dark hours.
Subject: "Look Up! The ISS is Here!"
Body: "The ISS is currently visible in your area. Step outside, look up, and enjoy the view!"