Panel de Control

Español · English

Ko-fi Patreon YouTube Discord Linktree

Estado del CI Última versión

El centro de control que le faltaba a tu Handheld PC. Ajusta la potencia, las curvas de ventilador, la batería, la pantalla y los mandos desde un único panel dentro del menú de acceso rápido de Steam, sin salir del juego y sin memorizar rutas de sysfs.

Es un plugin para Decky Loader. Está pensado para Steam Deck, ROG Ally, Legion Go, MSI Claw y compañía, con una idea fija: que cada control se vea bien, muestre siempre el modelo real de tu equipo arriba, y nunca te mienta sobre lo que de verdad está pasando en el hardware.

La interfaz arranca en español y también está disponible en inglés, italiano y alemán. En el primer inicio adopta uno de esos idiomas si Steam ya lo usa.

En este vídeo enseño y explico el plugin a fondo:

Panel de Control en acción

El panel se organiza en pestañas. Cada una cubre una parte del equipo.

El corazón del plugin. Un arco visual que se llena con el TDP a lo largo del rango real de tu máquina (no valores inventados: los lee del firmware). Ajustas los vatios con un deslizador y tienes presets rápidos. Puedes crear los tuyos, con nombre e icono, y ordenarlos u ocultarlos desde un menú a pantalla completa, además de guardar un perfil global o uno propio por juego.

• Auto-TDP. Un modo automático que observa la carga de la GPU y sube o baja la potencia sola para darte los fotogramas que necesitas gastando lo mínimo. Aprende de cómo juegas y se autocorrige; no hace falta que toques nada.
• Boost. Si tu firmware lo permite, eliges cómo se comportan los raíles SPPT y FPPT: Estable (lo que fijas es lo que gasta, el modo por defecto), Auto (un margen de boost gestionado) o Personalizado (ajustas los márgenes a mano).
• Frecuencia de GPU. Fija el reloj mínimo y máximo de la gráfica.

Todo lo que no es potencia pura pero sí gestión del día a día.

• Batería. Estado, salud, ciclos y capacidad, con una tarjeta que se rellena y cambia de color. Incluye límite de carga (topar la carga en un porcentaje para cuidar la batería), adaptado a cómo lo expone cada fabricante.
• CPU. Interruptores para el multihilo (SMT) y el turbo boost, con una vista de núcleos e hilos y el rango de frecuencia base a turbo.
• Brillo y volumen. Deslizadores que muestran el número exacto, algo que los controles nativos de Steam esconden.
• Modo Descarga. Un botón para dejar el equipo bajando un juego desatendido: baja el TDP al mínimo, apaga el boost y atenúa la pantalla cuando no lo estás tocando. Todo reversible.
• Iluminación RGB. Si tienes instalado el plugin hermano Colores, esta tarjeta lo abre; si no, te ofrece instalarlo.

Empieza como un monitor en vivo (RPM y temperaturas de CPU y GPU con gráficas) y, en los equipos que lo permiten, se convierte en un editor de curvas temperatura a velocidad que puedes arrastrar con el dedo, con presets (silencioso, equilibrado, rendimiento) y curvas por juego.

Además aprende. Con el tiempo te propone una curva ajustada a cómo se comporta cada juego en tu equipo, y puedes aplicarla de un toque. Si tu máquina no deja escribir la curva, el editor se oculta y se te dice claramente por qué, en lugar de fingir que funciona.

Calibración de color del panel a través de gamescope, convertida en un pequeño laboratorio: ambientes de un toque (Nativo, Cine, Vivo, Cómodo) afinados por tipo de panel, saturación por juego y un modo avanzado con temperatura, contraste, gamma, tono, nivel de negro, vivacidad y balance manual de blancos (RGB). Incluye un modo nocturno que calienta la pantalla, siempre o en el horario que elijas, y un preset "Aspecto OLED" para los paneles que no son OLED. Un temporizador de confirmación revierte los cambios solo si algo se ve mal, para que no te quedes con una pantalla ilegible. En los paneles con HDR (Steam Deck OLED y Legion Go 2) hay además un interruptor de HDR.

Ecualizador del sistema con presets curados y una curva de mejora por máquina como punto de partida, tres controles simples (graves, voces, agudos) y un ecualizador avanzado de 10 bandas a pantalla completa. Curva independiente para altavoz y auriculares, y por juego o global. Incluye realce de graves, nivelado de volumen, balance izquierda/derecha, muestras de prueba para escuchar el efecto y una guarda que limita cuánto se pueden realzar graves y agudos para no forzar los altavoces (se puede desactivar).

