O MagicMirror² é um projeto de código aberto que transforma um simples espelho em uma verdadeira central de informações. Nele, você pode exibir previsão do tempo, calendário, notícias, lembretes e muito mais, tudo de forma elegante e prática.
Qualquer pessoa pode instalar
Pode parecer algo complicado, mas não é. Mesmo quem nunca programou ou não tem experiência com tecnologia consegue instalar o MagicMirror². Com alguns materiais básicos e seguindo as instruções certas, você pode ter o seu espelho inteligente funcionando em pouco tempo.
O que você vai encontrar neste artigo
Aqui você vai aprender um passo a passo simples, sem termos complicados, feito especialmente para iniciantes. A ideia é mostrar que montar seu próprio MagicMirror² pode ser muito mais fácil (e divertido) do que você imagina.
O que é o MagicMirror²?
O MagicMirror² é um projeto que transforma qualquer monitor ou tela em um espelho inteligente. A ideia é simples: por trás do espelho, você instala uma tela que exibe informações úteis do seu dia a dia, tudo de forma prática e visualmente elegante.
Entre os exemplos de uso mais comuns estão:
Relógio e data, para nunca perder a hora.
Previsão do tempo, com detalhes do clima da sua cidade.
Calendário e agenda, ideal para organizar compromissos.
Notícias em tempo real, direto de fontes online.
Mensagens personalizadas, como lembretes ou frases motivacionais.
Um dos grandes diferenciais do MagicMirror² é a comunidade ativa que o mantém e melhora constantemente. Existem dezenas de módulos gratuitos criados por pessoas do mundo todo, permitindo que você personalize seu espelho inteligente do jeito que quiser.
E o melhor: tudo isso é 100% gratuito. Você pode usar, modificar e adaptar o MagicMirror² sem custos, contando com o apoio de uma comunidade aberta e colaborativa.
O Que Você Vai Precisar Antes de Começar
Para começar o seu projeto de MagicMirror², você não vai precisar de equipamentos de ponta ou itens difíceis de encontrar. A boa notícia é que a maioria dos componentes é bastante acessível e, se você tiver um computador ou monitor antigo guardado, já está na metade do caminho! O mais importante é saber que a lista a seguir é o seu ponto de partida para a mágica acontecer, e nada aqui exige um conhecimento técnico avançado. É só reunir os itens e seguir em frente.
Lista de Materiais Básicos:
Raspberry Pi: A “mente” do seu smart mirror. Este pequeno computador de baixo custo é perfeito para o projeto, mas você também pode usar um computador antigo que não usa mais. A compatibilidade é alta, e vamos focar no Raspberry Pi por ser o mais popular entre os entusiastas de DIY, obs: (o mais usado é o Raspberry Pi modelo 3 ou 4).
Cartão microSD: Para armazenar o sistema operacional e o MagicMirror². Certifique-se de que ele tenha pelo menos 16 GB e que seja de boa qualidade para garantir a velocidade.
Monitor ou TV: O “rosto” do seu espelho. Pode ser um monitor de computador ou uma TV de tela fina. Quanto mais fina, mais fácil de embutir na sua moldura.
Fonte de Energia: Para o seu Raspberry Pi e para o monitor. É importante ter fontes de energia confiáveis para cada um deles.
Acesso à Internet: Para baixar o software e os módulos, e para que o seu espelho possa exibir informações em tempo real, como notícias e a previsão do tempo.
Com esses itens em mãos, você estará pronto para o próximo passo. E lembre-se, a única coisa que você realmente precisa é a vontade de criar. O resto a gente resolve juntos, passo a passo.
—–
Passo a Passo para Instalar o MagicMirror² do Zero
Preparar seu espelho inteligente é um processo que pode ser dividido em três etapas simples. Vamos guiar você por cada uma delas, sem complicações.
Etapa 1: Preparando o Cérebro do Seu Espelho (o Cartão SD)
Pense no Raspberry Pi como o cérebro do seu espelho, e no cartão microSD como a memória dele. Precisamos instalar um sistema operacional (o “Windows” ou “iOS” do Raspberry Pi) nessa memória.
* Baixe o programa gratuito Raspberry Pi Imager no seu computador.
* Abra o programa e selecione o “Raspberry Pi OS (32-bit)”
* Escolha o seu cartão microSD e clique no ícone de configurações (uma engrenagem). Lá, você pode adiantar a conexão Wi-Fi e criar um nome de usuário e senha.
* Clique em “Gravar”. O programa vai fazer todo o trabalho de instalação.
Com o cartão pronto, insira-o no seu Raspberry Pi e ligue-o. Ele vai iniciar o sistema sozinho.
Etapa 2: A Mágica Acontece (Instalação do Software)
Agora que o seu Raspberry Pi está funcionando, é hora de instalar o software MagicMirror²
* Quando o sistema do Raspberry Pi carregar, você verá uma área de trabalho parecida com a de um computador. Procure e abra o aplicativo chamado **Terminal**. Ele tem um ícone de tela preta e é o local onde você vai digitar os comandos.
* Dentro do **Terminal**, copie e cole este comando:
“`bash
bash -c “$(curl -sL https://raw.githubusercontent.com/MichMich/MagicMirror/master/installers/raspberry.sh)”
“`
* Pressione Enter. O script vai instalar automaticamente tudo o que é necessário para o MagicMirror² funcionar. Esse processo pode demorar alguns minutos.
* Quando a instalação terminar, o MagicMirror² abrirá sozinho em tela cheia.
Etapa 3: Personalizando o Básico
O seu espelho já está funcionando\! Mas ele provavelmente está em inglês. Para ajustá-lo, você precisará editar um arquivo.
* No Terminal, digite os seguintes comandos, um por um:
“`bash
cd ~/MagicMirror/config
cp config.sample.js config.js
nano config.js
“`
* Use as setas do teclado para encontrar as linhas que você precisa mudar. Altere as informações de `language`, `timeFormat` e `units` para:
“`javascript
language: “pt-br”,
timeFormat: 24,
units: “metric”,
“`
* Pressione `Ctrl + O` (para salvar), depois `Ctrl + X` (para sair) e Enter.
* Reinicie o MagicMirror² para ver as mudanças.
Atualizando o sistema
Com o Raspberry Pi OS instalado e o seu Raspberry Pi ligado, é hora de fazer uma “limpeza” rápida e garantir que tudo está com a última versão. Pense nisso como atualizar os aplicativos do seu celular antes de instalar um novo jogo.
Você fará isso usando o Terminal, aquela tela preta que abrimos na etapa anterior.
1. Abra o Terminal (o ícone de tela preta na barra de tarefas do seu Raspberry Pi OS).
2. Copie e cole os seguintes comandos, um de cada vez, pressionando Enter após cada linha:
| Comando | O que ele faz |
| :— | :— |
| `sudo apt update` | Verifica as Novidades: Este comando conecta o seu Raspberry Pi aos servidores e verifica quais atualizações de software estão disponíveis. Ele apenas *lista* as novidades, sem instalar nada. |
| `sudo apt full-upgrade -y` | Instala as Atualizações: Este é o comando que realmente baixa e instala as últimas versões de todos os programas do sistema. O `-y` no final significa que você já concordou com a instalação, para não ter que apertar “sim” várias vezes. |
| `sudo reboot` | Reinicia: Após as atualizações, é sempre bom reiniciar o sistema para garantir que todas as mudanças entraram em vigor corretamente. |
Depois de digitar o último comando e apertar Enter, o seu Raspberry Pi vai desligar e ligar novamente.
Agora, o seu sistema operacional está totalmente atualizado e pronto para receber o software principal do projeto: o MagicMirror² !
—
Instalando o Node.js (Essencial para o MagicMirror²)
O MagicMirror² é construído usando uma tecnologia chamada Node.js. Pense no Node.js como o “motor” que permite que o seu Raspberry Pi execute o software do espelho. Sem ele, o MagicMirror² não funcionará.
Felizmente, a comunidade do MagicMirror² tem um método simples e muito recomendado para instalar a versão correta do Node.js, garantindo que tudo funcione perfeitamente.
Versão Recomendada: Para evitar problemas de compatibilidade e garantir a estabilidade, é sempre melhor usar a versão LTS (Long-Term Support) do Node.js, que tem suporte estendido. O script que usaremos abaixo cuida disso automaticamente, instalando a versão mais estável e compatível para o seu Raspberry Pi.
Siga os passos no Terminal (a tela preta no Raspberry Pi OS):
- Baixe o script de instalação do Node.js:
- Bash
curl -sL https://deb.nodesource.com/setup_lts.x | sudo bash –
-
- O que isso faz: Este comando baixa um pequeno script (código) que adiciona a fonte oficial do Node.js ao seu sistema, preparando o caminho para a instalação da versão LTS.
- Instale o Node.js no seu sistema:
- Bash
sudo apt install -y nodejs
-
- O que isso faz: Com a fonte adicionada, este comando instala o Node.js e o NPM (o gerenciador de pacotes) no seu Raspberry Pi. O -y confirma a instalação automaticamente.
- Confirme a instalação:
- Bash
node -v
-
- O que isso faz: Depois de instalar, este comando vai exibir a versão do Node.js que foi instalada. Se você vir um número (como v20.x.x), significa que o motor do seu espelho está pronto!
Com o sistema atualizado (Seção 4.0) e o Node.js instalado, você tem todos os pré-requisitos técnicos completos. O próximo e último passo é instalar o MagicMirror² em si!
Baixando e Instalando o MagicMirror²
Chegamos ao momento mais aguardado! Com o seu Raspberry Pi pronto e o Node.js instalado (o motor do nosso projeto), agora é a hora de realmente colocar o software MagicMirror² no seu sistema.
Faremos isso usando o Git, uma ferramenta que nos permite “clonar” (copiar) o projeto oficial diretamente da internet para a memória do seu Raspberry Pi.
Passo 1: Clonando o Projeto
No Terminal (a tela preta), digite o seguinte comando e aperte Enter:
Bash
git clone https://github.com/MichMich/MagicMirror.git
- O que isso faz: Este comando se conecta ao repositório oficial do MagicMirror² (a “biblioteca” online do projeto) e baixa todos os arquivos necessários para uma nova pasta chamada MagicMirror na sua área de usuário.
Passo 2: Entrando na Pasta e Instalando as Dependências
Agora, precisamos entrar nessa nova pasta e pedir ao sistema para instalar todas as “peças” que o MagicMirror² precisa para funcionar (as chamadas dependências).
- Entre na pasta:
- Bash
cd MagicMirror
-
- O que isso faz: Você está dizendo ao Terminal para começar a trabalhar dentro da pasta do MagicMirror² que você acabou de baixar.
- Instale as dependências:
- Bash
npm install
-
- O que isso faz: Este é um comando do Node.js (o motor que instalamos antes) que lê o projeto e baixa todas as ferramentas e bibliotecas adicionais de que ele precisa. Esse processo pode levar alguns minutos.
Ao final dessa etapa, o seu MagicMirror² estará totalmente instalado e pronto para a primeira execução! É hora de ligar a magia!
Iniciando o MagicMirror² pela Primeira Vez
Parabéns! Você tem o sistema operacional, o motor Node.js e o software MagicMirror² instalados. Agora, estamos prontos para ver a interface do seu espelho inteligente ganhar vida!
Com o seu Terminal ainda aberto e dentro da pasta MagicMirror (como na seção anterior), digite o comando de ignição:
Bash
npm start
Pressione Enter e espere alguns segundos…
O Que Esperar:
De repente, a sua tela irá se transformar! O MagicMirror² abrirá em tela cheia, cobrindo o desktop do Raspberry Pi OS.
Você verá um dashboard (painel de controle) com informações básicas e distribuídas pela tela. Por padrão, ele exibirá:
- Relógio Digital: No topo, para saber as horas.
- Previsão do Tempo: Geralmente no canto superior, mostrando o clima local.
- Calendário: Mostrando alguns eventos de exemplo.
Essa é a interface padrão do MagicMirror²! É a prova de que tudo funcionou perfeitamente e que o software está pronto para ser configurado.
Como Parar o MagicMirror²
Para fechar a tela cheia do MagicMirror² e voltar ao Terminal, basta pressionar as teclas:
{Ctrl} + {Q}
Você pode iniciar e parar o espelho quantas vezes precisar, usando o comando npm start no Terminal.
Com o MagicMirror² rodando, o próximo passo é personalizar a interface, ajustar o idioma e começar a adicionar os módulos que você realmente quer ver no seu espelho!
Personalizando o Seu MagicMirror² (Sem Programação)
Ver o MagicMirror² funcionar é a parte divertida, mas a verdadeira mágica está na personalização! A melhor notícia é que você não precisa saber programar para deixar o espelho com a sua cara. Quase todas as alterações são feitas em um único arquivo de texto, chamado arquivo de configuração.
Onde Fica o “Coração” da Configuração
Toda a aparência, os módulos e as informações que você vê são controlados pelo arquivo chamado config.js. Por segurança, o sistema vem com um arquivo de exemplo (config.sample.js). Vamos criar uma cópia para começar a editar:
- Abra o Terminal e entre na pasta de configuração:
- Bash
cd ~/MagicMirror/config
- Crie seu arquivo de configuração:
- Bash
cp config.sample.js config.js
- Abra o arquivo para edição:
- Bash
nano config.js
- O comando nano abre um editor de texto simples dentro do Terminal.
Primeiros Ajustes Simples (Idioma e Unidades)
Dentro do arquivo config.js você verá várias linhas. Use as setas para encontrar e ajustar as seguintes informações para o português e o formato correto:
| Parâmetro | Valor | Objetivo |
| language | “pt-br” | Coloca textos, como dias da semana, em português. |
| timeFormat | 24 | Usa o formato de 24 horas (ex: 18:30). |
| units | “metric” | Usa unidades métricas (Celsius para temperatura, km/h para vento). |
Lembre-se de salvar: Pressione Ctrl + O e, em seguida, Ctrl + X para sair.
Módulos: Adicionando e Removendo
O arquivo config.js também contém uma seção chamada modules: [ … ]. É uma lista onde cada item é um módulo diferente (Relógio, Clima, etc.).
- Para remover um módulo: Basta apagar o bloco de código dele (incluindo as chaves { }) da lista.
- Para configurar o Clima: O módulo de clima precisa de uma chave de API (uma chave de acesso gratuita) do OpenWeatherMap. Você precisará criar uma conta gratuita no site e pegar essa chave para que o seu espelho mostre a previsão correta da sua cidade.
- Para mudar a Localização: Na configuração do módulo weather, você pode ajustar a latitude e longitude para que ele mostre a previsão do seu bairro.
A Comunidade: Módulos Prontos para Usar
O grande poder do MagicMirror² está na sua comunidade. Depois de dominar o básico, você pode pesquisar por “MagicMirror² Modules” para encontrar centenas de módulos prontos que você pode simplesmente instalar, como:
- Módulos de Controle de Casa Inteligente: Para ver o status de luzes e termostatos.
- Módulos de Notícias: Para exibir feeds RSS específicos do seu esporte ou site favorito.
- Módulos de Transporte: Para ver os horários do seu ônibus ou trem.
O processo é quase sempre o mesmo: baixe o módulo, coloque-o na pasta correta e adicione a configuração no seu config.js. É simples, divertido e totalmente livre de programação avançada!
Dicas Extras para Quem Nunca Programou
Se você chegou até aqui, parabéns! Você já fez a parte mais difícil. No entanto, é normal que, ao mexer com linhas de comando e arquivos de configuração, surjam dúvidas. Esta seção é para tranquilizar você e dar as ferramentas para que nunca se sinta perdido.
Regra de Ouro: Copiar e Colar (Mas com Atenção!)
A maior parte do seu trabalho foi feita com sucesso usando comandos que você apenas copiou e colou. Continue fazendo isso!
- Evite Digitar: Mesmo um erro de digitação minúsculo (como esquecer um espaço ou uma letra maiúscula) pode quebrar um comando. Sempre que possível, copie o comando do tutorial e cole-o no Terminal.
- Atenção ao config.js: Este é o único arquivo em que você fará muitas alterações manuais. Se o seu MagicMirror² não ligar, o problema quase sempre está aqui. Verifique se todas as vírgulas, aspas e chaves ({ }) estão nos lugares certos.
Onde Buscar Ajuda (A Comunidade é Sua Aliada)
Você não está sozinho nessa jornada. O MagicMirror² tem uma das comunidades de DIY mais ativas da internet. Se algo der errado, a resposta provavelmente já está online!
- Fórum Oficial do MagicMirror²: Este é o melhor lugar para fazer perguntas específicas. Há uma seção enorme de suporte onde a maioria dos problemas de iniciantes já foi resolvida.
- GitHub (Página do Projeto): Se o seu problema parecer um “bug” (falha de software), procure na seção Issues do repositório. Lá, os desenvolvedores discutem e corrigem erros.
- Comunidades de DIY/Makers (Reddit, Grupos): Muitos entusiastas compartilham suas soluções e projetos. Use os termos de busca “MagicMirror²” e “Raspberry Pi” para encontrar tópicos relacionados ao seu problema.
Erros Comuns e Como Resolver
| O que Aconteceu | Causa Mais Comum | Solução Rápida |
| Tela totalmente preta. | O arquivo config.js tem um erro de sintaxe (vírgula ou chave faltando). | Abra o config.js novamente e procure por erros de digitação, especialmente nas últimas linhas que você editou. |
| Módulo não aparece. | Você esqueceu de colocar o módulo na lista de modules: [ … ] no config.js ou a configuração dele está incorreta (ex: faltando o apiKey do clima). | Revise a lista de módulos e verifique se a configuração do módulo está idêntica ao que o guia pede. |
| Comando não funciona. | O comando foi digitado ou copiado com erro, ou você não está na pasta correta. | Copie o comando novamente do tutorial. Se for um comando de npm, certifique-se de que você está dentro da pasta /MagicMirror (cd ~/MagicMirror). |
Lembre-se: errar faz parte do aprendizado. Cada erro é uma oportunidade de aprender algo novo sobre o seu sistema!
Conclusão: A Magia Está Lançada!
Chegamos ao final do nosso guia, e se você seguiu todos os passos, o seu MagicMirror² está instalado e rodando! A primeira grande lição é clara: sim, é totalmente possível criar um Smart Mirror mesmo sem nunca ter escrito uma linha de código. Você transformou um pequeno computador e uma tela em um assistente pessoal futurista, provando que a tecnologia DIY (Faça Você Mesmo) é acessível a todos.
A instalação foi apenas o começo. Agora, o divertido é entrar na fase de personalização. Não se apresse! Comece aos poucos: ajuste o idioma, mude a localização do clima e adicione um ou dois módulos que façam sentido para o seu dia a dia (como notícias ou a sua agenda). Lembre-se, o seu config.js é um playground de infinitas possibilidades.
Compartilhe Sua Criação e Inspire!
Se você conseguiu ligar o seu primeiro MagicMirror², use a hashtag #MeuMagicMirrorDIY nas redes sociais e compartilhe uma foto ou vídeo da sua tela funcionando! Inspire outros iniciantes que ainda pensam que este projeto é muito complicado. Juntos, fazemos a comunidade de makers crescer!
Dúvidas Rápidas (FAQ)
- Preciso saber programar?
- Não! A instalação e 90% das personalizações são feitas com comandos de copiar/colar e edições simples no arquivo de configuração (config.js). Apenas quem deseja criar módulos totalmente novos precisa de programação.
- O MagicMirror² funciona apenas com o Raspberry Pi?
- Não! Embora o Raspberry Pi seja a opção mais popular por ser compacta e barata, o software funciona em qualquer computador com Linux ou macOS. PCs antigos com uma distribuição Linux leve também são uma ótima alternativa.
- O software é gratuito?
- Sim, totalmente! O MagicMirror² é um projeto de código aberto, o que significa que ele é gratuito para usar, modificar e compartilhar. A comunidade mantém e aprimora o projeto de forma voluntária.