ISS Tracker CLI - Track the International Space Station

✨ Features

🌌 Real-time Tracking

Track the ISS position in real-time using the Open Notify API. Get instant updates on latitude, longitude, and distance from your location.

🗺️ ASCII World Map

Visualize the ISS location on a beautiful ASCII-based world map directly in your terminal. See both your position and the ISS at a glance.

🌙 Night Detection

Automatic night-time detection using the Sunrise-Sunset API. Know exactly when the ISS is visible in your night sky.

📧 Email Notifications

Receive instant email alerts when the ISS passes overhead at night. Never miss a spectacular viewing opportunity!

📏 Distance Calculator

Calculate the exact distance between your location and the ISS. Get directional information (North, South, East, West).

📝 Detailed Logging

Comprehensive logging system tracks all ISS passes, email notifications, and errors for debugging and analysis.

📸 Demo

Initial Banner

_____ _____ ____ ____ _ _ ____ _ _____
|_ _| ___/ ___| / ___|| | | | _ \| | | ____|
  | | | |_ \___ \ \___ \| | | | |_) | | | _|
  | | | _| ___) | ___) | |_| | __/| |___| |___
  |_| |_| |____/ |____/ \___/|_| |_____|_____|

✨ ISS TRACKER ACTIVATED ✨

Monitoring your position: 22.470493, 88.307407
Notification email: youremail@gmail.com

Map Visualization

🌎 Your Position vs ISS Position:

・・・・・・・・・・・・・・・・・・・・・・・・・・
・・・・・・・・・・・・・・・・・・・・・・・・・・
・・・🏠・・・・・・・・・・🛰️・・・・・・・・・・・

📍 Your position: 22.47, 88.30
🛰️ ISS position: 25.64, 90.12
📏 Distance: 321.43 km
🧭 Direction: North-East

Email Notification

🌙 Night detected at your location
🛰️ ISS is overhead!

📧 Sending email notification...
✅ Email sent successfully!

Look Up! The ISS is passing overhead
in your night sky right now! 🌟

🚀 Quick Setup

1 Clone the Repository

Get started by cloning the project to your local machine:

git clone https://github.com/jayMondal45/iss-tracker-cli.git
cd iss-tracker-cli
                    

2 Create .env File

Create a .env file in the project root with your configuration:

MY_EMAIL=youremail@gmail.com
EMAIL_PASSWORD=your_app_password
MY_LAT=22.470493
MY_LNG=88.307407
TIMEZONE_OFFSET=5.5
                    

⚠️ Use an App Password if using Google accounts (not your main password).

3 Install Dependencies

Install the required Python packages:

pip install -r requirements.txt

▶️ Usage

▶ Run the Tracker

Execute the script to start tracking the ISS:

python main.py

The program will:

📍 Display your location vs ISS location on an ASCII map
📏 Calculate the distance between you and the ISS
🌙 Check if it's nighttime at your location
📧 Send you an email if the ISS is within 500 km and it's night
📝 Log all activities to iss_tracker.log

💡 Pro Tips

🔄 Run the script on a schedule using cron (Linux/Mac) or Task Scheduler (Windows)
🌍 Update MY_LAT and MY_LNG with your exact coordinates
⏰ Adjust TIMEZONE_OFFSET based on your location
📧 Check your spam folder if you don't receive notifications
📊 Review iss_tracker.log for detailed tracking history

🛰️ ISS Tracker CLI