Remapeo de botones cooperando con el demonio que ya controla el mando en tu sistema (Handheld Daemon en Bazzite, InputPlumber en SteamOS), en lugar de pelearse con él. Incluye un aviso en Ajustes si detecta un conflicto de configuración. Esta parte está todavía en fase temprana.

Editor del overlay de rendimiento de MangoHud integrado en el panel. Permite elegir y ordenar todo el catálogo de métricas disponible, agrupar GPU, CPU y batería como las representa MangoHud, añadir texto, separadores y espacios, aplicar presets y ajustar posición, tipografía, colores, opacidad y espaciado con una previsualización inmediata. También puede mostrar valores propios de Panel de Control —TDP, Auto‐TDP, ventiladores, perfil, batería o frecuencia de GPU— usando solo lecturas reales; si una fuente no está disponible, se muestra -.

La configuración se puede preparar sin un juego abierto: queda marcada como pendiente hasta que exista una instancia compatible de MangoHud. El panel distingue entre guardado y aplicado, verifica el archivo escrito y conserva cualquier presets.conf personal para restaurarlo al desactivar el HUD.

Gestiona las opciones de lanzamiento de cada juego sin pelearte con la sintaxis de Steam. La lista muestra tus juegos con su portada (Steam y no‐Steam, incluido el arte que tú les hayas puesto), ordenada por uso reciente, con buscador y otros criterios de orden. Cada opción es una fila con su explicación en claro y un interruptor: activas variables de Proton (FSR4, sincronización, HDR, escalado...) y envoltorios como MangoHud, y solo te ofrece las que tu versión de Proton soporta de verdad, comprobándolo en el propio juego. Respeta lo que ya tuvieras puesto (EmuDeck, launchers, tus ajustes a mano). Puedes definir tus propias variables reutilizables entre juegos, ocultar los que no usas (las herramientas como las versiones de Proton se ocultan solas) y saltar directo al juego que tengas abierto. También añade una entrada en el menú del juego en tu biblioteca.

Idioma (con banderas, no un desplegable), el interruptor de "aprender de mi uso" (la telemetría es 100% local y se puede apagar), y un botón para borrar lo aprendido. En "Personalizar interfaz" reordenas y ocultas pestañas y bloques, activas o desactivas módulos enteros (desactivar apaga esa función en todo el panel; ocultar solo deja de mostrarla), creas tus propias pestañas (vistas personalizadas) con los bloques que quieras de cualquier categoría y las colocas en el orden que prefieras entre las demás, y eliges el color de acento de una paleta.

Todo el panel se maneja al 100% con el mando: el elemento en el que está el cursor se marca con un borde de acento claro, así que no hace falta la pantalla táctil.

Panel de Control conoce nueve modelos y, para cualquier otro, intenta funcionar sondeando las capacidades reales del hardware. Esta tabla es honesta sobre qué está comprobado en cada equipo y qué todavía no: prefiero enseñarte un "sin confirmar" antes que un "sí" falso. Las diferencias vienen de lo que cada fabricante deja tocar por firmware y del kernel de cada distro.

Leyenda: ✅ comprobado en ese equipo · ⚠️ limitado o solo por defecto · ❌ no disponible · ❔ el código lo soporta pero aún no está confirmado en ese equipo

Cualquier otro portátil cae en un perfil genérico experimental: el plugin sondea las capacidades reales y muestra lo que consigue, ocultando honestamente el resto.

El OneXPlayer OneXFly Apex (Ryzen AI Max+ 395) ya se reconoce por su nombre y entra como experimental. El control de TDP va por la vía genérica de AMD, así que debería funcionar; los ventiladores y el límite de carga se activan solo si el equipo expone los nodos, y hasta que alguien lo pruebe en mano preferimos no dar nada por hecho. Si tienes uno, los reportes desde Ajustes ayudan un montón a afinarlo.

El AOKZOE A1X (Ryzen AI 9 HX 370) también se reconoce por su nombre y entra como experimental. Su TDP va por la misma vía genérica de AMD (ryzenadj), pero con un techo de 30 W en vez de quedarse capado a los 15 W del perfil genérico. Igual que con el OneXFly no lo tenemos en mano, así que los reportes desde Ajustes son oro para confirmar lo que responde de verdad.

