🎬 Anime Light

Conversor optimizado de anime a resoluciones ligeras (360p/480p/720p/1080p) usando FFmpeg.

Bueno, esta es una solución para las personas que, como yo, tienen realmente poco espacio de almacenamiento pero, aún así, no quieren deshacerse de todos los archivos que tienen. Lo principal para mi era poder hacer streaming de los anime que descargo para Jellyfin, sobre todo a mi teléfono... razón por la cual, no siempre requiero archivos en 1080p, y 480p-720p suele ser un estpandar de calidad aceptable para mi... pero encontrar archivos en 480 o en 720 ligeros (algo que en el anime, que tiene muchos frames fijos o con pocos cambios) es dificil últimamente, así que quise implementar esta solución y me ha funcionado muy bien. Lo siguiente fue implementarla en forma de CLI!

La librería implementa una cli para convertir archivos de anime (esto es importante, está optimizado para este estilo, ya que el anime se caracteriza por tener muchas imágenes estáticas entre frame y frame y manejar una tasa de unos 24 cuadros por segundo). Se puede usar tanto como librería como mediante la CLI. De momento se puede convertir a 360p, 480p, 720p y 1080p (es decir, SD y HD).

Sin más, espero que les parezca útil y, si se les ocurre alguna cosa que agregar, estaré encantado de aceptar colaboraciones y/o sugerencias!

🚀 Instalación

Requisitos previos

• FFmpeg instalado y en tu PATH.

  # En Linux/macOS (usando Homebrew):
  brew install ffmpeg
  
  # En Windows (usando Chocolatey):
  choco install ffmpeg
  

Instalar el paquete

pip install anime-light

💻 Uso básico

Comandos principales

Opciones avanzadas

# Convertir a 720p con máxima compresión (archivos pequeños)
anime-light "episodio.mp4" --resolution 720p --crf 26 --preset veryslow

# Especificar directorio de salida personalizado
anime-light "video.mp4" --output-dir "D:/anime_convertido"

# Audio de baja calidad (para ahorrar espacio)
anime-light "video.mp4" --audio-bitrate 64k

Sobre uso de GPU

He estado intentando agregar soporte para el manejo de GPU, pero la verdad no sé si esa parte está funcionando bien. En todo caso, podrán probar con opciones como:

1. Para Intel QSV:

   anime-light "video.mp4" --use-gpu qsv
   

2. Para NVIDIA CUDA:

   anime-light "video.mp4" --use-gpu cuda
   

Métodos según GPU que están incluídos en el código

Sinceramente, estoy desarrollando esto en un equipo algo viejo y limitado (un i3 de 4ta), así que el primer caso, el de una GPU Intel integrada es l oque disponía, pero si les soy sincero, no he logrado determinar si estoy usando bien los recursos (o si, siquiera, los estoy empleando)... si alguien con más experiencia y conocimientos al respecto está dispuesto a chequear o mejorar esa parte, bienvenida sea la PR!

📊 Tabla de parámetros recomendados

ℹ️ Nota: Valores CRF más bajos = mejor calidad pero mayor tamaño.

🛠️ Ejemplos prácticos

1. Convertir un solo archivo

anime-light "Onepiece_Ep1000.mp4" --resolution 480p --crf 24

Estructura de salida:

./Onepiece_Ep1000[480p].mp4

2. Procesar una carpeta completa

anime-light "~/anime/Shingeki_no_Kyojin/" --resolution 720p --output-dir "~/converted"

Estructura de salida:

~/converted/
└── 720p/
    ├── Shingeki_no_Kyojin_Ep1[720p].mp4
    ├── Shingeki_no_Kyojin_Ep2[720p].mp4
    └── ...

📌 Notas importantes

• ✅ Formatos soportados: .mp4, .mkv, .avi, .mov.
• ⚠️ Espacios en rutas: Usa comillas: "ruta con espacios/video.mp4".
• 🔄 Sobrescritura: Los archivos existentes se sobrescriben automáticamente en el output, pero no se toca los archivos originales. Se genera un directorio "temp" para evitar posibles conflictos y no contaminar el directorio de salida.

🐛 Reportar problemas

¿Encontraste un error? ¡Abre un issue en GitHub!

📜 Licencia

MIT © Gabriel Baute