--- title: "Descarregar Todas as Fotos e Vídeos" description: "Descarrega toda a tua biblioteca PixelUnion para o teu computador com o immich-archiver ou o Immich Go" url: "https://pixelunion.eu/pt/help/immich/download-photos-videos/" weight: 5 --- Podes descarregar toda a tua biblioteca de fotos e vídeos da PixelUnion para o teu próprio computador. É útil quando queres: - Manter uma cópia local dos teus ficheiros além da biblioteca PixelUnion - Descarregar os teus dados antes de eliminares a conta - Transferir a tua biblioteca para outro serviço - Ter uma cópia offline das tuas memórias Existem duas ferramentas para isto: - **immich-archiver** é desenvolvida e mantida pela PixelUnion. Usa-a para uma cópia simples de toda a tua biblioteca. É a que recomendamos. - **Immich Go** é uma ferramenta da comunidade com mais opções de filtragem, como descarregar apenas determinados álbuns, etiquetas ou um intervalo de datas. Está atualmente afetada por um bug, descrito mais abaixo. Ambas as ferramentas precisam de uma chave de API, por isso começa por aí. ## Passo 1: obtém a tua chave de API 1. Inicia sessão no teu domínio PixelUnion (por exemplo, `https://oteunome.pixelunion.eu`) 2. Clica no ícone do teu perfil no canto superior direito 3. Seleciona **Definições da conta** 4. Vai a **Chaves de API** 5. Clica em **Nova chave de API** 6. Dá-lhe um nome descritivo (por exemplo, "Ferramenta de descarga") 7. **Copia a chave de API gerada**, vais precisar dela no passo seguinte ⚠️ **Importante**: mantém a tua chave de API em segurança e não a partilhes com ninguém. Podes revogá-la mais tarde, se for preciso. ## immich-archiver (recomendada) O immich-archiver copia cada foto e vídeo da tua linha temporal para pastas por data no teu disco, e escreve ao lado de cada ficheiro um `.json` com todos os metadados que temos: data de captura, câmara, localização GPS, pertença a álbuns, rostos e classificações. No disco fica assim: ``` PixelUnion-Backup/2005/2005-06/IMG_0001.jpg PixelUnion-Backup/2005/2005-06/IMG_0001.jpg.json ``` Se a executares de novo mais tarde, só descarrega o que é novo, por isso manter a tua cópia atualizada é rápido. ### Passo 2: descarrega o immich-archiver 1. Vai à [página de versões do immich-archiver](https://github.com/pixelunioneu/immich-archiver/releases/latest) 2. Descarrega o ficheiro para o teu 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` (ou `linux_arm64` num Raspberry Pi ou semelhante) 3. Move o ficheiro descarregado para a pasta onde queres a tua cópia de segurança 4. Muda-lhe o nome para `immich-archiver` (no Windows, `immich-archiver.exe`). O nome descarregado inclui o número da versão, e mudá-lo mantém os comandos abaixo iguais quando atualizares mais tarde. As versões para macOS estão assinadas e notarizadas junto da Apple, por isso são executadas sem aviso de segurança. No macOS e Linux tens de tornar o ficheiro executável uma vez. Abre um terminal nessa pasta e executa: ``` chmod +x immich-archiver ``` ### Passo 3: executa-a Abre um terminal na pasta que contém o ficheiro: - **Windows**: clique direito na pasta → "Abrir no terminal" - **macOS**: abre a aplicação **Terminal**, escreve `cd ` seguido de um espaço, arrasta a pasta para a janela e prime Enter - **Linux**: abre um terminal e navega até à pasta Depois executa a ferramenta, substituindo os valores pelos teus: **Windows:** ``` .\immich-archiver.exe --url https://oteunome.pixelunion.eu --api-key A_TUA_CHAVE_API --dir .\PixelUnion-Backup ``` **macOS/Linux:** ``` ./immich-archiver --url https://oteunome.pixelunion.eu --api-key A_TUA_CHAVE_API --dir ./PixelUnion-Backup ``` Substitui `oteunome.pixelunion.eu` pelo teu domínio e `A_TUA_CHAVE_API` pela chave do passo 1. Para não escreveres a chave de cada vez, podes defini-las como variáveis de ambiente: `IMMICH_URL`, `IMMICH_API_KEY` e `IMMICH_DIR`. Com essas definidas, basta executar `immich-archiver` sozinho. ### Opções úteis | Opção | O que faz | |---|---| | `--dry-run` | Mostra o que seria descarregado sem guardar nada | | `--verbose` | Imprime uma linha por ficheiro em vez de um contador | | `--path-template "{year}/{month}/{day}"` | Muda a estrutura de pastas. Por predefinição é `{year}/{year}-{month}` | | `--include-shared` | Descarrega também os álbuns que outras pessoas partilham contigo, numa pasta separada `shared-with-me` | | `--concurrency 8` | Descarrega mais ficheiros ao mesmo tempo. Por predefinição são 4 | | `--retries 5` | Repete mais vezes as descargas falhadas. Por predefinição são 3 | Executa a ferramenta com `--help` para veres tudo o que suporta. ## Immich Go (para filtragem avançada) O Immich Go é uma ferramenta de linha de comandos criada pela comunidade. Oferece filtros que o immich-archiver ainda não tem, como limitar a descarga a determinados álbuns, etiquetas ou a um intervalo de datas.

