---
title: "ImmichFrame vs Immich Kiosk: que moldura de fotos se adapta à tua configuração?"
description: "O ImmichFrame e o Immich Kiosk transformam a tua biblioteca Immich numa moldura digital. Por dentro, fazem escolhas muito diferentes. Eis como se comparam em arquitetura, clientes, configuração e segurança."
url: "https://pixelunion.eu/pt/blog/immichframe-vs-immich-kiosk/"
date: "2026-10-03"
author: "Marc"
categories: ["Community"]
tags: ["Immich","ImmichFrame","Immich Kiosk","Código aberto","Alojamento próprio"]
---


No ano passado escrevemos sobre o [Immich Kiosk](/pt/blog/immich-kiosk/) e o [ImmichFrame](/pt/blog/immichframe/). Desde então, ambos os projetos lançaram muitas versões. A pergunta que recebemos dos utilizadores mudou com eles. Antes era «dá para fazer isto?». Agora é «qual devo escolher?».

À superfície, fazem o mesmo. Ambos se ligam ao teu servidor Immich com uma chave API e mostram as tuas fotos em ecrã inteiro num ecrã algures em casa. Ambos são projetos da comunidade, sem ligação ao Immich. Ambos funcionam com uma conta PixelUnion da mesma forma que com um servidor alojado por ti: aponta-os para `https://<username>.pixelunion.eu` e dá-lhes uma chave API.

