Home

Pi-Sat Wiki

Pi-Sat is a Raspberry Pi-hosted web application for live satellite tracking, Doppler-aware radio control, SDR coordination, and optional rotator control. I'm sure it could be installed in other environments as well, but I am running it for now as a Pi based project.

This wiki is organized so an operator or developer can get directly to the right section without digging through unrelated material.

Start Here

• Requirements
  • platform, OS, dependencies, and browser expectations
• Installation
  • installer flow, manual install, service setup, and first-run guidance
• Configuration
  • config sections, what they do, and what is hidden from the GUI

Daily Operation

• Daily Usage and Operation
  • normal operator workflow and when to use each page
• Dashboard Page
  • live operating view, tuning, autotrack, pass list, and rotator controls
• Satellites Page
  • tracked satellite management, profiles, and per-satellite pass view
• Map Page
  • large tracked-satellite location view
• Monitor Page
  • backend event log and refresh visibility
• Settings Page
  • station, TLE, device, rotator, and safety configuration

System Design

• Core Program Architecture
  • frontend/backend split, data flow, and component layout
• Tracking and Control Logic
  • autotrack behavior, RX/TX logic, rotator policy, and pass-state handling
• TLE and Satellite Data
  • TLE sources, merge rules, caching, and profile refresh behavior

Hardware and Compatibility

• Compatible Devices
  • RX, TX, RX+TX layouts, SDR usage, local usb \ serial devices, and network devices

Troubleshooting and Maintenance

• Troubleshooting
  • startup issues, missing passes, TLE failures, device control problems, and browser issues
• Updating
  • updater flow, manual update path, and post-update validation
• Support
  • issue reporting guidance and what information to include

Media

• Screenshots
  • hosted UI screenshots and captions

Suggested Reading Paths

New User

1. Requirements
2. Installation
3. Configuration
4. Daily Usage and Operation
5. Dashboard Page

Operator

1. Daily Usage and Operation
2. Dashboard Page
3. Satellites Page
4. Map Page
5. Monitor Page

Troubleshooting / Support

1. Troubleshooting
2. Monitor Page
3. TLE and Satellite Data
4. Support

Project Scope

Pi-Sat is designed as an operator-facing control interface rather than a net-new piece of software to do these things. Hamlib pretty much owns this space, this is simply a frontend to the fantastic work that that team does already.

The backend runs on the Raspberry Pi. The browser acts as the main console.