SkySpy Documentation
π― What is SkySpy?
SkySpy is a comprehensive aircraft tracking platform that processes ADS-B, ACARS, and other aviation data sources. It provides real-time visualization, safety monitoring, custom alerts, and rich analytics.
flowchart LR
subgraph Input["π‘ Data Sources"]
ADSB[ADS-B<br/>Receivers]
ACARS[ACARS<br/>Decoders]
end
subgraph Core["βοΈ SkySpy"]
API[Django API]
WS[Socket.IO]
end
subgraph Output["π₯οΈ Clients"]
WEB[Web Dashboard]
CLI[Go CLI]
EXT[Your App]
end
ADSB --> API
ACARS --> API
API --> WS
WS --> WEB
WS --> CLI
API --> EXT
π Documentation Index
π Getting Started
New to SkySpy? Start here!
| Document | Description | |
|---|---|---|
| π | Quick Start | Get running in 5 minutes with Docker |
| ποΈ | Overview | Architecture, tech stack, core concepts |
| βοΈ | Configuration | Complete environment and settings reference |
π Core Features
| Document | Description | |
|---|---|---|
| π | Authentication | JWT, API keys, OIDC, permissions |
| ποΈ | Database | Models, schema, relationships, migrations |
π API Reference
Building an integration? These docs are for you.
| Document | Description | |
|---|---|---|
| π | REST API | Complete HTTP endpoint reference |
| β‘ | Socket.IO API | Real-time streaming, namespaces, events |
π§© Components
| Document | Description | |
|---|---|---|
| πΉ | Go Services | CLI application, radar display |
| βοΈ | Frontend | React web application architecture |
| β° | Background Tasks | Celery workers, scheduled jobs |
β¨ Features
| Document | Description | |
|---|---|---|
| πΊοΈ | Map & Aviation | Map layers, weather, aviation data |
| π¨ | Safety & Alerts | Safety monitoring, alert rules |
| π‘ | ACARS | ACARS/VDL2 message integration |
| π― | Cannonball Mode | Mobile proximity detection |
| π | Statistics | Analytics, gamification, exports |
π οΈ Operations
| Document | Description | |
|---|---|---|
| π | Deployment | Docker, production, Raspberry Pi |
| π§ͺ | Testing | Running and writing tests |
π¨βπ» Development
| Document | Description | |
|---|---|---|
| π€ | Contributing | Dev setup, code style, PR process |
| π§ | Troubleshooting | Common issues, debugging, FAQ |
π Quick Commands
# π³ Start with Docker
docker compose up -d
# π View logs
docker compose logs -f api
# π§ͺ Run tests
docker compose run --rm api pytest
# π Update
git pull && docker compose up -d --buildπ Quick Links
| Resource | Description | |
|---|---|---|
| π | Swagger UI | Interactive API explorer |
| π | ReDoc | API reference documentation |
| π₯οΈ | Admin | Django admin interface |
| β€οΈ | Health | System health check |
π¬ Support
Having issues? Check the Troubleshooting Guide first!
- π Bugs: GitHub Issues
- π‘ Features: GitHub Discussions
- π§ Contact: [email protected]
SkySpy v0.2.0 Β· Built with β€οΈ for the aviation community
Documentation generated with comprehensive codebase analysis
Updated 6 months ago
Did this page help you?