Punchi Dock Remastered es una reescritura modular y nativa del popular plasmoide Punchi Dock. Se ha rediseñado desde cero para integrarse sin costuras en entornos modernos basados en KDE Plasma 6 y Wayland, preservando un rendimiento excepcional y una estética sumamente premium.

Sobre Punchi Dock Remastered

El proyecto combina la flexibilidad de un widget de Plasma con las capacidades de un módulo nativo en C++ (Qt 6), lo que permite ofrecer una excelente gestión de procesos, soporte robusto para audio mediante PipeWire y controles interactivos sin degradar la fluidez del compositor KWin.

¿Por qué Remastered?

La versión original para Plasma 5 sufría limitaciones debido a dependencias en desuso y transiciones bruscas. Esta edición Remastered introduce:

Motor C++ / QML
Módulo compilado específico para resolver y renderizar la actividad del sistema de forma eficiente.
Optimizado para Wayland
Diseñado para funcionar nativamente bajo el protocolo de Wayland sin recurrir a hacks heredados de X11.
Modularidad Extrema
Componentes bien delimitados en lugar de concentrar la interfaz entera dentro de un único archivo general.

Capacidades Principales

Punchi Dock Remastered no es solo un lanzador, es una suite completa de control e interacción para tu panel de escritorio.

Modo Flotante y Panel
Úsalo como un dock flotante clásico en tu escritorio o colócalo dentro de un panel oficial de Plasma adaptándose de inmediato.
Vistas de Carpetas Flexibles
Los popups de carpeta admiten vistas en Cuadrícula (Grid), Lista (List) y Detalle (Detail) con soporte para navegación por teclado.
Visualizador de Audio
Un visualizador opcional basado en PipeWire que procesa los espectros de sonido directamente en memoria y se dibuja sobre el fondo.
Notas Rápidas Integradas
Crea notas directamente desde tu dock, con guardado automático y confirmación al eliminarlas.
Biblioteca de Temas JSON
Soporte para cargar estilos avanzados en 2D y 2.5D con bordes degradados, reflejos de iconos y sombras adaptativas.
Gestión de Papelera Nítida
Operaciones asíncronas de vaciado con sonidos de confirmación y notificaciones integradas en la bandeja del sistema.

Novedades de la Versión 0.9.2

La v0.9.2 incorpora soporte nativo para paneles verticales y laterales de Plasma 6, adaptando la distribución, indicadores y despliegue de popups al eje vertical.

Paneles Laterales y Verticales Nativos

La composición del dock cambia de forma fluida entre orientación en fila o columna según el panel en el que se ubique, conservando el espacio, los separadores y la animación interactiva de la ola.

Popups Orientados al Interior

Menús desplegables, contenido de carpetas, vistas previas de ventanas y tarjetas multimedia se orientan y abren de forma inteligente hacia la zona útil de la pantalla sin importar el borde del escritorio.

Controles Multimedia Accesibles

Las tarjetas de reproducción MPRIS integran una acción dedicada para silenciar o restaurar el volumen con un solo clic, completamente accesible mediante navegación por teclado.

Compatibilidad Extendida

Optimizado para KDE Plasma 6 y Wayland en Fedora 44+, con flujos de compilación y empaquetado nativos probados en Debian 13 (Trixie) y Kubuntu 26.04+.

Guía de Instalación

Dado que Punchi Dock incluye componentes nativos C++, debes instalar el paquete correspondiente a tu distribución para asegurar la compatibilidad binaria.

1. Instalación del Paquete Precompilado (.plasmoid)

Si eres usuario final y no deseas compilar el código, puedes descargar el paquete precompilado adecuado para tu distribución directamente desde la página oficial del proyecto en la KDE Store e instalarlo mediante kpackagetool6 (no se necesitan herramientas de desarrollo).

Comando para instalar por primera vez:

kpackagetool6 --type Plasma/Applet --install ./punchi-dock-remastered-0.9.2-fedora44-x86_64.plasmoid

Comando para actualizar una versión existente:

kpackagetool6 --type Plasma/Applet --upgrade ./punchi-dock-remastered-0.9.2-fedora44-x86_64.plasmoid

Nota: Recuerda reiniciar la shell de Plasma después de instalar o actualizar para aplicar los cambios ejecutando systemctl --user restart plasma-plasmashell.service o cerrando sesión.

Compilar desde el Código Fuente

Si prefieres compilar e instalar localmente el módulo binario, sigue estos pasos:

Requisitos previos para la compilación (Fedora)

Instala las herramientas de compilación y las librerías de desarrollo de Qt6, KF6 y Plasma:

sudo dnf install binutils cmake gcc-c++ ninja-build extra-cmake-modules \
    qt6-qtdeclarative-devel \
    kf6-kcoreaddons-devel kf6-kio-devel kf6-kjobwidgets-devel \
    kf6-kservice-devel libplasma-devel \
    pipewire-devel gettext \
    zip unzip

Comandos de compilación y empaquetado

El repositorio incluye scripts automatizados para verificar el entorno y generar el paquete adecuado para tu distribución actual:

1. Verificar dependencias del sistema:

./scripts/check-build-environment.sh

2. Compilar y empaquetar en un archivo .plasmoid:

./scripts/empaquetar-plasmoid.sh

3. Compilar, instalar localmente y reiniciar Plasma Shell (Entorno de pruebas):

./scripts/probar-plasmoid.sh

Matriz de Compatibilidad

Distribución Estado de Soporte Notas del Entorno
Fedora 44+ Soporte Oficial Principal Objetivo principal de distribución y testing de QA del proyecto.
Debian 13 (Trixie) Soporte Secundario Validador Validado con paquetes nativos y Qt 6.8.2.
Kubuntu 26.04+ (Plasma 6) Soporte Secundario Validador Validado localmente en Plasma 6.6.4 (compilación local recomendada).
Otras Distros (Arch, openSUSE) Compatibilidad Comunitaria Funcionamiento reportado correcto por la comunidad compilando desde fuentes.
Proyecto GPL-3.0-or-later de PunchiSoft Ver repositorio oficial