Problema

En entornos donde OneDrive sincroniza bibliotecas de ebooks, es frecuente que, tras una actualización de Windows o una interrupción de la sincronización, un gran número de archivos EPUB aparezcan con la extensión .epu o con nombres truncados (formato 8.3). Al intentar abrirlos con Calibre u otro visor, el programa muestra un error similar a:

ValueError: No plugin to handle input format: epu

El síntoma se manifiesta en:

  • Miles de archivos que antes se leían sin problemas.
  • Mensajes de error que indican “Failed to open the book” o “No plugin to handle input format”.
  • Rutas que incluyen nombres abreviados (UNSORT~1\THEORY~1.EPU).

El problema no se limita a Calibre; cualquier herramienta que dependa de la extensión .epub fallará. La raíz suele estar en la forma en que OneDrive (o el propio sistema de archivos) maneja nombres largos y extensiones cuando la sincronización se pausa o se produce un error de actualización.

Causa

1. Truncamiento de nombres por compatibilidad 8.3

Windows mantiene, por compatibilidad con aplicaciones antiguas, una versión 8.3 de cada nombre de archivo. Cuando la sincronización se interrumpe mientras OneDrive renombra internamente archivos, la versión corta puede quedar como la principal, cambiando .epub a .epu y acortando el nombre del directorio (THEORY~1.EPU).

2. Corrupción de metadatos de la base de datos de OneDrive

OneDrive almacena información de versiones y atributos en una base local (%localappdata%\Microsoft\OneDrive\logs). Un fallo de actualización de Windows (por ejemplo, un security update) puede dejar la base en un estado inconsistente, provocando que la extensión se pierda al re‑escribir el índice.

3. Interrupción de la sincronización mientras Calibre mantiene el archivo abierto

Si la aplicación de lectura mantiene un lock sobre el archivo y OneDrive intenta sincronizar, el motor de sincronización puede crear una copia “temporal” sin extensión completa para evitar conflictos, y esa copia puede quedar como la versión definitiva.

4. Configuración de “Files On‑Demand” desactivada

Cuando la opción Files On‑Demand está desactivada, OneDrive descarga todos los archivos localmente. Si el disco está casi lleno, el sistema puede recortar nombres para ahorrar espacio de metadatos, generando los mismos síntomas.

Solución

La estrategia se divide en tres fases: detener la sincronización, renombrar masivamente y restaurar versiones anteriores cuando sea necesario.

1. Pausar OneDrive y cerrar aplicaciones que usen los EPUB

# Desde la bandeja de OneDrive → Más → Pausar sincronización → 2 horas
# Cerrar Calibre y cualquier otro visor de ebooks

Esto evita que la herramienta vuelva a crear archivos truncados mientras trabajamos.

2. Renombrar masivamente las extensiones .epu a .epub

El comando ren de Windows permite cambiar la extensión de todos los archivos en un árbol de directorios. Ejecuta el siguiente script en PowerShell (compatible con cmd):

# Cambiar a la raíz de OneDrive donde están los ebooks
cd "$env:USERPROFILE\OneDrive"

# Renombrar recursivamente .epu → .epub
Get-ChildItem -Recurse -Filter *.epu | Rename-Item -NewName {$_.Name -replace '\.epu$','.epub'}

Si prefieres la sintaxis clásica de cmd:

for /r %F in (*.epu) do ren "%F" *.epub

Este paso corrige la mayoría de los archivos sin tocar su contenido.

3. Normalizar nombres de archivo largos

En algunos casos los nombres siguen truncados (THEORY~1). Ejecuta una herramienta de des‑truncado que recrea los nombres largos a partir de la versión 8.3:

# Generar lista de archivos 8.3 y sus equivalentes largos
for /f "tokens=*" %A in ('dir /x /s *.epub ^| findstr /i ".epub"') do @echo %A

Revisa la salida y, si los nombres largos aparecen, simplemente copia los archivos a una nueva carpeta; Windows recreará los nombres completos automáticamente.

4. Restaurar versiones anteriores cuando el contenido está dañado

Si después del renombrado algunos archivos siguen sin abrirse, es probable que el contenido esté corrupto. OneDrive conserva versiones anteriores; restaurarlas en bloque es más rápido que hacerlo uno a uno.

  1. Abre la Web UI de OneDrive.
  2. Navega a la carpeta raíz que contiene los ebooks.
  3. Selecciona Restaurar OneDrive → elige una fecha antes del incidente (por ejemplo, “2 días atrás”).
  4. Confirma y espera a que OneDrive vuelva a sincronizar.

Este proceso restaura tanto los nombres como los datos originales, siempre que la versión anterior exista.

5. Re‑activar la sincronización y validar

Una vez completado el renombrado y, si es necesario, la restauración, vuelve a activar la sincronización:

# En la bandeja de OneDrive → Más → Reanudar sincronización

Abre varios archivos con Calibre para confirmar que el error desapareció.

Cuándo aplicar esta solución

  • Síntomas: errores “No plugin to handle input format: epu”, archivos con extensiones .epu o nombres 8.3, y la imposibilidad de abrir varios EPUB simultáneamente.
  • Entorno: Windows 11 con OneDrive sincronizando bibliotecas de ebooks; Calibre u otro visor de EPUB instalado.
  • No aplicar: si solo uno o dos archivos están afectados y la restauración masiva no es necesaria; en ese caso, restaurar individualmente desde el historial de versiones es más rápido.
  • Escenarios donde falla: si la base de datos de OneDrive está gravemente dañada (errores de sincronización permanentes) o si el disco está en modo solo lectura; en esos casos, una reinstalación de OneDrive o una copia de seguridad completa fuera de la nube será necesaria.

Código

# PowerShell: renombrar .epu → .epub recursivamente
cd "$env:USERPROFILE\OneDrive"
Get-ChildItem -Recurse -Filter *.epu | Rename-Item -NewName {$_.Name -replace '\.epu$','.epub'}

# Alternativa cmd.exe:
for /r %F in (*.epu) do ren "%F" *.epub

Verificación

  1. Comprobación de extensiones

    dir /s *.epu

    No debe devolver resultados.

  2. Apertura en Calibre

    • Selecciona 10 libros al azar.
    • Verifica que la vista previa se carga sin errores.

  3. Sincronización

    • En la barra de tareas, confirma que OneDrive muestra “Al día”.
    • Revisa el registro de OneDrive (%localappdata%\Microsoft\OneDrive\logs) en busca de errores persistentes.

Notas adicionales

  • Desactivar Files On‑Demand temporalmente puede evitar truncamientos cuando el disco está bajo presión, pero consume espacio local.
  • Mantener una copia de seguridad externa (por ejemplo, en un NAS) reduce la dependencia de la restauración de versiones de OneDrive.
  • Si la actualización de Windows fue la causa, considera desinstalarla temporalmente (Configuración → Windows Update → Ver historial de actualizaciones → Desinstalar actualización) y observar si el problema reaparece.
  • Para bibliotecas muy grandes, usa Robocopy con la opción /MIR para crear una réplica local y trabajar sobre ella sin interferir con la sincronización en la nube.

Con estos pasos, la mayoría de los fallos relacionados con extensiones .epu y archivos EPUB corruptos en OneDrive pueden resolverse de forma rápida y segura, manteniendo la integridad de la biblioteca digital y evitando interrupciones en el flujo de trabajo.