📄 PDF Tool

Una app de escritorio sencilla para trabajar con tus PDFs — sin subir nada a internet.

Comprime, une, divide, protege y marca tus documentos —y conviértelos desde imágenes— desde tu propio ordenador. Gratis, de código abierto y sin anuncios.

✨ Qué puedes hacer

🔐 Todo ocurre en tu equipo. Tus archivos nunca salen de tu ordenador.

En Comprimir PDF, el modo predeterminado busca la reducción máxima. También puedes elegir Conservar texto y enlaces desde el selector de modo; el icono de ayuda explica la diferencia.

⬇️ Descargar e instalar

Ve a la página de descargas y elige el archivo de tu sistema:

🍎 macOS

1. Descarga el archivo .dmg y ábrelo.
2. Arrastra PDF Tool a la carpeta Aplicaciones.
3. Ábrela desde Aplicaciones. macOS mostrará un aviso y no dejará abrirla aún (es normal: la app no está firmada, pero es segura).
4. Ve a Menú Apple () → Ajustes del Sistema → Privacidad y Seguridad.
5. Baja hasta la sección Seguridad: verás un mensaje que dice que se bloqueó “PDF Tool”. Pulsa Abrir de todas formas y confirma con tu contraseña o Touch ID.
   _{Solo hay que hacerlo la primera vez. A partir de ahí se abre con doble clic como cualquier app.}

🪟 Windows

1. Descarga el instalador (.exe) y ejecútalo.
2. Si aparece SmartScreen: Más información → Ejecutar de todas formas.
   _{(El aviso sale porque el instalador no está firmado; es seguro.)}

✅ Tus ajustes se guardan fuera de la app, así que se conservan al actualizar. Cuando publique una nueva versión, la app te avisa con un banner.

🤖 Para agentes de IA y la línea de comandos

Las mismas herramientas están disponibles como comando, pensado para agentes (Claude Code, Cursor, Copilot…) y scripts. Todo sigue ocurriendo en tu equipo.

pipx install pdf-tool-cli                    # solo la CLI (sin la app de escritorio)
pdf-tool list --json                         # qué herramientas hay y qué aceptan
pdf-tool compress informe.pdf --json         # comprimir y obtener el resultado en JSON
pdf-tool merge a.pdf b.pdf --output-name todo
echo "$CLAVE" | pdf-tool protect a.pdf --password-stdin

Cada herramienta tiene su ayuda (pdf-tool compress --help). Códigos de salida: 0 ok · 1 error al procesar · 2 uso inválido · 3 algún archivo del lote falló. pipx install 'pdf-tool-cli[gui]' instala además la app (comando pdftool).

🤝 Contribuir

¡Las contribuciones son bienvenidas! Puedes abrir un issue con ideas o errores, o mandar un pull request. La arquitectura es modular: añadir una herramienta nueva es crear una carpeta y la app la descubre sola. En el roadmap está lo que viene: una CLI para agentes de IA, a la par con la app.

poetry install --all-extras   # incluye Flet (extra [gui]) para la app
poetry run pdftool        # abre la app
poetry run pytest         # corre los tests

git tag v0.2.0
git push origin v0.2.0

poetry run flet build macos      # -> build/macos/pdf-tool.app
poetry run flet build windows    # -> build/windows/