La GPD Win Mini 2025 (Ryzen AI 9 HX 370/365) y la MSI Claw A8 (Ryzen Z2 Extreme) también se reconocen por su nombre y entran como experimentales. Antes salían como genéricas y el TDP se quedaba en 15 W; ahora suben hasta un techo seguro de 35 W (el máximo que homologa el fabricante, muy por debajo del cTDP teórico del chip) con sus tres presets afinados. Van por la misma vía genérica de AMD (ryzenadj) y no las tenemos en mano, así que los reportes desde Ajustes ayudan a confirmarlo.

En la misma tanda se reconocen unas cuantas más, todas experimentales y con un techo seguro homologado: la OneXPlayer F1 Pro (Ryzen AI 9 HX 370, hasta 30 W), la GPD Win 5 (Ryzen AI Max 385 "Strix Halo", hasta 55 W), la GPD Win Max 2 (Ryzen 7 8840U, hasta 35 W) y la ROG Xbox Ally con el Ryzen Z2 A (la blanca), que además tenía un tope de firmware falso de 100 W y ahora queda capada a los 20 W reales que homologa ASUS. La Legion Go 2 con el Ryzen Z2 normal (no Extreme) también se detecta ya con su nombre en vez de como equipo genérico. En todo lo que no tenemos en mano, los reportes desde Ajustes son los que confirman lo que responde de verdad.

1. El Claw controla el TDP por intel-rapl, que solo expone el límite base (PL1); no hay raíles de boost separados que ajustar.
2. En Steam Deck la lectura de carga de GPU es instantánea y muy ruidosa; el auto-TDP la promedia antes de decidir.
3. El perfilado de consumo en Intel (RAPL / i915) todavía no está implementado, así que el auto-TDP por GPU no está disponible en el Claw. El resto del control de TDP sí funciona.
4. La escritura de frecuencia de GPU está implementada por dispositivo, pero aún no se ha confirmado con un cambio en vivo en ningún equipo. Marcado como sin confirmar hasta validarlo.
5. El contador de ciclos solo lo rellena el firmware de Lenovo; en ASUS, Steam Deck y MSI el nodo da un 0 falso, así que se oculta en vez de mostrar un cero inventado.
6. La Legion Go original (83E1) no expone conservation_mode, así que no ofrece límite de carga.
7. En Legion el límite de carga es un interruptor de "modo conservación" con un porcentaje fijo por firmware, no un valor ajustable.
8. El Intel Core Ultra del Claw no tiene hyperthreading, así que no hay multihilo que activar o desactivar.
9. En el MSI Claw el chip de ventilador (msi_wmi_platform) expone las RPM (el monitor sí muestra los dos ventiladores; a temperatura baja giran a 0 en modo silencioso), pero su kernel no permite escribir la curva. La curva que aplica el firmware se lee por el EC y se muestra en modo solo lectura; la edición está en desarrollo (el control de velocidad se ajustará de forma segura).
10. La Legion Go 2 no expone un ventilador escribible por hwmon; el RPM tendría que leerse por el EC y en la build actual no está apareciendo en el monitor. Por eso lo marco como no disponible / sin confirmar hasta que pueda revisarlo.
11. La Legion Go original controla la curva de ventilador por el driver de kernel legion_wmi_fan, que va en los kernels que lo incluyen y se enciende solo cuando está presente. Donde no está (SteamOS actual y algunos kernels), el ventilador lo gobiernan los modos de firmware (Silencioso/Equilibrado/Rendimiento) desde el arco de Potencia, que ajustan potencia y ventilador a la vez. El monitor de velocidad funciona siempre: si el driver no publica el nodo hwmon, la RPM se lee por el EC.
12. La Legion Go S controla el ventilador por una vía no oficial del controlador integrado (EC), así que es un control experimental y opcional: hay que activarlo a mano, con un tope de velocidad de seguridad. Desactivado, se queda solo en monitor.
13. En Intel el color solo se aplica mientras el compositor está activo, así que se fuerza esa ruta y se avisa del pequeño coste.
14. El preset "Aspecto OLED" se oculta en los paneles que ya son OLED (Steam Deck OLED, Legion Go 2) porque no tiene sentido allí.
15. El remapeo coopera con el demonio del sistema (HHD en Bazzite, InputPlumber en SteamOS) y está en fase temprana. En Steam Deck no aparece; en Legion Go S y ROG Xbox Ally X la app indica que todavía no hay remapeo para ese mando. En Legion algunos botones traseros aún no se detectan bien.
16. La Steam Deck no lleva iluminación RGB, así que esta tarjeta no aparece.
17. El ecualizador usa el filter-chain de PipeWire (disponible en SteamOS y Bazzite). El realce de graves y el nivelado de volumen necesitan el plugin CAPS del sistema; si no está instalado, el ecualizador funciona igual pero sin esos dos extras.