As listas de funcionalidades sobrepõem-se quase por completo, por isso vou deixá-las em grande parte de lado. O que distingue estes dois é a arquitetura. Este artigo aborda as versões atuais: [ImmichFrame v1.0.38](https://github.com/immichFrame/ImmichFrame/releases) (14 de setembro de 2026) e [Immich Kiosk v0.44.1](https://github.com/damongolding/immich-kiosk/releases) (25 de setembro de 2026).

## Duas ideias diferentes do que é uma moldura de fotos

### Immich Kiosk: um servidor, configurado pelo URL

O Immich Kiosk, criado por Damon Golding, é um único binário Go. Usa Echo para HTTP e templ para templates do lado do servidor, e serve uma página web na porta 3000. É esse o produto todo. O ecrã é qualquer browser: um Raspberry Pi com Chromium em modo quiosque, um tablet antigo com Fully Kiosk Browser, uma smart TV, um recetor Google Cast.

A escolha de design que importa: quase todas as definições em `config.yaml` podem ser substituídas por um parâmetro de consulta no URL. Um único contentor Kiosk pode controlar todos os ecrãs da tua casa, cada um com o seu próprio comportamento:

```
http://kiosk.local:3000/?album=ALBUM_ID&layout=splitview&transition=cross-fade
http://kiosk.local:3000/?person=PERSON_ID&show_time=true&image_fit=cover
```

O tablet da cozinha mostra o álbum de família com um relógio. O ecrã do corredor mostra as fotos de uma pessoa na vertical. Mesmo servidor, mesmo ficheiro de configuração, URLs diferentes. O reverso da medalha é que qualquer pessoa na tua rede que consiga aceder à página pode mudar o que ela mostra. Se isso te incomoda, `disable_url_queries` desativa-o.

### ImmichFrame: um servidor mais aplicações nativas

O ImmichFrame vai pelo caminho oposto. O servidor é feito em C# sobre ASP.NET Core com um frontend em SvelteKit, distribuído como `ghcr.io/immichframe/immichframe` na porta 8080. Por cima disso, o projeto mantém clientes nativos:

- **Android**, através da Play Store ou de um APK instalado manualmente, incluindo um serviço de proteção de ecrã para Android TV
- **Apple TV**, **iPhone e iPad** (iOS 17+) e Macs com Apple Silicon através da App Store
- Aplicações de **desktop** para Windows, macOS e Linux
- Molduras **Frameo**, aquelas molduras Android baratas que se encontram por cerca de 40 $, instaladas através de ADB (Android Debug Bridge)

As aplicações nativas são a razão pela qual o ImmichFrame é como é. A Apple não permite WebViews (componentes de browser incorporados) no tvOS, por isso a aplicação Apple TV reconstrói a apresentação com controlos nativos. No Android TV, o ImmichFrame pode substituir a proteção de ecrã do sistema, algo que um separador do browser não consegue fazer. A aplicação Android também corre um pequeno servidor HTTP na porta 53287 que aceita `next`, `previous`, `pause`, `dim`, `undim` e `brightness?value=0.5`. É este último que ligas ao Home Assistant para escurecer a moldura quando as luzes se apagam.

A contrapartida está na configuração. Vive ao nível da instância. Pelo que consigo perceber da documentação, não existe equivalente às substituições por URL do Kiosk, por isso dois ecrãs com álbuns diferentes significam normalmente dois contentores ou duas contas. Barato de manter a correr. Mais para manter.

## Os detalhes que importam aos utilizadores avançados

### Configuração e estado

O Kiosk é configuração como código. Um ficheiro YAML com um esquema JSON publicado para preenchimento automático no teu editor, variáveis de ambiente para os segredos e `watch_config` para recarregar quando há alterações. Vive num repositório Git ao lado do resto dos teus ficheiros compose.

O ImmichFrame foi recentemente no sentido contrário. Agora inclui uma interface de administração em `/admin` onde todas as definições, incluindo as contas Immich, são editadas no browser e aplicadas de imediato. As definições ficam guardadas numa base de dados SQLite (`immichframe.db`) em `/app/Config`. Um `Settings.yml` é importado uma única vez, no primeiro arranque. Depois disso, a base de dados é a fonte de verdade e as alterações ao ficheiro são ignoradas.

Este último ponto vai apanhar muita gente de surpresa. Se geres o teu homelab de forma declarativa, a configuração do ImmichFrame passa a ser um estado de que tens de fazer cópia de segurança, e não um ficheiro que podes comparar com um diff. Se preferes clicar a editar YAML, é uma melhoria. Nenhuma das abordagens está errada. Foram feitas para pessoas diferentes.

### Seleção de conteúdo

Ambos cobrem o essencial: álbuns, álbuns excluídos, pessoas, etiquetas, classificações, memórias, favoritos, intervalos de datas e vídeo (ainda experimental no ImmichFrame). As diferenças estão nos extremos.

O ImmichFrame foi construído em torno de **várias contas**. Cada entrada em `Accounts` tem o seu próprio URL de servidor, chave API e filtros. Junta a tua biblioteca com a do teu parceiro, ou vai buscar fotos a dois servidores Immich separados, e a moldura mistura-os numa única apresentação.

O Kiosk vai mais fundo na filtragem dentro de uma biblioteca. `require_all_people` só mostra fotos onde todas as pessoas indicadas aparecem juntas, exatamente o que queres para uma moldura de «avós com netos». Há `excluded_people`, `excluded_partners`, `filter_exclude_faces` para um ecrã só com paisagens, e `filter_newest` para limitar uma fonte aos seus elementos mais recentes. Com `asset_weighting` ativado, um álbum pequeno não fica afogado num grande quando combinas fontes. O Kiosk também suporta vários utilizadores através de `immich_users_api_keys`, escolhidos por ecrã através do URL.

### Ecrã e hardware

Ambos oferecem layouts de ecrã dividido para duas fotos na vertical num ecrã horizontal, fundos desfocados, zoom e deslocamento ao estilo Ken Burns, um relógio e a meteorologia do OpenWeatherMap. O ImmichFrame acrescenta sobreposições de calendário a partir de qualquer feed ICS (iCalendar) através de `Webcalendars`, o que faz dele um painel de cozinha bastante razoável.

O Kiosk tem mais opções para hardware sempre ligado. `burn_in_interval` reduz periodicamente a opacidade da interface para proteger painéis OLED contra burn-in. `sleep_start` e `sleep_end` apagam o ecrã durante a noite. `offline_mode` guarda localmente em cache um conjunto de elementos, para que uma moldura com Wi-Fi instável continue a funcionar. `optimize_images` redimensiona no servidor, para que um Pi Zero não tenha de descodificar um ficheiro de 48 MP a cada 60 segundos.

Com hardware Frameo, mantém as expectativas baixas. Estes dispositivos correm Android 6. A menos que atualizes o WebView do sistema, o que a documentação do ImmichFrame descreve e que implica voltar a montar `/system` como root, perdes o ecrã dividido, o suporte para HEIC (o formato de fotografia do iPhone) e o vídeo. Funciona. É uma boa forma de dar uma segunda vida a uma moldura de 40 $. É também um projeto de bricolage, não um presente que se configura em dez minutos.

### Segurança

Uma moldura de fotos está o dia todo na tua rede com uma chave para toda a tua biblioteca de fotos. A maioria das pessoas configura-a uma vez e nunca mais olha para ela. Essa combinação merece alguns minutos de reflexão.

- **Usa uma chave API dedicada para cada moldura.** O Immich permite criar chaves API com permissões limitadas. Dá à moldura apenas o que ela precisa e revoga a chave se o dispositivo se perder ou for substituído. O ImmichFrame também suporta `ApiKeyFile`, para que a chave venha de um segredo Docker em vez de um ficheiro de configuração.
- **Atenção ao acesso de escrita.** A sobreposição «more info» do Kiosk tem botões de like e hide que marcam como favorito, etiquetam ou arquivam elementos no Immich. Útil, mas significa que a chave precisa de permissões de escrita. Se não usas esses botões, desativa-os e mantém a chave só de leitura.
- **Protege a própria moldura.** Nenhum dos servidores deve estar exposto à internet. O Kiosk tem uma opção `password` e `disable_url_queries`. O ImmichFrame tem um `AuthenticationSecret` para os clientes e uma palavra-passe de administrador separada para `/admin`. A documentação do ImmichFrame indica que a interface de administração mostra as chaves API e as transmite em texto simples, por isso coloca-a atrás de HTTPS se estiver acessível fora da tua rede local.
- **Sabe o que sai da tua rede.** Com o PixelUnion, as tuas fotos viajam dos nossos servidores na Europa até ao contentor em tua casa e daí até ao teu ecrã. Nada passa por uma nuvem de terceiros. A exceção é a meteorologia: ambos os projetos enviam as tuas coordenadas para a API do OpenWeatherMap. Uma fuga pequena, mas real.

As licenças também diferem. O Kiosk é AGPL-3.0 e o ImmichFrame é GPL-3.0. Para uso pessoal, isso não muda nada. A AGPL abrange também software disponibilizado através de uma rede, por isso, se pensas pôr algum deles a correr como serviço alojado para outras pessoas, lê primeiro as licenças.

## Então, qual deves usar?

Escolhe o **Immich Kiosk** se os teus ecrãs são browsers (Raspberry Pis, tablets de parede, smart TVs) e queres que um único contentor os controle a todos. Adequa-se a quem mantém o homelab em YAML e Git, quer filtros detalhados e se preocupa com a proteção contra burn-in, horários de repouso e cache offline em hardware sempre ligado.

Escolhe o **ImmichFrame** se queres aplicações nativas, sobretudo para Apple TV, uma proteção de ecrã para Android TV ou uma moldura Frameo reaproveitada. Adequa-se a lares que querem juntar várias contas Immich numa única apresentação, ou que preferem gerir as definições numa interface web em vez de num ficheiro de texto.

Muita gente usa os dois. O Kiosk anda pelas 1,7k estrelas no GitHub e o ImmichFrame pelas 2,4k, e ambos lançam versões de poucas em poucas semanas e têm canais de Discord ativos no servidor do Immich. Dois mantenedores a resolver o mesmo problema de maneiras diferentes costumam tornar ambos os projetos melhores. É assim que o código aberto deve funcionar, e não acontece tantas vezes como se pensa.

Nenhum dos dois te vai dizer nada sobre as tuas fotos que ainda não saibas. O que fazem é tirar essas fotos de um servidor e pô-las na parede, onde realmente olhas para elas. Isso vale uma tarde de bricolage.

Se preferes passar essa tarde com a moldura em vez de a manter o Immich a funcionar, é precisamente isso que nós fazemos. Mantemos o servidor atualizado e com cópias de segurança em infraestrutura europeia. Tu recebes uma chave API para onde apontar a tua moldura.

[Começa grátis com o PixelUnion →](https://pixelunion.eu)