Bug conhecido no immich-go: nomes de ficheiro incorretos

Há um bug conhecido no immich-go que afeta o comando archive from-immich. Os ficheiros exportados podem receber nomes numéricos incorretos (como -1, -2) sem extensão de ficheiro, e os metadados dos álbuns podem estar ausentes na exportação. Uma correção está em andamento. Podes acompanhar o progresso no GitHub (PR #1272). Recomendamos usar o immich-archiver descrito acima, ou aguardar uma versão atualizada do immich-go antes de usar este comando.

### Descarregar o Immich Go 1. Vai à [página de versões do Immich Go](https://github.com/simulot/immich-go/releases/latest) 2. Descarrega a versão para o teu sistema operativo: - **Windows**: descarrega o ficheiro `.exe` - **macOS**: descarrega o ficheiro com `darwin` no nome - **Linux**: descarrega o ficheiro com `linux` no nome 3. Extrai o ficheiro `.zip` descarregado 4. Coloca o executável `immich-go` numa pasta onde queiras descarregar as tuas fotos ### Executa o comando de descarga **Windows:** ``` ./immich-go.exe archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup ``` **macOS/Linux:** ``` ./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup ``` Substitui: - `oteunome.pixelunion.eu` pelo teu domínio PixelUnion real - `A_TUA_CHAVE_API` pela chave de API que copiaste no passo 1 - `./PixelUnion-Backup` pelo caminho onde queres guardar as tuas fotos **Nota**: a opção `--write-to-folder` é obrigatória. ### Opções de filtragem do Immich Go #### Descarregar apenas fotos (ignorar vídeos) ``` ./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-include-type=IMAGE ``` #### Descarregar apenas vídeos (ignorar fotos) ``` ./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-include-type=VIDEO ``` #### Descarregar apenas fotos favoritas ``` ./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-favorite ``` #### Descarregar fotos de álbuns específicos ``` ./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-albums="Nome do álbum 1" --from-albums="Nome do álbum 2" ``` #### Descarregar fotos com etiquetas específicas ``` ./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-tags="tag1" --from-tags="tag2" ``` #### Descarregar fotos de um intervalo de datas ``` ./immich-go archive from-immich --from-server=https://oteunome.pixelunion.eu/ --from-api-key=A_TUA_CHAVE_API --write-to-folder=./PixelUnion-Backup --from-date-range="2024-01-01:2024-12-31" ``` ## Resolução de problemas ### Problemas de ligação - Confirma que o teu domínio PixelUnion está correto e inclui `https://` - Verifica que a tua chave de API está correta e não foi revogada - Verifica a tua ligação à internet ### "Permission denied" no macOS ou Linux - Tens de tornar o ficheiro executável primeiro: `chmod +x immich-archiver` ### Descarga interrompida - Ambas as ferramentas continuam de onde pararam se voltares a executar o comando - Ficheiros já descarregados não são obtidos uma segunda vez ### Bibliotecas grandes - Em bibliotecas muito grandes (milhares de ficheiros), a descarga pode demorar várias horas - Certifica-te de que o computador não entra em suspensão durante a descarga - Considera deixar a descarga a correr durante a noite ## Depois da descarga Quando a descarga terminar: - As tuas fotos e vídeos estão na pasta que indicaste - Os ficheiros mantêm os nomes e datas originais - Podes guardar estes ficheiros noutro lado ou transferi-los Vale a pena verificares a tua cópia antes de confiares nela. Abre a pasta e confirma que algumas fotos abrem mesmo. ## Precisas de ajuda? Se tiveres problemas: - Para o immich-archiver, consulta a [página do projeto no GitHub](https://github.com/pixelunioneu/immich-archiver) - Para o Immich Go, consulta a [documentação do Immich Go](https://github.com/simulot/immich-go) - [Contacta a nossa equipa de apoio](/support/) para obteres ajuda