Sinapse

Foco de verdade para estudar no Mac. Só os apps e sites que você escolher, pausas na hora certa e nada de cancelar por impulso.

Instalar · Como usar · Recursos · Permissões · Perguntas frequentes · Compilar

---

✨ Recursos

• Lista de permitidos. Durante o estudo, só funcionam os apps que você marcou (por exemplo Claude, ChatGPT, Obsidian e o navegador). Qualquer outro app é fechado na hora, mesmo se você tentar abrir de novo.
• Sites permitidos. No Chrome, Safari, Brave, Edge, Arc e Vivaldi, abas de sites fora da lista viram uma página em branco. Já vem com claude.ai, chatgpt.com, Gemini, Perplexity, NotebookLM e Google Docs/Drive.
• Perfis por matéria. Cada perfil tem sua própria lista de apps e sites: "Programação" libera VS Code, Terminal e GitHub; "Leitura" libera só PDF, Livros e notas. Escolha o perfil no menu antes de começar, e crie quantos quiser.
• Ciclos de estudo e pausa. Ritmos prontos (25/5, 50/10, 60/10, 90/15) ou o seu. Na pausa aparece uma janela com uma sugestão ("Levanta e alonga as costas…") e os apps ficam liberados.
• Lembretes durante o estudo. A cada 20 minutos (configurável): postura, água e descanso dos olhos.
• Cancelar dá trabalho de propósito. Para encerrar antes do fim, você precisa digitar uma frase inteira. Dá pra sair numa emergência, mas não por impulso.
• Revisão no fim. Ao concluir, o Sinapse pede 3 coisas que você aprendeu, sem olhar o material. É o que mais ajuda a fixar o conteúdo.
• Histórico. Minutos de hoje e da semana, sequência de dias seguidos e o que você aprendeu em cada sessão.
• Discreto. Fica só na barra de menu, abre junto com o Mac (dá pra desligar) e não manda nenhum dado para fora: tudo fica no seu computador.

🖼️ Telas

Começar	Em sessão
Pausa	Cancelar
Fim da sessão	Histórico
Perfis	Ajustes

📦 Instalação

Requer macOS 13 (Ventura) ou mais novo. Funciona em Macs com Apple Silicon e Intel.

Opção 1: um comando (recomendado)

Abra o Terminal (⌘ + Espaço, digite "Terminal") e cole:

curl -fsSL https://raw.githubusercontent.com/Magnumja/sinapse/main/install.sh | bash

Ele baixa a última versão, instala em Aplicativos e abre o app. Para atualizar depois, é só rodar o mesmo comando.

Opção 2: download manual

1. Baixe o Sinapse.zip na página de Releases.
2. Dê dois cliques para descompactar e arraste o Sinapse para a pasta Aplicativos.
3. Na primeira vez, o macOS avisa que o app é de um "desenvolvedor não identificado" (ele não é notarizado pela Apple). Para liberar:
   • abra Ajustes do Sistema › Privacidade e Segurança, role até o fim e clique em Abrir Mesmo Assim; ou
   • no Terminal, rode xattr -dr com.apple.quarantine /Applications/Sinapse.app.

Opção 3: compilar você mesmo

Veja Compilar a partir do código.

🚀 Como usar

1. Clique no ícone do cérebro na barra de menu, perto do relógio.
2. Escreva o que você vai estudar, escolha o perfil (por exemplo Estudo, Programação ou Leitura), o ritmo (estudo/pausa) e quantos ciclos.
3. Confira a linha "Vão fechar": são os apps abertos que não estão no perfil escolhido.
4. Clique em Iniciar foco (ou aperte Enter).

Durante a sessão, a barra de menu mostra o tempo restante. Os Ajustes ficam travados até o fim, para você não mudar as regras no meio.

Para configurar, abra Ajustes:

Aba	O que dá pra mudar
Geral	Abrir ao ligar o Mac, tempos de estudo e pausa, ciclos, lembretes e a frase de cancelamento
Apps	Quais apps funcionam durante o estudo em cada perfil (busca e filtro "Permitidos")
Sites	Quais sites abrem nos navegadores permitidos em cada perfil (subdomínios entram junto)

Nas abas Apps e Sites, a barra de perfis no topo escolhe qual perfil você está editando. O + cria um perfil novo copiando o atual, e o ⋯ renomeia ou apaga. Quem vem da 1.0 não perde nada: a lista antiga vira o perfil "Estudo".

🔐 Permissões

