Convierte tu Gran Turismo 7 en un simulador de telemetría profesional.
Inspirado en los sistemas de muro de boxes de la vida real (MoTeC i2 / Atlas).
Una plataforma analítica de código abierto diseñada para extraer y transformar los datos crudos del Gran Turismo 7 (PS4/PS5) en una consola de ingeniería virtual del más alto nivel.
💡 Nota de diseño: La aplicación cuenta con un esquema de colores "Modo Diurno" (Daylight Mode) de alto contraste, diseñado específicamente para ser visible bajo luz natural brillante, típico en muros de boxes y paddocks profesionales. Todos los componentes utilizan un sistema de tokens de diseño centralizado (
ui/theme.py) para garantizar uniformidad visual en cualquier plataforma.
| Funcionalidad | Descripción |
|---|---|
| Telemetry Dashboard | Visualiza a 60 FPS la telemetría en tiempo real: pedales, marchas, volante y g-forces sin interrupciones (Zero-stutter). |
| Instrumentación Circular | Cluster de 4 medidores circulares (Velocidad, RPM, Turbo/Boost, Temp. Agua) dibujados nativamente con QPainter. |
| Consumo por Vuelta | Medición automática del consumo de combustible por vuelta con alertas visuales progresivas (Normal → Advertencia → Crítico). |
| Topografía Automática | Un motor heurístico cruza tus datos contra 122 pistas oficiales, detectando automáticamente si estás en Fuji o Le Mans. |
| Mapa Termodinámico | Traza la pista procedimentalmente. Rojo = Frenadas fuertes, Verde = Acelerador a fondo (WOT). |
| Base de Datos SQLite | Historial ilimitado en modo WAL. Guarda cada sesión y organízala por auto y tiempos de vuelta en un archivo maestro. |
| Alertas Inteligentes | Sistema de alertas en tiempo real con tono profesional sintetizado (1800 Hz, estilo MoTeC) para temperaturas peligrosas y eventos críticos. |
| Auto-Actualización | Verificación automática de nuevas versiones desde GitHub Releases con descarga y aplicación en caliente. |
La experiencia en el muro de boxes sube de nivel con reconocimiento visual de vehículos instantáneo y datos de máxima precisión:
- 🖼️ Thumbnail In-Game a 60 FPS: El panel de información ahora detecta tu telemetría y renderiza una fotografía ampliada de tu vehículo en tiempo real. Su sistema de caché inteligente evita stuttering.
- 🚘 580 Autos Oficiales Offline: Base de datos corregida con nomenclaturas oficiales (incluyendo Hypercars 2024/2025). Cuenta con 570 fotografías integradas nativamente para funcionar 100% sin conexión a internet.
- 🛣️ Topografía Precisa: Depuración de circuitos "fantasma", ajustando el motor heurístico estrictamente a los 121 layouts vigentes del simulador.
Los 4 indicadores de temperatura de neumáticos ahora son semicírculos visuales con gradiente de color que cambian dinámicamente:
| Color | Zona | Rango | Significado |
|---|---|---|---|
| 🔵 Azul | Frío | < 50°C | Sin agarre, neumático no activado |
| 🟢 Verde | Óptimo | 50-80°C | Ventana de operación ideal |
| 🟠 Naranja | Caliente | 80-100°C | Al límite, buen grip pero con riesgo |
| 🔴 Rojo | Sobrecalentamiento | > 100°C | Degradación activa |
Mueve tus datos de telemetría entre computadoras fácilmente:
- Exportar: Genera un archivo
.gt7dbportátil y limpio (sin archivos WAL sueltos) que puedes enviar por USB, correo o nube. - Importar: Dos modos disponibles:
- Fusionar: Agrega sesiones nuevas a tu base de datos existente sin perder nada. Detecta duplicados automáticamente.
- Reemplazar: Sobrescribe la base de datos completa (con backup automático de seguridad).
Si tienes GT7 Telemetry Pro abierto en dos o más computadoras conectadas a la misma red WiFi/LAN:
- Haz clic en "🔄 Sync LAN" en la barra superior.
- La app detecta automáticamente los otros dispositivos en tu red.
- Un solo clic sincroniza las sesiones faltantes en ambas direcciones.
- Los datos se transfieren comprimidos para máxima velocidad.
🔒 Las sesiones marcadas como protegidas (
is_locked) nunca se sobrescriben durante la sincronización.
Accesible desde el menú principal, el Pro Analysis Workspace transforma la telemetría en un entorno de ingeniería puro para comparar múltiples vueltas con un nivel de detalle milimétrico.
- Layout de 3 Columnas: Diseñado para pantallas anchas (widescreen). Track Map, Gráficas Centrales y paneles de Análisis se distribuyen equitativamente.
- Overlay Milimétrico: Compara varias vueltas (Multiselección) encimando gráficas de Velocidad y Pedales. Nuestro algoritmo ignora los clásicos errores de "Drift" de red usando el Delta-T real para la integración de distancias.
- Cursor Sincronizado Multigráfica: Inspecciona cualquier curva del circuito y mira simultáneamente qué hacían tus pies, tus manos y tu suspensión.
- Histogramas Dinámicos de Suspensión: Analiza la velocidad vertical de los 4 amortiguadores en tiempo real para perfeccionar el Setup del auto sobre los pianos.
- Data Grids Dinámicos: Tablas que resumen la telemetría compleja generando columnas codificadas por color automáticamente.
Los datos crudos no siempre dicen toda la verdad. GT7 Telemetry Pro integra un motor seguro de canales matemáticos (Math Channels) para proteger tu sistema mientras experimentas.
- Editor Visual Integrado: Crea y guarda tus propias fórmulas (ej: Rueda Delantera Derrape, Aerobalance) sin tocar una sola línea de código fuente.
- Parsing Seguro Vectorizado: Escribe fórmulas complejas usando el arreglo de datos crudos (ej:
speed / 3.6) y el motor calculará arreglos enteros de miles de puntos instantáneamente mediante NumPy. - Persistencia Local: Tus canales se guardan automáticamente en tu perfil para sesiones futuras.
Al terminar de correr o cargar una repetición, GT7 Telemetry Pro despliega su Módulo de Análisis Avanzado, optimizado para lectura instantánea sin gráficos abrumadores.
- Zero-Friction UX: Navega por el historial de sesiones sin ventanas emergentes. La interfaz principal integra la tabla de historiales, las vueltas y los gráficos.
- Gestión Segura de Datos (Lock & Delete): Protege tus mejores carreras bloqueándolas (
is_locked). Usa el borrado masivo para purgar bases de datos y recuperar espacio en disco automáticamente (VACUUM). - Exportador MoTeC i2: Exporta sesiones completas al formato binario
.ldde MoTeC para análisis en software profesional de terceros.
El código fuente (~8,500 líneas, 33 archivos Python) está modularizado en cuatro componentes desacoplados:
GT7TelemetryPro/
├── core/ # Capa de Dominio
│ ├── config.py # Versión de la app (APP_VERSION) y constantes globales
│ ├── models.py # GT7TelemetryPacket (dataclass con 63+ campos de telemetría)
│ ├── database.py # SessionDatabaseWriter (WAL, batch inserts asíncronos)
│ ├── db_portability.py # Exportar/Importar/Sincronizar bases de datos
│ ├── math_channels.py # Motor de métricas F1 (consumo, WOT, laps restantes)
│ ├── dynamic_math.py # Evaluador seguro de fórmulas (AST sandbox)
│ ├── lap_manager.py # Detección de vueltas y cálculo de deltas
│ ├── alert_engine.py # Motor de alertas (temperaturas, RPM, combustible)
│ ├── car_database.py # Mapeo de 800+ IDs de autos → nombres
│ └── utils.py # @safe_slot: decorador anti-crash para slots PyQt6
│
├── services/ # Capa de Ingestión y Red
│ ├── provider.py # TelemetryProvider: clase base abstracta (Live/Replay)
│ ├── crypto.py # Desencriptación Salsa20 (PS4/PS5 compatible)
│ ├── live_client.py # Socket UDP con heartbeat, autodescubrimiento de consola
│ ├── replay_player.py # Reproductor de sesiones desde SQLite (60Hz fiel)
│ ├── sync_service.py # Sincronización LAN (UDP discovery + TCP transfer)
│ ├── updater.py # Auto-actualización desde GitHub Releases
│ └── motec_exporter.py # Exportador al formato binario MoTeC .ld/.ldx
│
├── ui/ # Capa Gráfica (PyQt6 + PyQtGraph)
│ ├── main_window.py # Ventana principal con dashboard de instrumentación
│ ├── workspace.py # Pro Analysis Workspace (3 columnas, docks)
│ ├── sync_dialog.py # Diálogo de sincronización LAN
│ ├── formula_manager.py # Editor visual de canales matemáticos
│ ├── theme.py # Sistema centralizado de tokens de diseño
│ └── widgets/ # Componentes reutilizables (gauges, mapas, gráficas)
│
├── data/ # Datos estáticos
│ ├── gt7_cars.json # Base de datos de 2,500+ autos de GT7
│ └── tracks.json # 122 pistas con heurísticas de distancia
│
└── main.py # Entry point con aislamiento de datos por plataforma
- Python 3.10+ instalado en tu sistema.
- Consola PS4 o PS5 con Gran Turismo 7 (Debe estar conectado en tu red local WiFi/Ethernet).
🍎 macOS / 🐧 Linux
git clone https://github.com/DEMG-DEV/RGDev.App.GT7TelemetryPro.git
cd RGDev.App.GT7TelemetryPro
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python main.py🪟 Windows (PowerShell)
git clone https://github.com/DEMG-DEV/RGDev.App.GT7TelemetryPro.git
cd RGDev.App.GT7TelemetryPro
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python main.pyEn la barra superior del programa, Introduce la IP local de tu consola PS4/PS5 (Ej: 192.168.1.68) y presiona Connect Live.
⚠️ Importante: La telemetría solo se emite cuando estás físicamente manejando en pista o viendo una repetición. Los menús y boxes no emiten señal.
Ejecuta nuestro script inteligente (activa el entorno virtual automáticamente y empaqueta con el ícono .icns):
./build_macos.shEl bundle .app aparecerá en dist/GT7TelemetryPro.app. Puedes arrastrarlo a tu carpeta de Aplicaciones.
-
Asegúrate de tener PyInstaller instalado dentro de tu entorno virtual:
.\.venv\Scripts\Activate.ps1 pip install pyinstaller
-
Limpia compilaciones anteriores y ejecuta PyInstaller con el archivo de especificación:
Remove-Item -Recurse -Force build, dist -ErrorAction SilentlyContinue pyinstaller GT7TelemetryPro.spec --noconfirm
-
¡Listo! Tu ejecutable portátil se encuentra en:
dist\GT7TelemetryPro\GT7TelemetryPro.exePuedes comprimir toda la carpeta
dist\GT7TelemetryPro\en un.zippara distribuirla.
💡 Nota: El archivo
GT7TelemetryPro.specya contiene la configuración completa para ambas plataformas (ícono.icopara Windows,.icnspara macOS, datos de pistas y autos incluidos). No necesitas modificarlo.
Al ejecutarse como aplicación empaquetada, GT7 Telemetry Pro aísla automáticamente sus bases de datos, logs y configuraciones en las rutas estándar del sistema operativo:
| Plataforma | Ruta de datos |
|---|---|
| macOS | ~/Library/Application Support/GT7TelemetryPro/ |
| Windows | %APPDATA%\GT7TelemetryPro\ |
| Linux | ~/.local/share/GT7TelemetryPro/ |
Este proyecto está bajo la licencia MIT.