Files

T

root 22a3078af9 Add admin panel, authentication, and first-run setup wizard for v1.0

Implements credentialed admin panel and multi-step setup wizard so new
users can configure location, receivers, and preferences without editing
JSON files. Adds bcrypt password auth with session cookies, setup lockout
after first run, and expanded config schema with backward compatibility.

New files: admin/{html,css,js}, setup/{html,css,js}
Modified: server.py (auth, setup, admin APIs), index.html (dynamic title),
pixel-view.js (site/display config), requirements.txt (bcrypt),
config.json.example (full schema)

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

2026-06-08 08:35:07 -07:00

3.0 KiB

Raw Blame History

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 (small prop, regional jet, narrow body, wide body, heavy, helicopter)
Animated sun and moon with accurate astronomical positions
Dynamic sky colors based on time of day
Weather visualization with cloud sprites
Directional view (N/E/S/W) with themed backgrounds
Auto-discovery of ADS-B receivers on your network
Canvas-based 10 FPS retro rendering

Quick Start

# Clone the repository
git clone https://gitea.chops.one/allen/ADS-Bit.git
cd ADS-Bit

# Install dependencies
pip install -r requirements.txt

# Configure your location (required for weather and celestial positioning)
# Edit config.json and set your lat/lon coordinates

# Start the server
python3 server.py

Access at http://localhost:2001

Requirements

Python 3.8+
ADS-B receiver providing SBS/BaseStation format on port 30003 (dump1090, readsb, etc.)
Modern web browser with Canvas support

Configuration

Edit config.json to customize your installation:

{
  "receivers": "AUTO",
  "receiver_port": 30003,
  "location": {
    "name": "My Location",
    "lat": 0.0,
    "lon": 0.0
  },
  "web_port": 2001,
  "theme": "desert"
}

Important: Set your location.lat and location.lon for accurate weather and sun/moon positioning.

See CONFIG.md for full configuration options including custom backgrounds and running as a service.

Controls

Arrow Keys / A/D: Rotate view direction
View cycles through North, East, South, West
Click aircraft in sidebar to highlight

Aircraft Types

Type	Detection
Helicopter	Low altitude + slow speed
Heavy (747/A380)	High altitude or specific callsigns
Wide Body	Very high altitude/speed
Narrow Body	Default commercial
Regional Jet	Regional carrier callsigns or lower altitude
Small Prop	N-prefix callsigns or very low/slow

Custom Backgrounds

Create backgrounds for your location:

Add 4 directional images to backgrounds/custom/ (north.png, east.png, south.png, west.png)
Set "theme": "custom" in config.json
Restart the server

See CONFIG.md for image specifications and tips.

Running as a Service

To auto-start on boot, see the systemd service instructions in CONFIG.md.

Compatible Receivers

Works with any receiver providing SBS/BaseStation format on port 30003:

dump1090 / dump1090-fa / dump1090-mutability
readsb
ADS-B Exchange feeders
FlightAware PiAware
Any SBS1 compatible receiver

License

MIT License - see LICENSE for details.

Credits

Aircraft and environment sprites generated with AI assistance
Weather data from Open-Meteo (free, no API key required)

3.0 KiB Raw Blame History