PowerPulse: match validate-spice layout and metadata.

Author: vicman

powerpulse@vicman.app/README.md

@@ -1,182 +1,32 @@
 # PowerPulse
 
-**Desklet para Linux Mint Cinnamon** que muestra de forma rápida y visual el nivel de batería de tus dispositivos inalámbricos.
+Compact battery monitor for the Cinnamon desktop.
 
-Combina **UPower** (D-Bus) y **HeadsetControl** en una tarjeta compacta sobre el escritorio.
+PowerPulse shows wireless device battery levels on the desktop using **UPower**. **HeadsetControl** is optional and adds extra headset readings when that program is installed from your distribution.
 
-Repositorio: [https://github.com/vicman/PowerPulse](https://github.com/vicman/PowerPulse)
+![PowerPulse](screenshot.png)
 
-![PowerPulse en el escritorio](docs/screenshot.png)
+## Features
 
-<p align="center">
-  <em>MX Keys · Logitech G933 · Laptop · Basilisk V3 Pro — ordenados por batería ascendente</em>
-</p>
+- Automatic discovery of UPower batteries (laptop, mouse, keyboard, headset, speakers, and similar devices)
+- Compact cards with icon, name, percentage and progress bar
+- Click a device to expand details (status, time remaining, voltage, health)
+- Hover panel with extra device info and actions
+- Configurable sort order, low-battery notifications, and compact mode
+- Spanish and English translations
 
----
+## Optional dependency
 
-## Características
+HeadsetControl is not required. Without it, PowerPulse still lists every battery that UPower reports.
 
-- Descubrimiento automático de baterías vía **UPower** (portátil, teclado, ratón, headset, etc.)
-- Soporte opcional de **HeadsetControl** (p. ej. Logitech G933)
-- Vista **compacta**: icono, nombre, porcentaje y barra
-- Vista **expandida** al hacer clic (detalles in-place, sin ventanas)
-- Resumen global al hacer clic en el título **PowerPulse**
-- Orden configurable (por defecto: batería ascendente — lo más bajo primero)
-- Indicadores visuales: ⚡ carga · 🔌 enchufe · 🔋 batería · ⚠ baja · 🟥 crítico
-- Notificaciones de batería baja (una sola vez por ciclo)
-- Temas claros/oscuros, HiDPI, localización ES/EN
-- Arquitectura modular lista para nuevos proveedores (OpenRazer, Solaar, Bluetooth…)
+If your distribution packages HeadsetControl, install it with the system package manager. Do not download extra desklet code from outside Cinnamon Spices.
 
-## Requisitos
+## Usage
 
-| Componente | Obligatorio | Notas |
-|------------|-------------|--------|
-| Linux Mint Cinnamon 6.x | Sí | Probado en Cinnamon 6.6 / Mint 22 |
-| UPower | Sí | Incluido en Mint |
-| [HeadsetControl](https://github.com/Sapd/HeadsetControl) | No | Solo para auriculares compatibles (G933, etc.) |
+| Action | Result |
+|--------|--------|
+| Click a device | Expand or collapse details |
+| Click the title | Show a short summary |
+| Right-click | Desklet menu (refresh, sort, settings) |
 
-Sin HeadsetControl, PowerPulse sigue mostrando todos los dispositivos reportados por UPower.
-
-## Instalación
-
-### Paquete del sistema (recomendado)
-
-Genera e instala el `.deb` nativo de Linux Mint / Debian / Ubuntu:
-
-```bash
-chmod +x build-installer.sh
-./build-installer.sh
-sudo apt install ./dist/cinnamon-desklet-powerpulse_1.3.0_all.deb
-```
-
-También puedes hacer **doble clic** en el `.deb` desde el gestor de archivos.
-
-El zip de distribución (`dist/powerpulse@vicman.app-1.3.0.zip`) incluye el README y el `.deb`.
-
-Si antes lo instalaste con `./install.sh`, quita la copia de usuario para que no oculte el paquete del sistema:
-
-```bash
-./uninstall.sh
-```
-
-Luego:
-
-1. Clic derecho en el escritorio → **Añadir Desklets…**
-2. Busca **PowerPulse** y añádelo
-
-```bash
-sudo apt remove cinnamon-desklet-powerpulse
-```
-
-### Instalación en la carpeta de usuario
-
-```bash
-git clone https://github.com/vicman/PowerPulse.git
-cd PowerPulse
-chmod +x install.sh uninstall.sh
-./install.sh
-```
-
-El script copia el Desklet a:
-
-```text
-~/.local/share/cinnamon/desklets/powerpulse@vicman.app/
-```
-
-Luego:
-
-1. Clic derecho en el escritorio → **Añadir Desklets…**
-2. Busca **PowerPulse** y añádelo
-
-### Desinstalación (carpeta de usuario)
-
-```bash
-./uninstall.sh
-```
-
-## Uso rápido
-
-| Acción | Resultado |
-|--------|-----------|
-| Clic en un dispositivo | Expande / contrae sus detalles |
-| Clic en **PowerPulse** | Resumen global (conteos, proveedores, versión) |
-| Clic derecho | Menú contextual |
-| Menú → **Actualizar ahora** | Fuerza una lectura nueva |
-
-### Menú contextual
-
-- Actualizar ahora
-- Gestión de energía
-- Ordenar por…
-- Modo compacto
-- Expandir / contraer todo
-- Configuración
-- Copiar resumen
-
-## Configuración
-
-Desde el menú del Desklet o *Preferencias → Desklets → PowerPulse*:
-
-- Intervalo de actualización
-- Orden predeterminado (batería ↑ / ↓, nombre, tipo, última actualización, manual)
-- Nombre amigable de la batería del portátil (por defecto `Laptop`)
-- Mostrar solo conectados, iconos, porcentaje, barras
-- Tiempo restante, voltaje, salud y ciclos (en la vista expandida)
-- Umbral de batería baja y notificaciones
-- Comando y timeout de HeadsetControl
-
-## Captura
-
-![Captura de PowerPulse](docs/screenshot.png)
-
-## Arquitectura
-
-Diseñado para ampliar proveedores **sin tocar el núcleo de la UI**:
-
-```text
-powerpulse@vicman.app/
-├── desklet.js              # Orquestador
-├── providers/              # UPower, HeadsetControl (+ futuros)
-├── models/                 # Modelo de dispositivo y ordenación
-├── ui/                     # Tarjetas y panel de resumen
-├── animations/             # Animaciones cortas
-├── utils/                  # Formato y parser
-├── settings/
-├── stylesheet.css
-├── settings-schema.json
-└── metadata.json
-```
-
-Proveedores previstos a futuro: OpenRazer, Solaar, Bluetooth Battery Service, gamepads, UPS, stylus, Android/iPhone, Apple Magic Devices.
-
-## Desarrollo
-
-```bash
-# Editar → reinstalar → recargar Cinnamon (Alt+F2 → r → Enter)
-./install.sh
-
-# Pruebas unitarias del parser / ordenación
-node tests/run_tests.js
-
-# Diagnóstico del sistema
-./diagnose.sh
-upower -e
-headsetcontrol -b
-```
-
-## Identidad
-
-| | |
-|--|--|
-| **Nombre** | PowerPulse |
-| **UUID** | `powerpulse@vicman.app` |
-| **Versión** | 1.3.0 |
-| **Autor** | VicMan |
-| **Repositorio** | [https://github.com/vicman/PowerPulse](https://github.com/vicman/PowerPulse) |
-| **Licencia** | [GPL-3.0](LICENSE) |
-| **Plataforma** | Linux Mint Cinnamon 6.x |
-
-## Licencia
-
-Este proyecto se distribuye bajo los términos de la **GNU General Public License v3.0**.  
-Consulta el archivo [LICENSE](LICENSE) para el texto completo.
+Configure the desklet from the context menu or *System Settings → Desklets → PowerPulse*.

powerpulse@vicman.app/files/powerpulse@vicman.app/icon.png

@@ -1,8 +1,7 @@
 {
     "uuid": "powerpulse@vicman.app",
     "name": "PowerPulse",
-    "description": "Monitor compacto de baterías para dispositivos inalámbricos mediante UPower y HeadsetControl.",
-    "icon": "battery-good-symbolic",
+    "description": "Compact wireless battery monitor using UPower and HeadsetControl.",
     "prevent-decorations": true,
     "max-instances": "1",
     "author": "VicMan",

powerpulse@vicman.app/files/powerpulse@vicman.app/metadata.json

@@ -1 +1,3 @@
-{"author": "vicman"}
+{
+    "author": "vicman"
+}