Las celdas marcadas ❔ son las que aún no he confirmado en ese equipo concreto. Si tienes el hardware delante y ves que algo va (o no va), dímelo y lo corrijo: la idea es que esta tabla refleje la realidad, no lo que el código intenta hacer.

Panel de Control se distribuye fuera de la tienda de Decky. Instala primero Decky Loader y luego:

1. Descarga Panel de Control.zip de la última release.
2. En Decky, usa Modo desarrollador → Instalar plugin desde ZIP (o tu método de instalación manual preferido).

Una vez instalado, el plugin puede actualizarse solo desde sus ajustes.

Las releases publicadas una vez el repositorio es público se firman con build provenance. Cuando la firma esté disponible, puedes confirmar que el zip salió de verdad del pipeline de este repositorio:

gh attestation verify "Panel de Control.zip" --repo Hooandee/panel-de-control

La gracia de Panel de Control no es solo tener botones bonitos, es que aprende de cómo usas cada juego para proponerte una configuración mejor: qué curva de ventilador te mantiene fresco sin ruido, qué potencia te da fotogramas estables sin vaciar la batería. Todo ese aprendizaje se queda en tu equipo, no sale de él, y puedes apagarlo o borrarlo cuando quieras desde Ajustes.

El principio que atraviesa todo el proyecto: nunca fingir. Si una lectura no está disponible, se oculta en vez de mostrar un cero falso. Si el hardware rechaza un cambio, la interfaz lo refleja. Un número en pantalla es un número real.

Este plugin se apoya en el trabajo de mucha gente de la comunidad de handhelds. Referencio las interfaces del kernel (que son hechos, no código) con libertad, y cuando adapto una idea o algo de código lo cito aquí. La lista completa con licencias está en THIRD_PARTY_NOTICES.md.

• SimpleDeckyTDP (BSD-3, Aarron Lee). La referencia principal del mecanismo de TDP por dispositivo: las rutas de firmware-attributes de Lenovo y ASUS, el paso previo de platform_profile=custom, y el uso de ryzenadj.
• Handheld Daemon (HHD) (LGPL-2.1). Referencia para la estrategia por dispositivo, la reaplicación al despertar y al cambiar de corriente, y la cooperación con el demonio de mandos. Solo miré el enfoque, no copié su código.
• RyzenAdj (LGPL-3.0). Lo invocamos como proceso externo para el camino genérico de AMD cuando no hay una ruta de firmware mejor; no se empaqueta dentro del plugin.
• PowerControl . Origen de la ruta de firmware-attributes de Lenovo que hereda SimpleDeckyTDP.
• Fantastic y PowerTools . Referencia para el monitor y el control de ventiladores y para la reaplicación periódica.
• Decky Loader y su plantilla de plugins. La base sobre la que corre todo esto.
• decky-steamgriddb (GPL-3.0). De aquí adapté la técnica para añadir la entrada de Parámetros al menú contextual de un juego en la biblioteca. Esa adaptación es la razón de que el plugin sea GPL-3.0.
• La documentación del kernel de Linux (firmware-attributes, powercap, asus-wmi, hwmon, power_supply). De donde salen las rutas de sysfs que leo y escribo.

Las contribuciones son bienvenidas. Lee CONTRIBUTING.md y el Código de Conducta.

¿Encontraste una vulnerabilidad? Repórtala en privado, mira la Política de Seguridad. No abras un issue público.

GPL-3.0 © Hooandee. Software libre para la comunidad: cualquiera puede usarlo, estudiarlo y modificarlo, y quien lo distribuya (con o sin cambios) debe hacerlo también bajo GPL con el código disponible. Las atribuciones de terceros y los detalles de licencia (incluido decky-steamgriddb, del que adapto el menú contextual, y ryzenadj, que se invoca como proceso externo y no se empaqueta) están en THIRD_PARTY_NOTICES.md.