🇺🇸 English
Projeção gratuita e de código aberto para igrejas. Letras com cifra, Bíblia, fotos, vídeos, PowerPoint e a ordem do culto no telão, controlados pelo navegador do PC, do celular ou do tablet.
Um computador roda o U-Control (Windows, Raspberry Pi ou Docker) e
qualquer aparelho na mesma rede abre o Controle ou as telas pelo endereço
http://<ip>:8585. Não precisa de internet durante o culto.
⬇ Baixar para Windows · Site do projeto · No AlternativeTo
| Telão | Monitor de palco (músicos) |
|---|---|
![]() |
![]() |
| Bíblia em duas versões | Pelo celular |
![]() |
![]() |
- Músicas com cifra: o telão mostra só a letra e o monitor de palco mostra a cifra, com a próxima parte embaixo. Cada músico pode mudar o tom no próprio aparelho, sem mexer no dos outros. Também guarda partitura.
- Bíblia: traduções livres incluídas, busca por referência e duas versões ao mesmo tempo no telão.
- Ordem do culto e agenda: a ordem de cada culto abre as músicas e leituras na sequência.
- Fotos, vídeos e PowerPoint: apresentações com animação e transição continuam animadas no telão (convertidas pelo LibreOffice).
- Tela do PC: compartilha a tela de um computador no telão pela rede.
- Site no telão (Windows): abre um site em tela cheia e o Controle rola, avança e dá zoom.
- Relógio, cronômetro e avisos passando no rodapé.
- Atalhos para Stream Deck e outros botões, por endereço web.
- Importar músicas do Holyrics, OpenLP/OpenLyrics, OpenSong, ChordPro ou texto.
- Backup e exportar/importar músicas e cultos entre instalações.
- Atualização avisada no próprio programa (Windows).
Baixe o U-Control-Setup-x.y.z.exe na página de
Releases e
instale. O programa fica na bandeja do Windows (ao lado do relógio), e
pelo menu dela você abre o Controle e as telas (telão e retorno de
palco), que vão para o segundo monitor em tela cheia.
Os dados ficam em %APPDATA%\U-Control. Instalar uma versão nova por
cima não apaga nada.
No Ubuntu, Debian, Linux Mint ou Raspberry Pi OS (64 bits), um comando instala tudo e deixa o U-Control ligando junto com o computador:
curl -fsSL https://brunomint.github.io/U-Control/instalar.sh | bashRodar de novo atualiza para a última versão (com cópia do banco antes).
Com | bash -s -- --telao, o telão também abre em tela cheia ao entrar
na área de trabalho. As outras opções estão no começo do
script.
Para instalar à mão:
git clone https://github.com/brunomint/U-Control.git
cd U-Control
python3 -m venv venv
venv/bin/pip install -r requirements.txt
venv/bin/python scripts/patch_flask_socketio.py
./ucontrol.shO ucontrol.sh aplica as migrations do banco e sobe o gunicorn (ver
gunicorn.conf.py); no Pi ele roda como serviço do systemd.
O ffmpeg (pacote do sistema) é usado para vídeos de PowerPoint e
áudio do YouTube; o LibreOffice, para converter apresentações. Instale
junto as fontes livres que substituem as do Office com as mesmas medidas
(Calibri, Cambria, Arial…), senão o texto dos slides sai mais largo e quebra:
sudo apt install ffmpeg libreoffice-impress fonts-crosextra-carlito fonts-crosextra-caladea fonts-liberation2A imagem pronta (PC e Raspberry Pi 4/5, 64 bits) fica em
ghcr.io/brunomint/u-control. Com o
docker-compose.yml numa pasta:
docker compose up -dOu direto, sem o compose:
docker run -d --name ucontrol --network host --restart unless-stopped \
-v ./docker-data/instance:/app/instance \
-v ./docker-data/imagens:/app/static/imagens \
-v ./docker-data/audio:/app/static/audio \
ghcr.io/brunomint/u-control:latestOs dados ficam em docker-data/. Para atualizar: docker compose pull
e docker compose up -d. Quem clonou o repositório e quer rodar o
próprio código usa docker compose up -d --build.
No painel do CasaOS: App Store → "+" (Custom Install) → Import e cole o endereço abaixo (ou o conteúdo do arquivo):
https://brunomint.github.io/U-Control/casaos/docker-compose.yml
Os dados ficam em /DATA/AppData/u-control.
No Portainer: Stacks → Add stack, dê o nome u-control e cole no
editor:
services:
u-control:
image: ghcr.io/brunomint/u-control:latest
network_mode: host
environment:
TZ: America/Sao_Paulo
volumes:
- u-control-instance:/app/instance
- u-control-imagens:/app/static/imagens
- u-control-audio:/app/static/audio
restart: unless-stopped
volumes:
u-control-instance:
u-control-imagens:
u-control-audio:No Umbrel, instale o Portainer pela loja de apps e siga o mesmo caminho.
Em todos os casos o U-Control usa a rede do próprio servidor
(network_mode: host): abra http://<ip-do-servidor>:8585. A porta 8585
precisa estar livre.
-
No computador, abra o Raspberry Pi Imager e grave o Raspberry Pi OS (64-bit) no cartão. Use a versão com área de trabalho se o Pi também vai ligar direto no telão, ou a Lite se ele for só o servidor.
-
Antes de gravar, em Editar configurações: escolha o nome do aparelho (ex.:
ucontrol-pi), usuário e senha, o Wi-Fi (se não usar cabo) e ative o SSH. -
Ligue o Pi na rede, espere uns 2 minutos e entre nele pelo terminal do computador:
ssh <usuário>@ucontrol-pi.local. -
Rode o instalador. Se o Pi também for abrir o telão em tela cheia, troque o final por
| bash -s -- --telao:curl -fsSL https://brunomint.github.io/U-Control/instalar.sh | bash -
Em qualquer celular ou PC da mesma rede, abra
http://ucontrol-pi.local:8585(ou o IP do Pi) e crie o primeiro usuário.
Numa instalação nova, a tela de login pede para criar o primeiro usuário. Os outros se cadastram depois em Usuários.
Vêm incluídas só traduções de licença aberta ou de domínio público, como a Bíblia Livre e a Nova Bíblia Viva. Traduções com direitos autorais (NVI, ACF, ARC...) podem ser adicionadas por quem tem o direito de usá-las: veja bibles/LICENSES.md.
venv/bin/pip install -r requirements-dev.txt
venv/bin/pytestO instalador do Windows é montado pelo GitHub Actions
(.github/workflows/build-windows.yml). Uma tag vX.Y.Z, igual ao
arquivo VERSION, publica uma Release.
Achou um problema ou tem uma ideia? Abra uma
issue. Correções e
melhorias por pull request são bem-vindas: o
guia de contribuição explica como rodar o projeto e os
testes, e as issues marcadas com
good first issue
são um bom começo.
Gostou? Curta o U-Control no AlternativeTo: é assim que ele aparece para outras igrejas que procuram uma alternativa ao Holyrics ou ao OpenLP.
MIT para o código. As Bíblias incluídas têm as licenças listadas em bibles/LICENSES.md.





