--- title: "Migrar do iCloud Photos" description: "Exporte do iCloud Fotos e importe a sua biblioteca no PixelUnion, com Immich Go como opção para datas e álbuns" url: "https://pixelunion.eu/pt/help/migrating/migrate-icloud/" weight: 4 --- ![PixelUnion](/images/launch-pixelunion.png) ### Transfira todas as suas fotos e vídeos do iCloud Photos para o PixelUnion Quer migrar do iCloud Photos para o PixelUnion? Boa notícia: é muito fácil levar todo o seu ficheiro de fotos e vídeos. Nesta página, explicamos passo a passo como exportar toda a sua mídia do iCloud Photos e importar no PixelUnion. Existem duas maneiras de fazer isso: - **[Método 1, Rápido e fácil](#metodo-1-importacao-simples)**: Este método é mais fácil, mas há o risco de que algumas datas e estruturas de álbuns não sejam transferidas corretamente. - **[Método 2, Um pouco mais técnico, mas mais preciso](#metodo-2-importacao-com-datas-e-albuns-recomendado)**: Este método exige alguns passos a mais, mas mantém datas e álbuns. Explicamos exatamente como funciona. --- ## Método 1: importação simples ### Passo 1: exporte suas fotos do iCloud Photos 1. Acesse **[iCloud.com](https://www.icloud.com/)** e faça login com seu ID da Apple. 2. Clique em **Fotos**. 3. Selecione as fotos e vídeos que deseja exportar: - Para selecionar todas as fotos: Pressione `Ctrl+A` (Windows) ou `Cmd+A` (Mac), ou clique no botão **Selecionar** e escolha **Selecionar tudo**. - Para selecionar fotos específicas: Clique em fotos individuais enquanto mantém `Ctrl` (Windows) ou `Cmd` (Mac) pressionado. 4. Clique no botão **Transferir** (ícone de nuvem com seta para baixo). 5. Aguarde o download ser concluído. Suas fotos serão baixadas como um ficheiro `.zip`. 🔔 **Atenção: Se você tem uma biblioteca de fotos grande, pode ser necessário transferir em lotes menores. A exportação pode demorar, dependendo da quantidade de fotos.** ### Passo 2: prepare suas fotos para o PixelUnion - Extraia o ficheiro ou ficheiros `.zip` baixados no seu computador. - Suas fotos estarão na pasta extraída, normalmente organizadas por data ou álbum. ### Passo 3: envie para o PixelUnion - Acesse seu **domínio PixelUnion** no navegador. Seu domínio é o endereço do servidor, sempre terminando em `.pixelunion.eu`. - Faça login e clique em **Enviar**. - Selecione as fotos ou pastas desejadas. --- ## Método 2: importação com datas e álbuns (recomendado) Este método usa o **Immich Go** para enviar sua exportação do iCloud mantendo metadados como nomes de álbuns e datas das fotos. **Immich Go** é uma ferramenta que permite importar facilmente fotos e vídeos do iCloud para o PixelUnion, mantendo metadados importantes como datas originais e nomes de álbuns. Assim, suas fotos permanecem organizadas e suas memórias aparecem no lugar e ordem corretos no PixelUnion. Veja como usar a ferramenta: ### Passo 1: exporte suas fotos do iCloud Photos 1. Acesse **[iCloud.com](https://www.icloud.com/)** e faça login com seu ID da Apple. 2. Clique em **Fotos**. 3. Selecione as fotos e vídeos que deseja exportar: - Para selecionar todas as fotos: Pressione `Ctrl+A` (Windows) ou `Cmd+A` (Mac), ou clique no botão **Selecionar** e escolha **Selecionar tudo**. - Para selecionar fotos específicas: Clique em fotos individuais enquanto mantém `Ctrl` (Windows) ou `Cmd` (Mac) pressionado. 4. Clique no botão **Transferir** (ícone de nuvem com seta para baixo). 5. Aguarde o download ser concluído. Suas fotos serão baixadas como um ficheiro `.zip`. 6. Extraia o ficheiro ou ficheiros baixados no seu computador. Não precisa organizá-los mais: o Immich Go cuidará da estrutura. 🔔 **Atenção: Para bibliotecas muito grandes, pode ser necessário exportar em vários lotes. O Immich Go pode processar as pastas extraídas diretamente.** ### Passo 2: baixe e prepare o Immich Go O Immich Go não é um programa com instalador tradicional. É um ficheiro que você coloca no computador e pode usar diretamente, sem instalação. Nesta etapa, vamos prepará-lo. 1. Acesse a **[página de lançamentos do Immich Go](https://github.com/simulot/immich-go/releases/latest)**. 2. Baixe a versão adequada para seu sistema operacional (Windows, Mac ou Linux). Escolha o ficheiro correspondente ao seu computador: - Para **Windows**, escolha o ficheiro `.exe` - Para **Mac**, o ficheiro com `darwin` no nome - Para **Linux**, o ficheiro com `linux` no nome 3. Extraia o ficheiro `.zip`. 4. Coloque o ficheiro `immich-go` (ou `immich-go.exe` no Windows) em uma nova pasta. 5. Adicione suas pastas de exportação do iCloud extraídas nessa mesma pasta, ou anote o caminho para onde você as extraiu. ### Passo 3: conecte seu domínio e chave de API 1. Acesse seu **domínio PixelUnion**. 2. Clique no seu perfil no canto superior direito e escolha **Configurações da conta**. 3. Vá até **Chave de API**. 4. Clique em **Nova chave de API**, dê um nome e copie a chave gerada. ### Passo 4: execute um comando no terminal 1. Abra um terminal na pasta onde está o immich-go. - **Windows**: clique com o botão direito na pasta → "Abrir no terminal" - **macOS:** Abra o app **Terminal** (procure no Spotlight ou em Aplicações > Utilitários). Digite `cd ` seguido de um espaço, arraste a pasta com o `immich-go` para a janela do terminal e pressione Enter. 2. Cole o comando abaixo no terminal, substituindo o servidor, a chave de API e o caminho da pasta pelos seus próprios valores: - **Windows** (se sua exportação do iCloud está na mesma pasta): ``` ./immich-go.exe --server=https://.pixelunion.eu/ --api-key=APIKEY --pause-immich-jobs=false --manage-heic-jpeg=StackCoverJPG upload from-icloud . ``` - **Windows** (se sua exportação do iCloud está em uma pasta diferente): ``` ./immich-go.exe --server=https://.pixelunion.eu/ --api-key=APIKEY --pause-immich-jobs=false --manage-heic-jpeg=StackCoverJPG upload from-icloud "C:\path\to\your\icloud\export" ``` - **macOS** (se sua exportação do iCloud está na mesma pasta): ``` ./immich-go --server=https://.pixelunion.eu/ --api-key=APIKEY --pause-immich-jobs=false --manage-heic-jpeg=StackCoverJPG upload from-icloud . ``` - **macOS** (se sua exportação do iCloud está em uma pasta diferente): ``` ./immich-go --server=https://.pixelunion.eu/ --api-key=APIKEY --pause-immich-jobs=false --manage-heic-jpeg=StackCoverJPG upload from-icloud "/path/to/your/icloud/export" ``` 3. A ferramenta enviará automaticamente todas as suas fotos, com álbuns e datas, para o PixelUnion. **Opcional: Incluir iCloud Memories como álbuns** Se você quiser importar iCloud Memories como álbuns no PixelUnion, adicione a flag `--memories` ao seu comando: - **Windows**: ``` ./immich-go.exe --server=https://.pixelunion.eu/ --api-key=APIKEY --pause-immich-jobs=false --manage-heic-jpeg=StackCoverJPG --memories upload from-icloud . ``` - **macOS**: ``` ./immich-go --server=https://.pixelunion.eu/ --api-key=APIKEY --pause-immich-jobs=false --manage-heic-jpeg=StackCoverJPG --memories upload from-icloud . ``` --- ## Precisa de ajuda? Se encontrar problemas, isto muitas vezes resolve a situação: - **Trabalhe em lotes mais pequenos** Para bibliotecas do iCloud muito grandes, exporte e envie em lotes menores. Por exemplo, exporte fotos de um ano de cada vez, ou selecione álbuns específicos para exportar. - **Verifique se tudo está no local correto** Certifique-se de que o `immich-go` (ou `immich-go.exe`) está numa pasta a que pode aceder, e que o seu terminal também está aberto **nessa pasta**. Se a sua exportação do iCloud está noutro local, use o caminho completo no comando. - **Verifique bem o seu comando** Atenção: - O URL do seu servidor é o seu domínio PixelUnion e termina em `.pixelunion.eu` - Use `--server=https://.pixelunion.eu` (sem espaços extra/erros de digitação) - Use a `--api-key` correta (copiada de Account settings → API Key) e certifique-se também de que não há espaço entre = e a API Key. - A opção `--manage-heic-jpeg=StackCoverJPG` ajuda a organizar as versões HEIC e JPEG da mesma foto - **Use o ficheiro correto no Windows** No Windows usa geralmente `./immich-go.exe` (não `./immich-go`). - **Manipulação de ficheiros HEIC** O iCloud Photos geralmente armazena fotos no formato HEIC. A opção `--manage-heic-jpeg=StackCoverJPG` garante que, se você tiver versões HEIC e JPEG da mesma foto, elas sejam organizadas corretamente (empilhadas juntas com o JPEG como imagem de capa). Se ainda encontrar problemas durante o processo de migração, estamos aqui para si! Ao contactar a nossa equipa de suporte, inclua o seguinte: 1. **Uma captura de ecrã** da mensagem de erro ou do problema que encontrar 2. **Os registos do immich-go** - O Immich Go cria automaticamente um ficheiro de registo no início de cada execução na mesma pasta onde executou o comando. O ficheiro de registo tem o nome `immich-go YYYY-MM-DD HH-MM-SS.log` (por exemplo `immich-go 2024-01-15 14-30-45.log`). Procure ficheiros com este padrão de nome nessa pasta. Se não conseguir encontrar um ficheiro de registo, também pode copiar a saída da janela do terminal onde executou o comando immich-go. 3. **Comando** que introduz no terminal (substitua a sua API Key por segurança.) Pode contactar a nossa equipa de suporte através da página [Contacte-nos](/pt/support/). Entraremos em contacto consigo o mais rapidamente possível para resolver quaisquer problemas.