Ratinho 🐭

Mantém o seu Mac sempre ativo — sem ausência, sem repouso, sem aquele "está ausente" no trabalho.

_{Prefere ver todas as versões? Acesse a página de Releases.}

O Ratinho é um pequeno app que mora na barra de menus do seu Mac e dá uma "cutucada" discreta no cursor de tempos em tempos, só quando você está longe do computador. Assim o Mac nunca aparece como ausente em apps como Slack, Teams ou Google Chat, e não entra em protetor de tela nem em repouso enquanto você toma um café. ☕

É a ferramenta que eu uso para manter o meu Mac ativo — aqui numa versão aberta e organizada, pronta para você instalar e usar do mesmo jeito.

_{O menuzinho do 🐭 mora na barra de menus — estado, intervalo (1–5 min) e início automático, tudo a um clique.}

Para amigos que só querem usar: siga estes 3 passos e pronto.

Clique aqui para baixar direto: ⬇️ Ratinho-1.0.dmg (ou veja todas as versões na página de Releases).

Abra o .dmg e arraste o Ratinho para a pasta Aplicativos.

O Ratinho é um app caseiro, não registrado na Apple (registrar custa uma assinatura anual paga). Por isso, na primeira vez, o macOS vai desconfiar. É seguro — o código está todo aqui. Faça assim:

• Abra a pasta Aplicativos, clique com o botão direito no Ratinho e escolha Abrir.
• No aviso que aparecer, clique em Abrir de novo.

Se mesmo assim não abrir (macOS Sonoma/Sequoia às vezes é mais rígido), vá em Ajustes do Sistema → Privacidade e Segurança, role até o fim e clique em "Abrir Mesmo Assim".

Atalho pra quem gosta do Terminal: um comando resolve de vez —

xattr -dr com.apple.quarantine /Applications/Ratinho.app

Para mover o cursor, o macOS exige a permissão de Acessibilidade. O próprio Ratinho vai te avisar e abrir a tela certa. Lá, basta:

Ajustes do Sistema → Privacidade e Segurança → Acessibilidade → ligue a chavinha do Ratinho. ✅

Pronto! O ícone do 🐭 aparece na barra de menus e o Mac fica sempre ativo.

Clique no ícone do Ratinho na barra de menus:

O ícone fica preenchido quando está mantendo o Mac ativo e esmaecido quando está pausado.

O Ratinho pergunta ao sistema há quanto tempo você não toca no mouse ou no teclado (CGEventSourceSecondsSinceLastEventType). Se você está inativo há mais do que o intervalo escolhido, ele posta um evento de movimento de cursor (CGEventPost) — um passinho para o lado e outro de volta, animado, quase imperceptível. Esse evento "real" é o que zera o cronômetro de inatividade do macOS e mantém você como presente.

Se você estiver usando o Mac normalmente, ele não faz nada — não há por que acordar quem já está acordado.

Tudo isso em Objective-C puro, usando só frameworks nativos da Apple (Cocoa, CoreGraphics). Nada de dependências externas.

Quer gerar o app você mesmo? Precisa apenas das Ferramentas de Linha de Comando do Xcode (xcode-select --install). Depois:

git clone https://github.com/buuuhlopes/Ratinho.git
cd Ratinho

make build     # compila e gera build/Ratinho.app (Apple Silicon / arm64)
make run       # compila e já abre
make dist      # publica o app em dist/ e gera o dist/Ratinho-1.0.dmg
make clean     # limpa os artefatos

Estrutura do projeto:

Ratinho/
├── src/                    # Código-fonte (Objective-C)
│   ├── main.m              # Ponto de entrada (app da barra de menus)
│   ├── RatinhoController.*  # Menu, cronômetro e preferências
│   ├── MouseMover.*        # Movimento do cursor + permissão de Acessibilidade
│   ├── LoginItem.*         # "Iniciar ao ligar o Mac" (LaunchAgent)
│   └── RatinhoDefaults.*   # Constantes e chaves de preferências
├── Resources/
│   ├── Info.plist
│   └── AppIcon.icns        # Ícone do app
├── scripts/
│   ├── build.sh            # Compila e monta o .app
│   └── make-dmg.sh         # Gera o instalador .dmg
├── dist/                   # App e instalador prontos para distribuir
└── Makefile

Sobre os downloads prontos: o Ratinho.app e o .dmg das Releases são compilados exatamente deste código-fonte — o que você baixa é o que está aqui, sem surpresas. Ficam prontos para quem só quer usar, enquanto o código continua aberto para quem quiser conferir ou compilar por conta própria.

O Ratinho é seguro? Ele espiona alguma coisa? Não. Ele não acessa a internet, não coleta dados e não abre arquivos. A única coisa que faz é mover o cursor de vez em quando. Todo o código está aberto neste repositório.

Por que ele pede permissão de Acessibilidade? No macOS, mover o cursor por software é uma ação "de acessibilidade". Sem essa permissão, o sistema simplesmente ignora o movimento. É obrigatório — e é o único acesso que ele pede.

"O app não pode ser aberto porque é de um desenvolvedor não identificado." É o aviso normal para apps caseiros. Veja o passo 2 da instalação.

Para qual Mac ele foi feito? Para Macs com Apple Silicon (chips M1, M2, M3 em diante) — é o app que a autora usa para manter o Mac ativo. Macs Intel não são o alvo desta versão.

Como desinstalo? Arraste o Ratinho da pasta Aplicativos para o Lixo. Se você tinha ativado o "iniciar ao ligar", remova também o arquivo ~/Library/LaunchAgents/com.angelica.ratinho-app.plist.

MIT — use, compartilhe e modifique à vontade.