---
title: "immich-folder-album-creator"
description: "immich-folder-album-creator, uma poderosa ferramenta de linha de comando que conecta suas pastas locais aos álbuns do Immich"
url: "https://pixelunion.eu/pt/blog/immich-folder-album-creator/"
date: "2025-06-17"
author: "Team PixelUnion"
categories: ["Guia do usuário","Ferramentas"]
tags: ["Ferramentas","immich","immich-folder-album-creator","Gerenciamento de fotos"]
---


# Organize suas fotos facilmente com o immich-folder-album-creator

Se você é como a maioria das pessoas, sua coleção de fotos é uma mistura de pastas, álbuns e imagens espalhadas por vários dispositivos. O PixelUnion, baseado na plataforma open source [Immich](https://github.com/immich-app/immich), facilita o gerenciamento privado e eficiente das suas fotos. Mas e se você quiser que sua estrutura de pastas seja refletida automaticamente em álbuns no PixelUnion?

É aí que entra o [immich-folder-album-creator](https://github.com/Salvoxia/immich-folder-album-creator), uma poderosa ferramenta de linha de comando que conecta suas pastas locais aos álbuns do Immich.

## O que é o immich-folder-album-creator?

Criado por [@Salvoxia](https://github.com/Salvoxia), o immich-folder-album-creator é uma ferramenta leve que cria automaticamente álbuns na sua instância do PixelUnion para corresponder à estrutura das suas pastas de fotos. Chega de criar álbuns manualmente – esta ferramenta faz o trabalho pesado para você.

## Principais recursos

- **Criação automática de álbuns:** Analisa suas pastas de fotos locais e cria álbuns correspondentes no PixelUnion.
- **Mapeamento de pastas para álbuns:** Mantém sua hierarquia de pastas, tornando a navegação no PixelUnion intuitiva e familiar.
- **Processamento em lote:** Gerencia grandes coleções de forma eficiente, ideal para quem está migrando bibliotecas extensas.
- **Opções personalizáveis:** Suporta várias configurações para diferentes fluxos de trabalho e preferências.

## Como funciona?

1. **Prepare suas fotos:** Organize suas fotos em pastas locais como você gostaria que aparecessem no PixelUnion.
2. **Envie para o PixelUnion:** Use as ferramentas oficiais de importação ou sincronização do Immich para enviar suas fotos.
3. **Execute o immich-folder-album-creator:** Aponte a ferramenta para a pasta raiz das suas fotos e forneça as credenciais do seu servidor PixelUnion. A ferramenta analisará suas pastas e criará os álbuns correspondentes.
4. **Aproveite a organização:** Abra o PixelUnion e veja seus álbuns organizados e prontos para serem explorados.

## Como começar

1. **Instale a ferramenta:**  
   Baixe ou clone do [GitHub](https://github.com/Salvoxia/immich-folder-album-creator) e siga as instruções de instalação no README.

2. **Configure e execute:**  
   A ferramenta pode ser executada pelo terminal com argumentos simples. Por exemplo:
   ```sh
   python3 ./immich_auto_album.py \
    /path/to/external/lib \
    https://<seu-usuario>.pixelunion.eu/api \
    EstaÉMinhaApiKeyCopiadaDoImmichWebGui
   ```
   (Veja o repositório para todas as opções e detalhes.)

3. **Relaxe:**  
   Deixe a ferramenta organizar seus álbuns enquanto você aproveita suas fotos.

## Por que usar o immich-folder-album-creator?

Para quem está migrando para o PixelUnion ou deseja manter uma biblioteca de fotos digital bem organizada, esta ferramenta é indispensável. Economiza tempo, reduz o esforço manual e garante que seus álbuns no PixelUnion reflitam sua estrutura de pastas.

Seja você fotógrafo, arquivista digital ou apenas um entusiasta de fotos, experimente o immich-folder-album-creator e otimize sua organização de fotos hoje mesmo.

---

Experimente e participe da conversa no [GitHub](https://github.com/Salvoxia/immich-folder-album-creator/issues) para enviar feedback ou contribuir!

*Boa organização!*

Imagem de capa por [Lucas Favre](https://unsplash.com/photos/silver-macbook-beside-battery-charger-4x-67z_TaGo)