Skip to content

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.

Notifications You must be signed in to change notification settings

sayed-ashfaq/iss_tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 

Repository files navigation

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 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:
    git clone https://github.com/yourusername/iss_tracker.git  
  2. Install dependencies:
    pip install -r requirements.txt  
  3. Add your credentials to .env:
    EMAIL=your_email  
    PASSWORD=your_email_password  
    

🎯 Usage

Run the script:

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!"

About

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.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages