Initial commit: Pixel-ADSB flight tracker

Retro SNES-style side-view ADS-B aircraft tracker with pixel art sprites,
animated celestial bodies, weather visualization, and directional views.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

README.md

@@ -0,0 +1,56 @@
+# Pixel-ADSB
+
+A retro SNES-style side-view flight tracker that displays ADS-B aircraft data with custom pixel art sprites.
+
+## Features
+
+- Real-time aircraft tracking via ADS-B receivers
+- Custom pixel art sprites for 6 aircraft types
+- Animated sun and moon with accurate positions based on location
+- Weather visualization (clouds, rain/snow)
+- Directional view (N/E/S/W) with unique backgrounds
+- Canvas-based 10 FPS retro rendering
+
+## Quick Start
+
+```bash
+# Install dependencies
+pip install aiohttp netifaces
+
+# Start the server
+python3 server.py
+```
+
+Access at http://localhost:2001 (or configured port in config.json)
+
+## Requirements
+
+- Python 3.8+
+- ADS-B receiver providing SBS/BaseStation format on port 30003
+- Modern web browser with Canvas support
+
+## Documentation
+
+- [CONFIG.md](CONFIG.md) - Configuration options
+- [PROJECT_DOCUMENTATION.md](PROJECT_DOCUMENTATION.md) - Technical details
+- [CLAUDE.md](CLAUDE.md) - Development guidance
+
+## Aircraft Types
+
+| Type | Description |
+|------|-------------|
+| Small Prop | Light aircraft, N-prefix callsigns |
+| Regional Jet | Regional carriers |
+| Narrow Body | 737/A320 class |
+| Wide Body | 777/787 class |
+| Heavy | 747/A380 class |
+| Helicopter | Low altitude, slow speed |
+
+## Controls
+
+- **Arrow Keys / A/D**: Rotate view direction
+- View cycles through North, East, South, West
+
+## License
+
+MIT