Skip to content

carbform/carbsat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

114 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛰️ 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!

About

Satellite tracking webapp (testing stage)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Contributors