Jogos & Pixel Enviado 2026

Pomodoro Diabrete

Timer pixel art com familiar que cansa no foco e revive na pausa

Diabrete focado — pixel art gerada em tempo real

Stack Tecnológica

Python Pygame Pixel Art Pytest
Ver Código Voltar ao Bestiário

Pomodoro Diabrete

Um timer Pomodoro diferente: um monstrengo pixel art que acompanha a sessão. Enquanto você trabalha ele cansa e vai se demonizando — a cor, os chifres, os olhos e a boca mudam de fofos para demoníacos conforme a energia cai. Na pausa, ele descansa e volta a ficar feliz.

O diferencial é que a troca de fase é manual: quando o foco termina, o bichinho fica aguardando você marcar o início da pausa. É aí que entra a animação de alegria — uma recompensa visual por respeitar o descanso.

Modo overlay

A janela foi feita para ficar discretamente na tela sem atrapalhar o trabalho:

  • Repouso (compacto): só o monstrengo e o timer flutuando, com opacidade baixa.
  • Expandido (mouse em cima): a opacidade sobe e aparece um painel com fase, energia, ciclos e botões (iniciar/pausar, pular, reset, sair).

A transição é suave e disparada pela entrada do cursor na janela. No Windows a janela vira uma layered window com cor-chave: o fundo fica 100% transparente e o restante recebe a opacidade atual. Em outros sistemas (ou com --opaque) a janela abre opaca normalmente.

Como funciona

Ciclo de fases

FOCO --(tempo acaba)--> aguardando --(usuário marca a pausa)--> PAUSA (comemora)
  ^                                                                  |
  +--------------- aguardando <--(tempo acaba)-----------------------+
  • FOCO — 25 min por padrão; a energia cai e o bichinho demoniza aos poucos.
  • PAUSA — 5 min; a energia sobe e ele dorme, acorda e comemora.
  • tick() nunca troca de fase sozinho: apenas sinaliza o fim com um evento.
  • skip() (tecla S) encerra a fase imediatamente, como se o tempo tivesse acabado.

Modelo de energia

A energia vai de 0 a 100 e é atualizada por tempo decorrido, com taxas derivadas dos parâmetros de custo/recuperação:

Durante FOCO:   E = clamp(E - focus_cost    / focus_duration * dt, 0, 100)
Durante PAUSA:  E = clamp(E + break_restore / break_duration * dt, 0, 100)

Com os valores padrão (focus_cost = 45, break_restore = 45), um ciclo completo devolve o bichinho ao ponto de partida:

E=85  --FOCO 25min-->  E=40 (cansado)  --PAUSA 5min-->  E=85 (recuperado)

Diminuindo break_restore, o cansaço acumula ao longo do dia.

Humor e expressões

CondiçãoHumorAparência
energia ≤ 20exhaustedvermelho demoníaco, chifres roxos, olhos virados
energia ≤ 45tiredlaranja, olhos semicerrados, suor, presas e cauda
FOCO e energia > 45focusfofo, sobrancelhas determinadas e olhar fixo
energia ≤ 75 (pausa)okamarelado, sorriso discreto
energia > 75 (pausa)happyverde-menta, olhos grandes e bochechas

A propriedade _menace() (0 = fofinho, 1 = demônio) interpola cor do corpo, chifres, olhos, boca e cauda em tempo real. A camada visual acrescenta ainda o estado resting (olhos fechados e zZz) e a animação de alegria ao iniciar a pausa, com pulo, estrelas e anel de destaque.

Arquitetura

O projeto separa regra de negócio de apresentação — pet.py não importa Pygame, o que permite testar toda a mecânica sem abrir janela.

  • pet.py — máquina de estados, energia, humor e formatação de tempo.
  • pomodoro.py — renderização pixel art, animações, entrada e loop principal.
  • tests/ — testes de lógica (test_pet.py) e de renderização headless (test_pomodoro.py, com SDL_VIDEODRIVER=dummy).

O monstrengo é desenhado em uma superfície lógica de 64×64 e ampliado 2× com nearest-neighbor, sem assets externos.

Instalação e execução

pip install -r requirements.txt
python pomodoro.py

Modo demo, com ciclos curtos (6 s de foco / 4 s de pausa) para ver o fluxo completo em segundos:

python pomodoro.py --demo

Em máquinas sem transparência, ou para forçar a janela opaca:

python pomodoro.py --opaque

Controles

AçãoEntrada
Revelar o painelPassar o mouse sobre a janela
Iniciar / pausar / começar faseBotão principal, clique no monstrengo, Espaço ou Enter
Pular faseBotão pular ou S
Novo ciclo (reset)Botão reset, clique direito ou R
SairBotão sair ou Esc
Mover a janelaArrastar (fora dos botões)
Sons--sound (padrão: mudo)

O botão principal muda de rótulo conforme o contexto: iniciar foco, pausar, retomar e comecar pausa.

Testes

pip install pytest
pytest tests/ -v

Parâmetros de ajuste

Ficam em pet.py (mecânica) e pomodoro.py (visual): duração de foco e pausa, energia inicial, custo/recuperação por fase, limiares de humor, resolução e escala da pixel art, opacidade no repouso e no hover, velocidade da transição, cor-chave, duração das animações e paleta da barra de energia.

Segredo: o Diabrete vive no rodapé do códice. Clique nele 5 vezes.