2

Pitch: Fiz um programa de projeção para a minha igreja e abri o código: U-Control

Na igreja onde eu sirvo, a projeção sempre dependeu de alguém sentado no computador do telão. Comecei o U-Control para resolver isso: um computador roda o programa e qualquer celular, tablet ou PC da rede controla o telão pelo navegador.

Ele está em uso de verdade nos cultos, rodando num Raspberry Pi, e agora o código está aberto (MIT).

Controle do U-Control

O que ele faz

  • Letra no telão, cifra no palco: o público vê só a letra; o monitor dos músicos mostra a cifra e a próxima parte. Cada músico muda o tom no próprio aparelho.
  • Bíblia com busca por referência e duas versões ao mesmo tempo no telão.
  • Ordem do culto: músicas e leituras abrem na sequência.
  • PowerPoint com animação, fotos, vídeos, relógio, cronômetro e avisos no rodapé.
  • Tela do PC no telão (WebRTC) e atalhos para Stream Deck.
  • Importa músicas do Holyrics, OpenLP, ChordPro ou texto.
  • Não precisa de internet durante o culto.

Como é por dentro

  • Python com Flask e Flask-SocketIO: todas as telas ficam sincronizadas por WebSocket.
  • SQLite com migrations (Alembic), gunicorn com eventlet em produção.
  • Front sem framework, JavaScript puro; cifra e partitura renderizadas no navegador (VexFlow).
  • PowerPoint convertido pelo LibreOffice, mantendo animações e transições.
  • Instalador de Windows montado pelo GitHub Actions, imagem Docker (amd64 e arm64) e um instalador de um comando para Linux/Raspberry Pi.

Algumas coisas que aprendi no caminho e que podem render posts próprios: N+1 do SQLAlchemy deixando a edição de música lenta no Pi (743 consultas para salvar uma música), e o gunicorn com gthread travando todas as requisições num app com Socket.IO.

Como testar

Site: https://brunomint.github.io/U-Control/
Código: https://github.com/brunomint/U-Control

Se a sua igreja usa outro programa, queria muito saber o que falta para trocar. Issues e pull requests são bem-vindos.

Carregando publicação patrocinada...
1

projeto massa, e rodar offline num Pi é bem o que igreja precisa. uma coisa pra ficar de olho: o README do eventlet hoje desencoraja uso em projeto novo, eles estão só em manutenção e planejando aposentar a lib. o Flask-SocketIO também roda com gevent ou no modo threading com simple-websocket, então se o eventlet começar a dar problema com Python novo já tem pra onde ir sem mexer na parte do Socket.IO.

fiquei curioso com as 743 consultas, era lazy loading das partes da música?

1

Valeu! Bem lembrado sobre o eventlet. No Windows o U-Control já roda sem ele (Flask-SocketIO em modo threading + simple-websocket); só o Pi e o Docker usam o worker eventlet do gunicorn. Lá atrás eu tinha tentado o gthread no Pi e travava tudo. Com teu comentário fui ver de novo: era o gunicorn com 1 thread só (o padrão), e a primeira conexão do Socket.IO segurava ela. Com --threads 100 funcionou, com WebSocket de verdade e 5 telas abertas. Vou trocar numa próxima versão e aposentar o eventlet.

E sim, as 743 eram lazy loading: 1 consulta das músicas + 371 de seções + 371 de partituras. Com selectinload virou 3 consultas.

1

743 pra 3 consultas é uma diferença e tanto. e faz sentido o gthread travar com 1 thread, a conexão do Socket.IO fica presa nela o tempo todo. cada tela aberta segura uma thread, então as 100 dão folga de sobra pro uso de uma igreja.

1

Pois é, foi exatamente isso! Antes de trocar no Pi, fiquei com uma dúvida: tu ficaria no gthread com 100 threads mesmo, ou iria pra gevent? O Pi tem pouca memória, e numa igreja costumam ficar umas 5 a 10 telas abertas (telão, retorno de palco, os celulares dos músicos). Fico na dúvida se tanta thread parada pesa, ou se o gevent seria mais leve pra esse tanto de conexão aberta.

1

pra 5 a 10 telas eu ficaria no gthread mesmo. o --threads 100 é só o teto: o gunicorn vai criando as threads conforme chega conexão, então parado ele não fica com 100 abertas. e a pilha de cada thread que aparece no top é memória reservada, o que ela usa de verdade é bem pouco.

o gevent ia trazer de volta o monkey patching, que é o mesmo tipo de dor de cabeça do eventlet. só confere se tá rodando com um worker só (-w 1), porque Socket.IO com mais de um worker precisa de sticky session e aí complica.

1

Segui tua dica: o Pi está no gthread desde o começo do mês, com -w 1 e --threads 100, e o eventlet foi aposentado. O Docker usa o mesmo arquivo de configuração. Rodou os cultos sem problema.

Teve uma surpresa no caminho: de vez em quando o worker travava logo ao subir. O serviço ficava "ativo" e a porta aberta, mas o site não respondia. Era a thread do control socket do gunicorn 25 escrevendo no log bem na hora do fork. Num teste isolado, travou 6 de 45 subidas com ela ligada e 0 de 45 com control_socket_disable = True. Desliguei e não travou mais.

Valeu pela ajuda! Se quiser dar uma olhada, o projeto ganhou um guia de contribuição e umas issues pra quem quiser começar: https://github.com/brunomint/U-Control/labels/good%20first%20issue