Sincroniza tu impresora con la biblioteca

Una sincronización te dice cuáles de los archivos de cada máquina conoce ya la biblioteca. Lo que no puede arreglar es el flujo de trabajo que puso archivos distintos en máquinas distintas para empezar: a partir de tres impresoras, una biblioteca central con cola de flota sustituye el bucle de copiar en cada máquina por un encolado único con enrutado. Esta guía cubre qué hace la sincronización y cómo funciona el emparejado.

El G-code que se acumula en una impresora se parece a una carpeta de descargas: archivos que subiste dos veces, archivos de un slicer que ya no usas y un benchy.gcode que podría ser de cualquiera de los últimos seis meses. Una biblioteca puede indexar esa lista y decirte cuáles de esos archivos reconoce, lo cual es de verdad útil. Lo que no hace es traerse los archivos de vuelta a la biblioteca.

Merece la pena ser preciso con esto, porque “sincronizar” da a entender una transferencia de archivos en los dos sentidos y esto no lo es. PrintStash lee la lista de archivos de la impresora, correlaciona cada entrada con una revisión que ya tiene y marca el resto como externa. Los bytes se quedan en la impresora.

Qué hace una sincronización

Cuando le pides a una impresora que sincronice, PrintStash obtiene su inventario remoto de G-code y luego, para cada nombre de archivo remoto, registra el tamaño, la fecha de modificación y la revisión de la biblioteca a la que pertenece, si consigue deducirlo. El resultado es una lista de archivos por impresora donde cada fila está enlazada a una revisión de tu biblioteca o etiquetada como externa.

El inventario funciona con Moonraker, PrusaLink y OctoPrint. Bambu LAN no expone inventario de archivos, así que ahí no hay nada que sincronizar, y la Elegoo Centauri tampoco expone ninguno, aunque las subidas en beta sí pueden dejar archivos en ella. En los proveedores que lo admiten también puedes borrar archivos remotos desde PrintStash, que es la forma práctica de vaciar una tarjeta SD llena sin abrir tres interfaces web.

Cómo se empareja un archivo remoto

El emparejado se hace en orden y gana el primer acierto.

El fiable es un marcador incrustado en el nombre del archivo. Cuando PrintStash sube una revisión, renombra el archivo en la impresora a algo como voron_panel__vault-f412-9c1f0ab3d5e2.gcode, donde el segmento final lleva el id del archivo y los doce primeros caracteres de su sha256. En la siguiente sincronización, el marcador se vuelve a leer y se verifica contra el hash almacenado antes de darlo por bueno, así que un archivo al que se le copió el nombre sobre otro contenido no empareja.

Si no hay marcador, PrintStash revisa su propio historial de subidas para esa impresora y ese nombre de archivo remoto. Después recurre a dos conjeturas: una coincidencia exacta del nombre base contra un archivo de G-code vivo en la biblioteca, y luego una coincidencia exacta de tamaño. Todo lo que sobra es externo.

Esas dos últimas son heurísticas y conviene tratarlas como tales. Dos laminados distintos exportados como benchy.gcode van a emparejarse con el subido más recientemente, y emparejar por tamaño es un detector de coincidencias, no un hash. Si te importa que la correlación sea exacta, sube desde la biblioteca para que el marcador esté ahí.

Cuando los archivos desaparecen de la impresora

Una sincronización también se da cuenta de lo que ya no está. Una fila que estaba enlazada a una revisión de la biblioteca se conserva y se marca como ausente en lugar de borrarse, porque el hecho de que una impresión conocida estuviera en esa máquina forma parte de su historia. Las filas externas sin emparejar no llevan ninguna historia que valga la pena guardar, así que se descartan directamente. La lista de archivos visible muestra solo lo que hay ahora mismo en la máquina.

Meter en la biblioteca un archivo suelto

No hay ningún botón que importe los bytes de un archivo desde una impresora, y esta es la carencia honesta del flujo de trabajo. Un archivo que solo existe en la tarjeta SD de la impresora tiene que volver por donde salió: lo descargas desde Mainsail, Fluidd u OctoPrint, y luego lo subes a la biblioteca y lo asocias a su modelo como revisión. Los registros de trabajos son otra cosa en las impresoras con Moonraker, cuyo historial de impresión sí se puede importar a un modelo emparejado; sincronizar una tarjeta SD con una biblioteca central cubre qué incluye esa importación y dónde se detiene.

