Skip to content

README.md

Latest commit

 

History

History
136 lines (99 loc) · 4.82 KB

README.md

File metadata and controls

136 lines (99 loc) · 4.82 KB

🛰️ CarbSat

GitHub Pages License Version

A modern, minimalistic web application for real-time satellite tracking with interactive orbit visualization and pass prediction capabilities.

✨ Features

  • 🌍 Real-time Satellite Tracking - Track hundreds of satellites on an interactive world map
  • 🛰️ Orbit Visualization - Display satellite orbits, ground tracks, and sensor footprints
  • 📊 Pass Prediction - Calculate upcoming passes with polar plot visualizations
  • 🔍 Smart Filtering - Search and categorize satellites with advanced filtering
  • 📡 Custom TLE Support - Add your own Two-Line Element sets for custom tracking
  • 🌙 Dark/Light Theme - Responsive design with theme switching
  • ⏰ Live UTC Clock - Real-time UTC display for accurate timing

🚀 Live Demo

Launch CarbSat →

🖥️ Screenshots

Main Satellite List

Interactive table with sorting and filtering capabilities.

Satellite Tracking Page

Real-time position tracking with orbital data and pass predictions.

🛠️ Tech Stack & Dependencies

Core Libraries

Map Providers

UI Components

Data Sources

  • CelesTrak - Two-Line Element (TLE) data by Dr. T.S. Kelso
  • NORAD - Official satellite catalog data

📋 Usage

Basic Tracking

  1. Browse the satellite list on the main page
  2. Use filters to find specific satellite categories
  3. Click any satellite name to view its tracking page

Pass Prediction

  1. Navigate to a satellite's tracking page
  2. Enter your observer coordinates (latitude/longitude)
  3. Click "Predict Passes" to generate pass forecasts
  4. View upcoming passes with elevation, azimuth, and timing data
  5. Analyze pass geometry using the interactive polar plot

Map Controls

  • Map Type: Switch between street, satellite, dark, and topographic views
  • Overlays: Toggle orbit paths, ground tracks, and sensor footprints
  • Real-time Updates: Satellite positions update automatically

🔧 Local Development

# Clone the repository
git clone https://github.com/carbform/carbsat.git

# Navigate to project directory
cd carbsat

# Serve locally (Python 3)
python -m http.server 8000

# Or with Node.js
npx serve .

# Access at http://localhost:8000

📁 Project Structure

carbsat/
├── index.html              # Main satellite list page
├── js/
│   ├── main.js             # Main page functionality
│   ├── satPage.js          # Satellite tracking page
│   └── lib/                # Third-party libraries
├── css/
│   ├── style.css           # Main page styles
│   └── satpage.css         # Tracking page styles
├── src/                    # Fonts and assets
└── data/                   # TLE data files

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

This project is licensed under the Unlicense License - see the LICENSE file for details.

🙏 Acknowledgments

  • Dr. T.S. Kelso and CelesTrak for providing accurate TLE data
  • David A. Vallado for SGP4 orbital mechanics algorithms
  • NASA and NORAD for satellite tracking standards
  • Open source community for the excellent libraries used in this project

👨‍💻 Authors

Version 0.2 (Beta) | Star ⭐ this repo if you find it useful!