Home

Pi-Sat Wiki

Pi-Sat is a Raspberry Pi-hosted web application for live satellite tracking, Doppler-aware radio control, SDR coordination, optional rotator control, pass-event automation, and satellite pass planning. 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
• QSO Finder
  • planning page to see if two grid squares can both work the same satellite pass
• Monitor Page
  • backend event log, debug controls, and troubleshooting visibility
• Settings Page
  • station, TLE, device, automation, rotator, and advanced 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. QSO Finder
5. Map Page
6. 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 that builds on proven tools such as Hamlib instead of trying to replace them.

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