Personal Scripts Hub

Una colección comprensiva de scripts personalizados para sistemas Linux (KDE Plasma y Linux Mint) que automatizan tareas comunes y optimizan el flujo de trabajo diario.

📋 Tabla de Contenidos

• Descripción General
• Estructura del Proyecto
• Instalación
• Módulos
  • Comic Chapter Generator
  • Scripts para KDE
  • Scripts para Linux Mint
  • Scripts Comunes (Others)
• Requisitos del Sistema
• Contribuciones
• Problemas Conocidos
• Licencia

🌟 Descripción General

Esta colección de scripts y herramientas ha sido diseñada para facilitar y optimizar tareas recurrentes en entornos Linux. Desde la gestión eficiente de cómics digitales hasta la descarga de contenido multimedia, pasando por la optimización de imágenes y la administración del sistema, este repositorio ofrece soluciones prácticas para usuarios de KDE Plasma y Linux Mint.

Este proyecto es un hobby personal compartido con la comunidad. Aunque los scripts han sido probados en mis sistemas, se recomienda revisarlos antes de usar en producción.

📂 Estructura del Proyecto

personal-scripts-hub/
├── comic-chapter-generator/    # Herramienta para procesamiento de cómics digitales
├── For KDE/                    # Scripts integrados con el entorno KDE Plasma
│   ├── For Comics/             # Herramientas específicas para cómics en KDE
│   ├── For yt-dlp/             # Scripts de descarga multimedia para KDE
│   ├── Others/                 # Utilidades generales para KDE
│   └── ServiceMenu/            # Menús de servicio para el gestor de archivos Dolphin
├── For Mint/                   # Scripts adaptados para Linux Mint
│   ├── For Comics/             # Herramientas para cómics en Mint
│   ├── For yt-dlp/             # Scripts de descarga para Mint
│   ├── Nemo Actions/           # Acciones para el gestor de archivos Nemo
│   └── Others/                 # Utilidades generales para Mint
├── For Windows/                # Scripts para Windows
│   └── FileMenuTools Scripts/  # Scripts para FileMenuTools
└── Others/                     # Scripts comunes y utilitarios diversos

⚙️ Instalación

Instalación Completa

git clone https://github.com/yourusername/personal-scripts-hub.git
cd personal-scripts-hub

# Para sistemas KDE Plasma
cd For\ KDE/
chmod +x install.sh
./install.sh

# Para sistemas basados en Linux Mint
cd For\ Mint/
chmod +x install.sh
./install.sh

# Para instalación independiente del Comic Generator
cd comic-chapter-generator/
chmod +x setup.sh
./setup.sh

Instalación de Componentes Individuales

También puedes instalar componentes específicos copiando manualmente los scripts a las ubicaciones correspondientes:

• Scripts Python: ~/.local/bin/
• Menús de servicio de KDE: ~/.local/share/kio/servicemenus/
• Acciones de Nemo: ~/.local/share/nemo/actions/

🧩 Módulos

Comic Chapter Generator

Herramienta completa con interfaz gráfica para procesar colecciones de cómics. Convierte imágenes a formato WebP, genera portadas numeradas y empaqueta todo en archivos CBZ.

Características principales:

• Conversión masiva de imágenes a formato WebP para optimizar espacio
• Numeración automática de portadas de capítulos
• Soporte para capítulos enteros y medios (ej. 1.5)
• Creación de archivos CBZ compatibles con lectores estándar
• Personalización de la posición y estilo de los números de capítulo

Uso:

cd comic-chapter-generator
./run.sh

Documentación detallada del Comic Generator

Scripts para KDE

Colección de scripts y menús de servicio diseñados específicamente para el entorno KDE Plasma. Estos scripts se integran con el gestor de archivos Dolphin y añaden funcionalidades para optimizar el flujo de trabajo.

Categorías:

• For Comics: Scripts para la gestión de cómics digitales

  • Interfaces gráficas para generación de CBZ
  • Herramientas de conversión de imágenes

• For yt-dlp: Herramientas para descargar contenido multimedia

  • Descarga de álbumes de YouTube Music
  • Captura de transmisiones en vivo
  • Descarga de listas de reproducción y canciones

• ServiceMenu: Acciones para el menú contextual de Dolphin

  • Conversión de formatos de imagen (WebP, JPG, PNG, JXL, AVIF)
  • Procesamiento de videos (división, conversión)
  • Optimización de imágenes
  • Extracción de texto de subtítulos
  • Integración con Fal.ai para IA de procesamiento de imágenes

• Others: Utilidades generales para administración del sistema

  • Desmontaje seguro de unidades externas
  • Gestión de contenedores Podman/Docker

Documentación detallada de Scripts KDE

Scripts para Linux Mint

Adaptaciones de los scripts principales para funcionar en Linux Mint con Cinnamon y el gestor de archivos Nemo. Incluye acciones de Nemo y diálogos GTK/Zenity.

Categorías:

• For Comics: Versión adaptada de las herramientas de cómics
• For yt-dlp: Scripts de descarga multimedia adaptados
• Nemo Actions: Menús contextuales para Nemo
  • Procesamiento de imágenes y documentos
  • Herramientas para imágenes con IA (Fal.ai)
  • Conversión de formatos
• Others: Configuraciones y aplicaciones para Mint

Scripts Comunes (Others)

Colección de scripts utilitarios genéricos que funcionan en cualquier distribución Linux. Incluye herramientas para administración del sistema y automatización de tareas comunes.

Scripts para Windows

Colección de scripts diseñados para funcionar en Windows, específicamente para FileMenuTools. Incluye scripts para conversión de formatos de imagen.

Contenido:

• FileMenuTools Scripts: Scripts para el software FileMenuTools
  • Conversión de formatos de imagen (AVIF, JPG, PNG, JXL, WebP)

🔧 Requisitos del Sistema

Requisitos Generales

• Python 3.7+
• Bash
• libvips (para procesamiento de imágenes)

Para KDE

• KDE Plasma 5.x
• Dolphin File Manager
• PyQt5/PyQt6
• kdialog

Para Linux Mint

• Cinnamon Desktop
• Nemo File Manager
• Python-Gtk
• Zenity

Para Herramientas Multimedia

• yt-dlp
• ffmpeg
• ImageMagick

Para Procesamiento con IA

• fal-client (instalado vía pipx)
• Credenciales API configuradas

❓ Problemas Conocidos

• Algunos scripts requieren rutas específicas y pueden necesitar ajustes
• La configuración de fal.ai requiere claves API válidas
• Las acciones de Nemo y menús de KDE pueden necesitar reinicio del gestor de archivos
• La fuente OldLondon.ttf es necesaria para el generador de cómics

---

Nota: Este es un proyecto personal creado para uso propio. Si bien me esfuerzo por hacerlo útil y funcional, puede que no siga todas las mejores prácticas o los estándares profesionales. Úsalo bajo tu propia responsabilidad.