codi-vault es una CLI para guardar localmente cursos, bootcamps y videos de Código Facilito y verlos sin conexión cuando ya tienes acceso legítimo al contenido.
El proyecto está pensado para ejecutarse dentro de su propia carpeta, sin instalar comandos globales en tu sistema.
Este proyecto existe para uso personal y offline: por ejemplo, preparar un curso antes de viajar, estudiar con mala conexión o conservar temporalmente material que ya puedes ver desde tu cuenta.
No está pensado para redistribuir contenido, compartir credenciales, evadir accesos de pago, publicar copias del material ni incumplir los términos de la plataforma. Revisa la guía completa en Uso responsable.
- Restaura una sesión autenticada con cookies locales.
- Detecta si la URL es un curso, bootcamp, video, artículo o quiz.
- Extrae la estructura del contenido con Playwright.
- Resuelve streams HLS de video y los guarda con FFmpeg.
- Evita volver a descargar archivos existentes y reutiliza videos equivalentes cuando puede.
Las descargas separan dos fases:
- Escaneo y resolución de enlaces con Playwright.
- Descarga de videos con FFmpeg usando los streams ya resueltos.
Así, después de escanear un curso o bootcamp, codi-vault no debería abrir una página nueva por cada video que empieza a descargar.
El comando directo download usa Chromium en modo oculto por defecto. El modo interactivo sugiere navegador visible para la fase inicial, porque algunas páginas pueden requerir una comprobación humana antes de entregar el player.
Usa --no-headless solo como modo de rescate cuando Código Facilito o Cloudflare requieran interacción manual:
poetry run facilito download <url> --no-headlessEl comando facilito login sí abre una ventana visible porque puede requerir autenticación manual.
| Herramienta | Uso |
|---|---|
| Python 3.10+ | Ejecutar la aplicación |
| Poetry | Crear y manejar el entorno local del proyecto |
| Playwright Chromium | Navegar Código Facilito con sesión autenticada |
| FFmpeg | Guardar streams HLS como .mp4 |
En macOS:
brew install python@3.12 ffmpeg pipx
pipx install poetryEn Ubuntu/Debian:
sudo apt update
sudo apt install python3 python3-venv ffmpeg
pip install poetrygit clone https://github.com/jdfesa/codi-vault.git
cd codi-vault
poetry env use python3.12
poetry install
poetry run playwright install chromiumEl entorno virtual queda dentro del proyecto como .venv/, por configuración de poetry.toml.
Inicia sesión:
poetry run facilito loginDescarga con el asistente interactivo:
poetry run facilito interactiveO descarga una URL directamente:
poetry run facilito download https://codigofacilito.com/cursos/docker
poetry run facilito download https://codigofacilito.com/programas/java-premium
poetry run facilito download https://codigofacilito.com/videos/...Opciones principales:
| Opción | Descripción |
|---|---|
--quality, -q |
Calidad del video: max, 1080p, 720p, 480p, 360p, min |
--threads, -t |
Hilos de descarga, de 1 a 16 |
--override, -w |
Sobrescribe archivos existentes |
--headless / --no-headless |
Ejecuta el navegador oculto o visible |
Por defecto, si un archivo ya existe, se omite.
Las descargas se guardan en:
Facilito/
Los cursos y bootcamps se organizan por carpetas. Los videos sueltos se guardan en:
Facilito/Videos Sueltos/
funcionamiento.mp4
Ver video desde el repositorio
- Índice de documentación
- Instalación detallada
- Guía de uso
- Uso responsable
- Detalles técnicos
- Solución de problemas
El código se ofrece sin garantía. Es responsabilidad de cada usuario utilizarlo dentro de los límites legales, éticos y contractuales aplicables.