GitHub - benb0jangles/EzTrak: satellite hand tracking made easy
Extracto
satellite hand tracking made easy. Contribute to benb0jangles/EzTrak development by creating an account on GitHub.
Resumen
Resumen Principal
EZ-TRAK es una suite integral de seguimiento satelital diseñada específicamente para operadores de radioaficionados, entusiastas de satélites meteorológicos y fines educativos. Su propuesta de valor central reside en la capacidad de rastrear satélites manualmente en tiempo real mediante la interacción con un dispositivo BLE EZ-TRAK que se acopla a una antena parabólica portátil y ligera. La suite proporciona datos precisos de acimut y elevación, permitiendo un posicionamiento óptimo de la antena para la recepción de señales. Sus características distintivas incluyen el seguimiento dinámico con visualización en tiempo real, la predicción de pasos satelitales según la ubicación del usuario y la capacidad de grabar datos de posicionamiento de la antena para análisis futuros. Además, soporta la descarga de datos TLE (Elementos Keplerianos) desde múltiples fuentes como Celestrak y SatNOGS, todo ello gestionado a través de una interfaz de usuario intuitiva que facilita tanto la configuración como el lanzamiento de las aplicaciones principales.
Elementos Clave
- Seguimiento Satelital en Tiempo Real y Predicción de Pasos: La funcionalidad principal de EZ-TRAK es su capacidad para mostrar en tiempo real la posición (acimut y elevación) de los satélites, permitiendo a los usuarios ajustar manualmente sus antenas. Complementa esto con una función de predicción de pasos que calcula los futuros tránsitos de satélites visibles desde una ubicación geográfica definida, optimizando las oportunidades de recepción.
- Integración con Dispositivo BLE EZ-TRAK y Hardware Específico: La suite depende de un dispositivo de hardware compacto EZ-TRAK BLE que se monta directamente en una antena (como la Farabrella), adquiriendo datos de posición. Este dispositivo se comunica inalámbricamente vía Bluetooth Low Energy (BLE), es alimentado por batería para operación en campo y cuenta con una interfaz de botón simple para grabar y reiniciar, lo que facilita la recolección de datos de la antena.
- Arquitectura de Software Modular: EZ-TRAK se compone de tres aplicaciones principales: el EZ-TRAK Launcher (eztrak_welcome.py) para la configuración inicial y el ajuste de la ubicación geográfica, los satélites a rastrear y la elevación mínima; el Satellite Tracker (eztrack.py), que es la aplicación principal de seguimiento con visualización polar y registro de datos; y Rotator Control (eztrackrotator.py), una aplicación opcional para el control de rotores de antena Wi-Fi e IMU compatibles.
- Gestión de Datos TLE y Usabilidad: La suite simplifica la obtención de los datos TLE (Two-Line Element), esenciales para el cálculo de las órbitas satelitales, permitiendo su descarga desde Celestrak o SatNOGS DB. Además, su diseño con un lanzador gráfico y una interfaz de seguimiento circular facilita enormemente la configuración, el monitoreo y el uso general para los operadores, incluyendo actualizaciones automáticas de datos satelitales.
Análisis e Implicaciones
EZ-TRAK representa una solución altamente accesible y práctica para la comunidad de radioaficionados y entusiastas de satélites, democratizando el seguimiento preciso de objetos orbitales. Su enfoque en el seguimiento manual con retroalimentación en tiempo real y la portabilidad del hardware BLE abre nuevas oportunidades para expediciones de campo y educación científica. Esto implica una mejora significativa en la eficiencia y precisión de la adquisición de datos satelitales para proyectos personales y educativos.
Contexto Adicional
El software está desarrollado en Python 3.8+ y utiliza la biblioteca Skyfield para los cálculos satelitales, mostrando la solidez de su base tecnológica. Es un proyecto de software propietario, destinado para uso personal y educativo, con un reconocimiento explícito a la comunidad de radioaficionados por su contribución.
Contenido
EZ-TRAK Satellite Hand Tracking Suite
Overview
EZ-TRAK is a comprehensive satellite tracking suite designed for amateur radio operators, weather satellite enthusiasts, and educational purposes. The software interfaces with an EZ-TRAK BLE device which is mounted to a lightweight foldable portable satellite dish antenna to hand track satellites in real-time, providing azimuth and elevation data for optimal antenna positioning.
Features
EZ-TRAK DEMO: https://youtu.be/2A2lW0ONNiE
- Dynamic Satellite Tracking: Track satellites in real-time with azimuth/elevation display
- Pass Prediction: Calculate upcoming satellite passes for your location
- BLE Device Integration: Seamlessly connects to EZ-TRAK BLE device
- Position Recording: Record antenna pointing data for later analysis
- Multi-Source TLE Data: Download satellite data from Celestrak or SatNOGS DB
- User-friendly Interface: Easy-to-use application launcher and configuration tool
Components
1. EZ-TRAK Launcher (eztrak_welcome.py)
A graphical interface to configure and launch the main applications:
- Set your geographic location (latitude, longitude, altitude)
- Configure tracked satellites
- Set minimum elevation for valid passes
- Download and verify TLE data
- Launch main tracking applications
2. Satellite Tracker (eztrack.py)
The main satellite tracking application:
- Visual polar plot showing real-time azimuth/elevation of your hand tracking antenna
- Real-time position display
- Pass prediction information
- Track recording functionality
- Automatic satellite data updates
3. Rotator Control (eztrackrotator.py)
Optional application for controlling wifi + imu antenna rotator (if available).
Installation
Prerequisites
- Python 3.8 or higher
- Bluetooth-enabled computer (Windows, macOS, or Linux)
- EZ-TRAK BLE hardware device
Required Python Packages
pip install bleak matplotlib skyfield numpy requests
Installation Steps
- Clone this repository:
git clone https://github.com/benb0jangles/EZ-TRAK.git
cd EZ-TRAK- Run the launcher application (nuked demo version):
Usage
-
Configure Your Setup:
- Enter your latitude, longitude, and altitude
- Select satellites to track (e.g., "NOAA 19", "METOP-C")
- Set minimum elevation (typically 20° for good reception)
- Download current TLE data
-
Launch Tracking Application:
- Click "Launch EZ-TRAK" to start the main tracking application
- Make sure your EZ-TRAK BLE device is powered on and nearby
-
Using the Tracker:
- The circular display shows azimuth (compass direction) and elevation
- The red dot shows the current position
- Blue lines show predicted satellite passes
- Yellow dot shows satellite position along blue line track
- Use recording functionality to track your antenna movement
For those wondering what antenna I am using:
Troubleshooting
Common Issues
- Device Not Found: Ensure the EZ-TRAK device is powered on and within range
- TLE Download Errors: If Celestrak access is limited, try the SatNOGS data source
- No Satellite Passes: Verify your location settings and satellite selection
Debug Information
The application logs information to the serial console which can be helpful for troubleshooting. Look for messages related to:
- BLE device connection
- Satellite TLE parsing
- Pass prediction calculations
Hardware
The EZ-TRAK BLE device is available from Ez-Trak sales page. This compact device:
- Interfaces with Farabrella satellite antenna Buy a Farabrella here to provide positional data
- Connects via Bluetooth Low Energy
- Battery-powered for field operation
- Simple button interface for recording and resetting
Legal Notice
All Rights Reserved © 2025 Benb0jangles
This software is proprietary. No permission is granted to copy, distribute, or modify this software without explicit written permission from the author.
This project is provided as-is without any warranty. The software can be used for personal and educational purposes, but redistribution is prohibited.
Acknowledgments
Fuente: GitHub

.jpg)