O macOS pede algumas permissões na primeira vez. Todas ficam no seu Mac.

Permissão	Para quê	Onde mudar
Notificações	Avisos de pausa, lembretes e apps fechados	Ajustes do Sistema › Notificações › Sinapse
Automação (Chrome, Safari…)	Ler as abas abertas e bloquear sites fora da lista	Ajustes do Sistema › Privacidade e Segurança › Automação
Itens de Início	Abrir o Sinapse quando o Mac liga	Ajustes do Sinapse › Geral, ou Ajustes do Sistema › Geral › Itens de Início

Se você negar a Automação para um navegador, o menu do Sinapse mostra um aviso e aquele navegador fica sem filtro de sites.

Navegadores

Filtra sites	Sem filtro de sites
Chrome, Safari, Brave, Edge, Arc, Vivaldi	Opera, Opera GX, Firefox (não permitem ler as abas)

Navegadores sem filtro funcionam normalmente se você permitir o app, mas aí qualquer site abre. Para estudar com rigor, deixe-os fora da lista.

❓ Perguntas frequentes

Dá pra burlar?

Você é o dono do Mac, então sempre dá: por exemplo, forçando o encerramento do Sinapse pelo Monitor de Atividade, se ele estiver na sua lista de permitidos. A ideia não é ser uma prisão, e sim criar atrito suficiente para você perceber que está fugindo do estudo. Na prática, ter que digitar uma frase inteira já faz a maioria das pessoas desistir de cancelar.

Um app foi fechado e eu tinha coisas sem salvar?

O Sinapse pede para o app fechar do jeito normal, como o ⌘Q. Apps com documentos abertos mostram a pergunta "Salvar alterações?" antes de fechar. Mesmo assim, antes de começar, confira a linha "Vão fechar" no menu.

O que acontece se eu reiniciar o Mac no meio da sessão?

A sessão é salva. Quando o Sinapse abrir de novo, ela continua de onde parou. O tempo com o Mac desligado ou dormindo não conta como estudo.

Meus dados vão para algum lugar?

Não. Configurações e histórico ficam só no seu Mac (~/Library/Preferences/io.github.magnumja.sinapse.plist). O app não acessa a internet.

Como desinstalar?

1. Em Ajustes › Geral, desligue Abrir ao ligar o Mac.
2. Feche o Sinapse (menu › Sair) e arraste-o de Aplicativos para o Lixo.
3. Opcional, para apagar configurações e histórico: defaults delete io.github.magnumja.sinapse

🛠️ Compilar a partir do código

Você só precisa do Xcode ou das Command Line Tools (xcode-select --install). Não há dependências externas.

git clone https://github.com/Magnumja/sinapse.git
cd sinapse
./build.sh install

Comando	O que faz
./build.sh	Gera build/Sinapse.app para a arquitetura do seu Mac
./build.sh install	Compila, copia para Aplicativos e abre
./build.sh release	Binário universal (Apple Silicon + Intel) e build/Sinapse.zip
./Tools/screenshots.sh	Regera os prints deste README (depois de ./build.sh)

Para ver uma tela sem iniciar uma sessão de verdade (nada é bloqueado nem salvo):

open build/Sinapse.app --args --preview sessao   # menu, sessao, ajustes, perfis, historico, pausa, cancelar, fim

Lançar uma versão

O GitHub Actions compila e publica sozinho. A cada push, o CI confere se o app compila. Para lançar:

1. Mude CFBundleShortVersionString (ex.: 1.0.2) e aumente CFBundleVersion no Info.plist.

2. Faça commit e envie, depois crie e envie a tag:

   git tag v1.0.2 && git push origin v1.0.2

O workflow de release confere se a tag bate com o Info.plist, gera o binário universal e publica o Sinapse.zip na release. A partir daí, o comando de instalação já entrega a versão nova.

Estrutura

Sources/
  SinapseApp.swift    ponto de entrada, ícone da barra de menu, abrir ao ligar o Mac
  FocusEngine.swift   sessão, timer, bloqueio de apps e notificações
  Blockers.swift      lista de apps instalados e filtro de sites (AppleScript)
  Store.swift         configurações e histórico (UserDefaults)
  Views.swift         telas em SwiftUI
  Theme.swift         visual preto e branco, botões e cartões translúcidos
Assets/               ícone do app, ícone da barra de menu e logo
Tools/                geração de ícones e prints

📄 Licença

MIT © Magnum de Abreu