--- title: "Descargar Todas las Fotos y Vídeos" description: "Descarga toda tu biblioteca de PixelUnion a tu ordenador con immich-archiver o Immich Go" url: "https://pixelunion.eu/es/help/immich/download-photos-videos/" weight: 5 --- Puedes descargar toda tu biblioteca de fotos y vídeos de PixelUnion a tu propio ordenador. Resulta útil cuando quieres: - Conservar una copia local de tus medios junto a tu biblioteca de PixelUnion - Descargar tus datos antes de eliminar tu cuenta - Trasladar tu biblioteca a otro servicio - Tener una copia sin conexión de tus recuerdos Hay dos herramientas para esto: - **immich-archiver** está desarrollada y mantenida por PixelUnion. Úsala para una copia sencilla de toda tu biblioteca. Es la que recomendamos. - **Immich Go** es una herramienta de la comunidad con más opciones de filtrado, como descargar solo determinados álbumes, etiquetas o un rango de fechas. Actualmente le afecta un error, descrito más abajo. Ambas herramientas necesitan una clave de API, así que empieza por ahí. ## Paso 1: obtén tu clave de API 1. Inicia sesión en tu dominio de PixelUnion (por ejemplo, `https://tunombre.pixelunion.eu`) 2. Haz clic en el icono de tu perfil en la esquina superior derecha 3. Selecciona **Ajustes de cuenta** 4. Ve a **Claves de API** 5. Haz clic en **Nueva clave de API** 6. Dale un nombre descriptivo (por ejemplo, "Herramienta de descarga") 7. **Copia la clave de API generada**, la necesitarás en el siguiente paso ⚠️ **Importante**: mantén tu clave de API a salvo y no la compartas con nadie. Puedes revocarla más adelante si es necesario. ## immich-archiver (recomendada) immich-archiver copia cada foto y vídeo de tu línea de tiempo en carpetas por fecha en tu disco, y escribe junto a cada archivo un `.json` con todos los metadatos que tenemos: fecha de captura, cámara, ubicación GPS, pertenencia a álbumes, caras y valoraciones. En tu disco queda así: ``` PixelUnion-Backup/2005/2005-06/IMG_0001.jpg PixelUnion-Backup/2005/2005-06/IMG_0001.jpg.json ``` Si la ejecutas de nuevo más adelante, solo descarga lo nuevo, así que mantener tu copia al día es rápido. ### Paso 2: descarga immich-archiver 1. Ve a la [página de versiones de immich-archiver](https://github.com/pixelunioneu/immich-archiver/releases/latest) 2. Descarga el archivo para tu sistema: - **Windows**: `immich-archiver_..._windows_amd64.exe` - **macOS (Apple Silicon)**: `immich-archiver_..._darwin_arm64` - **macOS (Intel)**: `immich-archiver_..._darwin_amd64` - **Linux**: `immich-archiver_..._linux_amd64` (o `linux_arm64` en una Raspberry Pi o similar) 3. Mueve el archivo descargado a la carpeta donde quieras tu copia de seguridad 4. Renómbralo a `immich-archiver` (en Windows, `immich-archiver.exe`). El nombre descargado incluye el número de versión, y renombrarlo mantiene iguales los comandos de abajo cuando actualices más adelante. Las versiones de macOS están firmadas y notarizadas con Apple, así que se ejecutan sin aviso de seguridad. En macOS y Linux tienes que hacer el archivo ejecutable una vez. Abre un terminal en esa carpeta y ejecuta: ``` chmod +x immich-archiver ``` ### Paso 3: ejecútala Abre un terminal en la carpeta que contiene el archivo: - **Windows**: clic derecho en la carpeta → "Abrir en el terminal" - **macOS**: abre la app **Terminal**, escribe `cd ` seguido de un espacio, arrastra la carpeta a la ventana y pulsa Intro - **Linux**: abre un terminal y sitúate en la carpeta Después ejecuta la herramienta, sustituyendo los valores por los tuyos: **Windows:** ``` .\immich-archiver.exe --url https://tunombre.pixelunion.eu --api-key TU_CLAVE_API --dir .\PixelUnion-Backup ``` **macOS/Linux:** ``` ./immich-archiver --url https://tunombre.pixelunion.eu --api-key TU_CLAVE_API --dir ./PixelUnion-Backup ``` Sustituye `tunombre.pixelunion.eu` por tu propio dominio y `TU_CLAVE_API` por la clave del paso 1. Para no escribir la clave cada vez, puedes definirlas como variables de entorno: `IMMICH_URL`, `IMMICH_API_KEY` e `IMMICH_DIR`. Con esas definidas, basta con ejecutar `immich-archiver` a secas. ### Opciones útiles | Opción | Qué hace | |---|---| | `--dry-run` | Muestra qué se descargaría sin guardar nada | | `--verbose` | Imprime una línea por archivo en lugar de un contador | | `--path-template "{year}/{month}/{day}"` | Cambia la estructura de carpetas. Por defecto es `{year}/{year}-{month}` | | `--include-shared` | Descarga también los álbumes que otros comparten contigo, en una carpeta aparte `shared-with-me` | | `--concurrency 8` | Descarga más archivos a la vez. Por defecto son 4 | | `--retries 5` | Reintenta las descargas fallidas más veces. Por defecto son 3 | Ejecuta la herramienta con `--help` para ver todo lo que admite. ## Immich Go (para filtrado avanzado) Immich Go es una herramienta de línea de comandos creada por la comunidad. Ofrece filtros que immich-archiver todavía no tiene, como limitar la descarga a álbumes, etiquetas o un rango de fechas concretos.

