spectacle-uploader
Plugin KDE Purpose para Spectacle que permite subir capturas a servidores propios sin servicios externos. Cliente HTTP genérico en Python estándar con soporte Wayland/X11.
Ficha actualizada 26 sept 2026, 14:50 · upstream 26 sept 2026, 14:46 · release sin release detectada
Qué es spectacle-uploader
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Spectacle Uploader es un plugin de KDE Purpose diseñado para integrarse en el menú Exportar → Compartir de Spectacle, permitiendo a los usuarios subir capturas de pantalla a servidores propios sin depender de servicios externos como Lightshot o Imgur. La aplicación está construida como un único archivo Python 3 que utiliza exclusivamente la biblioteca estándar, eliminando la necesidad de instalaciones adicionales con pip.
El sistema funciona como un cliente HTTP genérico configurable mediante un archivo JSON, aceptando múltiples métodos de carga (multipart form data o PUT raw) y extrayendo las URLs resultantes desde respuestas JSON, texto plano o expresiones regulares. Incluye ejemplos documentados para servidores propios, Cloudflare Workers con R2 y autenticación mediante tokens Bearer o Cloudflare Access.
La arquitectura es extremadamente minimalista: no requiere Docker ni bases de datos externas. La instalación se realiza mediante un script que coloca el plugin en ~/.local/share/kpackage/Purpose/ y gestiona el portapapeles nativo (wl-clipboard para Wayland, xclip/xsel para X11) junto con notificaciones del sistema.
- Compartir capturas a un servidor propio sin depender de servicios externos como Lightshot o Imgur
- Implementar autenticación personalizada con tokens Bearer o Cloudflare Access en el backend
- Usar almacenamiento en la nube (R2) como backend para capturas sin necesidad de servidor dedicado
- Integrar en flujos de trabajo KDE Plasma 6 sin instalar dependencias externas adicionales
- Cero dependencias externas, solo Python estándar y librerías del sistema operativo
- Soporte nativo para Wayland (wl-clipboard) y X11 (xclip/xsel)
- Configuración flexible mediante JSON para múltiples tipos de servidores HTTP
- Ejemplos documentados para Cloudflare Workers, R2 y servidores propios con Python
- Requiere KDE Plasma 6 con Spectacle 6 y el framework Purpose instalado previamente
- No sigue redirecciones HTTP automáticamente, lo que puede fallar con proxies de login
- Los enlaces generados son públicos; no hay expiración ni control de acceso en el servidor por defecto
- El plugin muestra errores si el servidor destino bloquea el User-Agent predeterminado de Python
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar vía ./install.sh en ~/.local/share/kpackage/Purpose/. Configurar config.json con credenciales y URL del servidor destino. Mantener permisos 600 en la configuración por seguridad. Verificar que el portapapeles esté instalado según el entorno de sesión (Wayland/X11). Reiniciar Spectacle tras modificar la configuración.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.