Es lo bastante tedioso como para que la mejor respuesta suela ser dejar de generar archivos sueltos. Manda las impresiones desde la biblioteca en lugar de desde la subida directa del slicer, o deja que el hook de OrcaSlicer atrape las exportaciones al salir, y la tarjeta SD de la impresora pasa a ser una caché en lugar de un archivo histórico. Los archivos que merece la pena guardar ya están entonces en la biblioteca, con sus ajustes interpretados y sus resultados asociados.

Una pasada de limpieza que funciona

1. Sincroniza el inventario de la impresora.
2. Mira las filas externas. Esos son los archivos que la biblioteca no tiene.
3. Descarga los pocos que importan, súbelos como revisiones del modelo correcto y etiquétalos mientras todavía te acuerdas de qué eran.
4. Borra el resto de la impresora.
5. A partir de ahí, manda desde la biblioteca para que los archivos nuevos lleven el marcador y emparejen a la primera.

Hacer esto una vez por máquina lleva unos minutos y deja la siguiente sincronización legible, que es de lo que se trata.

Preguntas que suelen surgir

¿Sincronizar copia los archivos de la impresora a la biblioteca?

No. La sincronización lee la lista de archivos de la impresora y la correlaciona con las revisiones que ya tienes, registrando de cada archivo remoto el nombre, el tamaño, la fecha de modificación y la revisión a la que pertenece. Ningún byte se mueve de la impresora a la biblioteca. Meter en la biblioteca un archivo que solo está en la impresora implica descargarlo desde la propia interfaz de la impresora, por ejemplo Mainsail, Fluidd u OctoPrint, y subirlo como revisión. En la versión publicada no hay ninguna acción que importe los bytes de un archivo desde una impresora; la importación del historial de impresión en Moonraker trae registros de trabajos, no archivos.

¿Cómo sabe PrintStash a qué revisión de la biblioteca corresponde un archivo de la impresora?

De cuatro formas, en este orden de prioridad. Los archivos subidos desde la biblioteca llevan un marcador en su nombre remoto con el id de la revisión y un prefijo del hash, que se verifica contra el hash almacenado antes de darlo por bueno. Si eso falla, PrintStash revisa su historial de subidas para esa impresora y ese nombre de archivo. Después prueba una coincidencia exacta de nombre contra un archivo de G-code vivo, y por último una coincidencia exacta de tamaño. Todo lo que no encaje en ninguna de esas se lista como externo. El marcador es el único de los cuatro al que no puede engañar una casualidad, que es un motivo para subir desde la biblioteca en lugar de desde el slicer.

¿Qué impresoras admiten inventario de archivos?

Moonraker, PrusaLink y OctoPrint exponen una lista de archivos remota que PrintStash puede leer y limpiar. Las impresoras Bambu Lab en modo LAN aceptan subidas y un arranque opcional, pero no exponen inventario, así que PrintStash no puede decirte qué hay en la máquina. La Elegoo Centauri tampoco expone inventario, así que le aplica lo mismo, aunque las subidas en beta sí pueden mandarle archivos. La matriz de compatibilidad es la lista actual por proveedor.

¿Qué pasa con el registro cuando borro un archivo de la impresora?

Si ese archivo estaba enlazado a una revisión de la biblioteca, la entrada se conserva y se marca como ausente, así que la historia de que una revisión concreta vivió en esa máquina sobrevive a la limpieza. Si era un archivo externo sin emparejar, la fila se elimina, porque no hay nada que preservar. En cualquier caso, la lista de archivos actual solo muestra lo que hay en la impresora en este momento.

¿Conviene guardar archivos en la impresora?

Guarda lo que vas a imprimir esta semana y deja que la biblioteca sea el archivo histórico. El almacenamiento de una impresora es una caché sin metadatos, sin historial de versiones y sin copia de seguridad, y la primera señal de problemas suele ser una tarjeta SD llena en mitad de una impresión larga. La biblioteca guarda el laminado, sus ajustes interpretados, su resultado y su historial de impresión, y devolver un archivo a la máquina lleva segundos.

Fuentes

• La guía de impresoras de PrintStash y la matriz de compatibilidad para saber qué proveedores exponen un inventario remoto de archivos en la versión publicada.
• La API del gestor de archivos de Moonraker para el listado de archivos subyacente en las máquinas con Klipper. Consultada el 12 de agosto de 2026.

Para el lado del envío en el mismo bucle, conectar una impresora Klipper a través de Moonraker cubre las subidas y el control de trabajos, y gestionar una flota mixta cubre qué cambia cuando las máquinas no hablan todas el mismo protocolo.