Error conocido en immich-go: nombres de archivo incorrectos

Hay un error conocido en immich-go que afecta al comando archive from-immich. Los archivos exportados pueden recibir nombres numéricos incorrectos (como -1, -2) sin extensión de archivo, y los metadatos de los álbumes pueden faltar en la exportación. Se está trabajando en una solución. Puedes seguir el progreso en GitHub (PR #1272). Recomendamos usar immich-archiver, descrita más arriba, o esperar a una versión actualizada de immich-go antes de usar este comando.

### Descargar Immich Go 1. Ve a la [página de versiones de Immich Go](https://github.com/simulot/immich-go/releases/latest) 2. Descarga la versión para tu sistema operativo: - **Windows**: descarga el archivo `.exe` - **macOS**: descarga el archivo con `darwin` en el nombre - **Linux**: descarga el archivo con `linux` en el nombre 3. Extrae el archivo `.zip` descargado 4. Coloca el ejecutable `immich-go` en una carpeta donde quieras descargar tus fotos ### Ejecuta el comando de descarga **Windows:** ``` ./immich-go.exe archive from-immich --from-server=https://tunombre.pixelunion.eu/ --from-api-key=TU_CLAVE_API --write-to-folder=./PixelUnion-Backup ``` **macOS/Linux:** ``` ./immich-go archive from-immich --from-server=https://tunombre.pixelunion.eu/ --from-api-key=TU_CLAVE_API --write-to-folder=./PixelUnion-Backup ``` Sustituye: - `tunombre.pixelunion.eu` por tu dominio real de PixelUnion - `TU_CLAVE_API` por la clave de API que copiaste en el paso 1 - `./PixelUnion-Backup` por la ruta donde quieras guardar tus fotos **Nota**: la opción `--write-to-folder` es obligatoria. ### Opciones de filtrado de Immich Go #### Descargar solo fotos (omitir vídeos) ``` ./immich-go archive from-immich --from-server=https://tunombre.pixelunion.eu/ --from-api-key=TU_CLAVE_API --write-to-folder=./PixelUnion-Backup --from-include-type=IMAGE ``` #### Descargar solo vídeos (omitir fotos) ``` ./immich-go archive from-immich --from-server=https://tunombre.pixelunion.eu/ --from-api-key=TU_CLAVE_API --write-to-folder=./PixelUnion-Backup --from-include-type=VIDEO ``` #### Descargar solo fotos favoritas ``` ./immich-go archive from-immich --from-server=https://tunombre.pixelunion.eu/ --from-api-key=TU_CLAVE_API --write-to-folder=./PixelUnion-Backup --from-favorite ``` #### Descargar fotos de álbumes concretos ``` ./immich-go archive from-immich --from-server=https://tunombre.pixelunion.eu/ --from-api-key=TU_CLAVE_API --write-to-folder=./PixelUnion-Backup --from-albums="Nombre de álbum 1" --from-albums="Nombre de álbum 2" ``` #### Descargar fotos con etiquetas concretas ``` ./immich-go archive from-immich --from-server=https://tunombre.pixelunion.eu/ --from-api-key=TU_CLAVE_API --write-to-folder=./PixelUnion-Backup --from-tags="tag1" --from-tags="tag2" ``` #### Descargar fotos de un rango de fechas ``` ./immich-go archive from-immich --from-server=https://tunombre.pixelunion.eu/ --from-api-key=TU_CLAVE_API --write-to-folder=./PixelUnion-Backup --from-date-range="2024-01-01:2024-12-31" ``` ## Resolución de problemas ### Problemas de conexión - Comprueba que tu dominio de PixelUnion es correcto e incluye `https://` - Verifica que tu clave de API es correcta y no ha sido revocada - Comprueba tu conexión a internet ### "Permission denied" en macOS o Linux - Primero tienes que hacer el archivo ejecutable: `chmod +x immich-archiver` ### Descarga interrumpida - Ambas herramientas continúan donde se quedaron si vuelves a ejecutar el comando - Los archivos ya descargados no se vuelven a bajar ### Bibliotecas grandes - En bibliotecas muy grandes (miles de archivos), la descarga puede tardar varias horas - Asegúrate de que tu ordenador no entre en suspensión durante la descarga - Considera dejar la descarga en marcha durante la noche ## Después de la descarga Cuando la descarga termine: - Tus fotos y vídeos estarán en la carpeta que indicaste - Los archivos conservan sus nombres y fechas originales - Puedes respaldar estos archivos en otro sitio o transferirlos Conviene comprobar tu copia antes de confiar en ella. Abre la carpeta y confirma que algunas fotos se abren de verdad. ## ¿Necesitas ayuda? Si tienes problemas: - Para immich-archiver, consulta la [página del proyecto en GitHub](https://github.com/pixelunioneu/immich-archiver) - Para Immich Go, consulta la [documentación de Immich Go](https://github.com/simulot/immich-go) - [Contacta con nuestro equipo de soporte](/support/) para obtener ayuda