# Manual do Peek

O Peek é um app para macOS que fixa um painel pequeno na borda da tela. Cada coisa que ele mostra é um **módulo**: um ícone na faixa, um número curto embaixo dele e um cartão que abre quando o ponteiro chega. O cronômetro de foco, a lista de tarefas, os blogs que você acompanha, o uso do Mac e qualquer serviço que você use ficam todos na mesma faixa, sempre no mesmo lugar.

O app vive na barra de menus. Ele não ocupa lugar no Dock do macOS.

## Instalar

O Peek pede **macOS 15 ou mais recente**.

1. Baixe o arquivo `.dmg` e abra.
2. Arraste o app para Aplicativos.
3. Abra o app uma vez a partir de Aplicativos.

O instalador é assinado com o Developer ID e notarizado pela Apple, então o macOS abre sem aviso. Uma única imagem serve para Macs com chip Apple e com Intel.

## A primeira abertura

Na primeira abertura o app mostra uma introdução de seis telas. Ela apresenta o painel, deixa você escolher onde cada ícone fica e em que borda o painel se encaixa, e lista as permissões do macOS. Você pode pular a introdução e vê-la de novo depois em Configurações › Geral.

O painel aparece na tela a partir da segunda tela da introdução.

### As permissões

> [!NOTE]
> Nenhuma permissão é obrigatória. Sem ela, só o que depende dela deixa de funcionar.

| Permissão | Para que serve | Quando conceder |
| --- | --- | --- |
| Notificações | Um alerta chega até você com o painel fechado. | Na tela de permissões da introdução, no botão Permitir. |
| Automação | Um script de plugin fala com outro app do Mac. | O macOS pergunta na primeira vez que um script roda. |
| Acesso Total ao Disco | O Peek lê se um Modo de Foco do macOS está ligado, para segurar os alertas até ele acabar. | Ajustes do Sistema › Privacidade e Segurança › Acesso Total ao Disco. |

Cada linha dessa tela tem um botão que abre a página certa dos Ajustes do Sistema.

### O primeiro segredo

Quando um plugin pede um token, o app pergunta uma vez onde guardar esse tipo de valor. Escolha as **Chaves do Mac**: é o cofre do próprio macOS, e ele pede a sua autorização antes de entregar o valor.

A escolha fica em Configurações › Geral e pode ser trocada depois.

### Abrir junto com o Mac

Configurações › Geral › Iniciar › **Abrir ao fazer login**. Se o macOS recusar, mova o app para a pasta Aplicativos e tente de novo.

## Teste e licença

O Peek funciona inteiro por 15 dias, sem cartão e sem cadastro. Passado o teste, os módulos param de ler até você ativar uma licença. O mesmo vale quando uma assinatura termina. Nada é apagado: tarefas, links e plugins continuam onde estavam.

### Comprar

Você escolhe entre a assinatura anual e a licença vitalícia, paga uma vez, em [peek.marcelxsilva.dev](https://peek.marcelxsilva.dev). O pagamento é processado pela Paddle, que emite o recibo e cuida dos impostos.

Assim que o pagamento é aprovado, a chave chega no e-mail que você usou na compra.

### Ativar

O e-mail traz um botão que abre o Peek com a chave já preenchida. Para fazer à mão, copie a chave e cole em Configurações › Licença › Chave, e toque em **Desbloquear**.

A chave vale para um Mac de cada vez.

### Trocar de Mac

Em Configurações › Licença, **Desativar neste Mac** libera a chave. Ela continua funcionando, e você a usa no Mac novo. Se o teste de 15 dias já tiver acabado, os módulos param neste Mac até você colar a chave de novo.

## O Dock

O Dock do Peek é o painel preso à borda da tela. Ele não é o Dock do macOS, e os dois convivem: mostrar ou esconder o Dock do macOS não move o painel do Peek.

### O que tem nele

Cada módulo ocupa uma célula com quatro partes:

- **O arco**, um trilho cinza com um traço na cor do tema em volta do ícone. Ele mostra uma fração, como 62% de CPU ou o quanto do ciclo de foco já passou. Nem todo módulo tem arco.
- **A marca** no centro, que pode ser um símbolo, uma palavra curta (CPU, GPU) ou uma imagem.
- **O rótulo** abaixo, um valor curto. Fica vazio quando não há o que dizer.
- **O arco interno**, que mostra o estado: âmbar pulsante quando o módulo espera você, girando enquanto ele está lendo.

O arco muda de cor conforme o valor. Abaixo do primeiro limiar ele usa a cor do tema, entre os dois limiares fica âmbar e acima do segundo fica vermelho. Os dois limiares estão em Configurações › Notificações.

Nas pontas da faixa há duas alças. A de cima é o puxador da **seção oculta**, e a de baixo é o **orbe de configurações**.

### Abrir e fechar

| Gesto | O que acontece |
| --- | --- |
| Ponteiro na borda | A faixa se desdobra, se ela estiver no modo «Mostrar ao passar o mouse». |
| Ponteiro parado sobre um ícone por meio segundo | O cartão daquele módulo abre ao lado. |
| Atravessar a faixa | Nada abre pelo caminho. O cartão só abre quando o ponteiro fica parado. |
| Clique no corpo da faixa | Mantém a faixa aberta. Um segundo clique libera. |
| Clique num ícone | Relê aquele módulo agora. Se o módulo for um botão, o clique roda a ação dele. |
| Clique com o botão direito | Abre o menu com Manter aberto, Atualizar agora e Sair. |
| Option e arrastar | Move a faixa ao longo da borda. A posição é lembrada por borda. |

O cartão fecha quando o ponteiro sai dele. Ele espera um quarto de segundo antes de fechar, para você conseguir atravessar o espaço entre o ícone e o cartão.

### O cartão

O cartão abre do lado oposto à borda: à esquerda quando a faixa está na direita, abaixo quando ela está no topo. Ele tem, conforme o módulo:

- cabeçalho com ícone, título e uma linha menor embaixo;
- métricas, cada uma com rótulo, valor à direita, barra de progresso e legenda;
- listas de linhas com título, segunda linha, valor à direita e um status colorido. Clicar numa linha abre o link dela;
- abas, quando há mais de uma lista;
- botões, no cabeçalho, em cada linha ou num painel próprio;
- uma linha para digitar, nos módulos que aceitam texto.

O cartão cresce com o conteúdo e para na metade da tela. O que passa disso rola dentro dele.

### A seção oculta

Um módulo pode ficar fora da faixa, guardado na seção oculta. O puxador fica na ponta da faixa, antes do primeiro ícone. Leve o ponteiro até lá e os ícones guardados aparecem. Cada um tem o próprio cartão, que abre do mesmo jeito.

Quando há mais ícones guardados do que espaço, eles se apertam em vez de sair da tela.

### O orbe de configurações

Na outra ponta da faixa há um arco. Quando o ponteiro chega, ele vira uma engrenagem. O clique abre a janela de Configurações.

### Tela cheia

Com um app em tela cheia na frente, a faixa se recolhe sozinha. Ela volta quando você sai da tela cheia. Se você tiver fixado a faixa com Manter aberto, ela continua aberta.

### Várias telas

Em Configurações › Aparência você escolhe entre a tela principal e todas as telas. Com todas as telas, cada monitor ganha a própria faixa, e só a que está sob o ponteiro abre.

### O item na barra de menus

O Peek vive na barra de menus. O menu dele tem duas linhas: Configurações e Sair.

## Módulos

Um módulo é uma fonte de informação com um lugar na faixa. Os módulos nativos vêm no app. Os plugins são módulos que você mesmo monta. Os dois funcionam do mesmo jeito: têm marca, arco, cartão, intervalo de leitura e lugar na faixa.

### Onde cada módulo fica

Cada módulo escolhe um dos quatro lugares, na linha dele em Configurações › Módulos.

| Lugar | O que significa |
| --- | --- |
| **Desligado** | Não é lido e não aparece em lugar nenhum. |
| **Oculto** | Fica na seção oculta, na ponta da faixa. Aparece quando o ponteiro chega lá. |
| **Na barra** | Sempre visível na faixa. |
| **Ao passar o mouse** | Fora da faixa até o ponteiro chegar nela. Volta sozinho quando tem novidade. |

Há uma exceção. Um módulo que está no meio de algo que precisa ser visto toma um lugar na faixa enquanto durar, onde quer que você o tenha guardado. Hoje quem faz isso é o Foco, enquanto o ciclo corre.

A ordem na faixa é a ordem da lista em Configurações › Módulos, e se muda arrastando as linhas. A faixa cabe inteira na tela: quando ela enche, o painel diz quantos ícones cabem e não aceita outro na barra.

### Estados

| Estado | O que aparece |
| --- | --- |
| Normal | O valor da última leitura. |
| Lendo | Um arco girando no ícone. |
| Desatualizado | O último valor bom que o app guardou, marcado como antigo. |
| Precisa de acesso | O módulo diz o que falta para ele conseguir ler. |
| Erro | O que deu errado, em vez de um valor inventado. |

O app guarda a última leitura boa entre execuções. Depois de reiniciar, o ícone mostra o que já sabia em vez de ficar vazio.

### Quando um módulo chama atenção

Quando um módulo recebe uma novidade:

1. O ícone pisca e salta, no sentido que se afasta da borda.
2. A faixa se abre por alguns segundos, se «Abrir o Dock quando um módulo tiver novidade» estiver ligado.
3. Um som toca, se «Tocar um som» estiver ligado.
4. Um módulo que está em «ao passar o mouse» volta para a faixa.

> [!TIP]
> Com «Reduzir movimento» ligado no macOS, o salto não acontece. A mudança de estado do ícone continua.

Enquanto um Modo de Foco do macOS estiver ligado, o piscar, o som e a abertura ficam guardados e saem de uma vez quando o foco termina. Para isso o Peek precisa de Acesso Total ao Disco.

### Com que frequência cada módulo é lido

Cada módulo pede o próprio intervalo. Os feeds leem a cada hora, as métricas do sistema a cada 3 segundos e um plugin lê no intervalo que o manifesto declara, de 5 segundos a 1 hora. Foco, tarefas, notas e ler mais tarde não têm relógio: eles mudam quando você mexe neles.

Fora da tomada esses intervalos são multiplicados. Veja [Configurações › Energia](#configurações--energia).

## Os módulos que já vêm no app

### Foco

Um pomodoro com arco.

**Os quatro números.** Foco 25 min, pausa curta 5 min, pausa longa 15 min e 4 ciclos até a pausa longa. Os limites são 5 a 90, 1 a 30, 5 a 60 e 2 a 8. Abra o cartão e clique na engrenagem para mudar.

**Os botões.** Iniciar e pausar, reiniciar, pular.

**O arco.** Ele mostra o quanto do ciclo já passou, e o rótulo mostra o tempo que falta. Parado, o arco fica vazio.

Enquanto o ciclo corre, o módulo toma um lugar na faixa, mesmo que você o tenha guardado na seção oculta. Quando uma fase termina, o app avisa.

### Tarefas

Uma lista com duas abas, A Fazer e Concluídas.

- O botão de mais abre uma linha para digitar. A linha continua aberta depois de cada item, então escrever cinco tarefas é uma visita só. Enter com o campo vazio fecha a linha.
- A marca à esquerda de cada linha conclui a tarefa ali mesmo. Na aba das concluídas, a mesma marca devolve a tarefa para a lista.
- Cada linha tem um tempo e um botão de play. O tempo começa em 25 minutos e anda de 5 em 5, entre 5 e 120. O play inicia a contagem daquela tarefa, e o app avisa quando o tempo acaba.
- O botão de limpar apaga as concluídas.

**O arco.** Ele corre enquanto uma contagem está rodando.

O cartão mostra quatro linhas e rola o resto.

### Notícias

Feeds RSS e Atom.

- Cole o endereço de um blog no cartão. O app descobre o feed sozinho, pela declaração no HTML da página ou pelos caminhos usuais.
- As abas do cartão são os blogs, cada um com o próprio favicon. A primeira aba, «Todos», mistura tudo em ordem de publicação.
- O app guarda as cinco últimas notícias de cada blog. Clicar numa notícia abre o navegador.
- O botão de recarregar fica no cabeçalho.

**Intervalo.** 1 hora.

### Ler mais tarde

Um link guardado com um lembrete.

- Cole um endereço no cartão. O app lê a página uma vez, na hora de salvar, para guardar o título e o ícone do site.
- O prazo tem seis paradas: 1 hora, 5 horas, 1 dia, 3 dias, 5 dias e 7 dias. Os dois botões ao lado do prazo mudam o prazo daquele link. Mudar o prazo rearma a contagem a partir de agora.
- O botão de repetir faz o lembrete voltar a cada prazo até você marcar o link como lido. Desligado, ele avisa uma vez.
- Duas abas, Pendentes e Lidos. A marca de lido move o link de aba. A lixeira apaga de vez. Na aba dos lidos há um botão que devolve o link para a lista com o lembrete rearmado.
- O lembrete é uma notificação do sistema que abre a página no clique. Um lembrete que venceu com o app fechado é entregue na abertura seguinte.

**Salvar de fora do app.** Com «Perguntar quando eu copiar um link» ligado, copiar um endereço faz o cartão aparecer ao lado do ícone com a pergunta «Salvar para ler depois?» e dois botões. Ele fica três segundos. Com um link selecionado em qualquer app, o menu do botão direito › Serviços também salva.

**Exportar e importar.** Ficam no cartão do módulo em Configurações › Módulos. A importação também aceita uma lista simples de endereços, um por linha. O que chega por importação começa a contar o prazo a partir de agora.

**O arco.** Ele mostra o quanto da lista já foi lido.

### CPU, GPU, Memória, Rede e Armazenamento

Cinco módulos independentes, um arco cada.

| Módulo | O arco mostra | Amarelo em | Vermelho em |
| --- | --- | --- | --- |
| CPU | Percentual em uso, com a divisão entre apps e sistema, e os processos mais pesados | 70% | 85% |
| GPU | Percentual de uso | 70% | 85% |
| Memória | Fração em uso, e a pressão que o kernel relata | pressão alta | pressão crítica |
| Armazenamento | Fração ocupada do volume | 80% | 90% |
| Rede | A taxa do sentido mais movimentado, como `↓1,2M`. Não tem arco, porque não é fração de nada | | |

CPU e GPU mostram o nome no lugar do ícone. A memória não usa a fração para decidir a cor, porque encher a memória é o que um Mac faz com ela.

Um relógio só amostra os cinco a cada 3 segundos, fora da thread principal. A lista de processos é relida a cada 9 segundos. Com os cinco desligados, nada é amostrado.

## Plugins

Um plugin é um módulo que você monta. Ele lê um endereço, um programa ou um script, desenha a resposta no ícone e no cartão, e oferece botões que fazem alguma coisa. O plugin é guardado em `plugins.json` e circula por copiar e colar.

> [!NOTE]
> Este capítulo é sobre usar plugins no app. A especificação do arquivo, chave por chave, está na aba [Manifesto](/manifesto).

### Criar um plugin

Configurações › Plugins › **Novo plugin**. O editor ocupa a janela inteira e tem quatro passos: **Dados**, **Ícone**, **Detalhes** e **Notificações**. Nenhum deles pede que você decida nada antes de ver o dado de verdade na tela.

**Dados: de onde vem a informação.** Pode ser um endereço na internet, um programa do seu Mac ou um script. Pode também não vir de lugar nenhum: nesse caso o plugin é um painel de botões, ou mostra um texto que você mesmo escreve.

Clique em **Verificar** para ler a fonte uma vez. Se ela pedir um token, ligue **Usa token**, cole no campo e leia de novo. O token fica onde você escolheu em Configurações › Geral › Segredos e nunca entra no arquivo do plugin.

No mesmo passo ficam o intervalo de leitura, o formato da resposta quando ela não é JSON, as páginas seguintes de uma lista e as **Variáveis a ser preenchidas ao instalar o plugin**: os campos que quem instalar o seu plugin vai preencher, como um repositório ou um token.

Com a resposta na tela, a coluna da esquerda sugere um começo, e o editor monta um rascunho já preenchido:

| Começo | O que ele monta |
| --- | --- |
| Lista | Cada item vira uma linha. O ícone mostra a contagem. |
| Abas com listas | Uma aba para cada lista da resposta. |
| Um número | Um valor no ícone, com rótulo. Sem lista. |
| Um botão | Sem cartão. O clique roda e a resposta aparece no ícone. |

**Ícone: o que fica na borda.** Um símbolo, uma palavra ou uma imagem dentro do ícone, o rótulo abaixo dele, o que o anel em volta mostra (um arco, um número, uma cor de status ou um gráfico pequeno) e o que o clique faz: ler de novo, ou rodar o plugin como um botão.

**Detalhes: o cartão.** O topo do cartão tem título, uma linha menor, um número à direita e os botões do topo. Abaixo vêm os componentes, desenhados de cima para baixo. **Adicionar componente** abre a galeria com os catorze tipos, e os que combinam com a sua resposta aparecem marcados.

**Notificações: quando chamar você.** Nunca, quando aparece uma linha nova, ou quando um número passa de um limite. **Ver como avisa** mostra o ícone saltando.

**Escolher um campo.** O editor tem três colunas: à esquerda a resposta, no meio o cartão desenhado com os dados de verdade, à direita o passo em questão. Todo campo de texto tem um **+** ao lado: clique nele e depois no valor, na coluna da esquerda. Arrastar o valor até o campo, ou até o cartão, também funciona. Clicar em qualquer parte do cartão abre o campo que a produziu.

Cada valor escolhido vira uma ficha no campo, com o valor de agora à mostra. Clique na ficha para escolher como ele aparece: arredondado, em percentual, em tempo relativo, como data, como dinheiro.

### Os componentes do cartão

| Componente | O que mostra |
| --- | --- |
| Destaque | Um número importante, a variação e a distância até a meta. |
| Tendência | Como um valor se moveu ao longo do tempo, em linha, área ou barras. |
| Mapa de calor | Intensidade por dia e hora, ou por dia do mês. |
| Etapas | Uma contagem por etapa, na ordem. Um clique filtra a lista. |
| Distribuição | Como os itens de uma lista se dividem entre grupos, em barra, funil ou lista. |
| Grade de status | Muitos itens de uma vez, cada um bem ou não. |
| Linha do tempo | O que aconteceu e o que vem, por data. |
| Tabela | Colunas de valores curtos, com imagem, status ou botão por linha. |
| Texto | Um parágrafo para ler, com um botão de copiar. |
| Lista | Os itens de uma lista, cada um montado com textos, imagens, ícones, botões e indicadores. |
| Botões | Um painel de botões, cada um rodando alguma coisa. |
| Propriedades | Pares de nome e valor, com botões ao lado de cada um. |
| Controles | Interruptores e níveis, direto no cartão. |
| Abas | Abas no topo. Cada aba mostra um ou mais componentes do cartão. |

Quase todo componente pode ocupar meia largura, e dois componentes de meia largura dividem a mesma linha. A Lista, o Mapa de calor e as Abas ocupam sempre a largura toda. O cartão mostra uma Lista por vez: para ter várias, ponha cada uma numa aba.

### Os botões

Um botão pode ficar no topo do cartão, em cada linha de uma lista, num painel de botões, numa coluna de tabela, ao lado de uma propriedade ou por trás de um controle. Ele chama um endereço, roda um programa ou um script, ou faz algo no Mac: copia um texto, abre um link ou um app, manda uma notificação, toca um som, roda um Atalho, guarda um valor ou um link em Ler mais tarde.

O editor do botão segue a ordem em que ele roda: como aparece, o que roda, o que pergunta antes, o que diz enquanto roda, o que mostra quando volta e o que faz conforme a resposta. Quando dá certo, o plugin lê a fonte de novo e redesenha o ícone e o cartão.

**Testar.** O botão **Rodar** chama o serviço de verdade. O botão **Ver como falha** mostra como o cartão fica quando a chamada não dá certo.

### Começar de um exemplo

Configurações › Plugins › **Ver plugins prontos** abre o catálogo no navegador. Clique em **Instalar** no plugin que você quiser, ou baixe o arquivo e importe no Peek.

O catálogo vem dividido em treze categorias: produtividade, desenvolvimento, infraestrutura, gestão, finanças, investimentos, vendas, marketing, atendimento, casa, notícias e leitura, clima e ciência, e mídia.

### Importar

Configurações › Plugins › **Importar…** abre uma janela de arquivo. Cancelar a janela usa o que está na área de transferência. Arrastar um arquivo `.json` para a lista também importa.

Um link `peek://install?url=` seguido do endereço do arquivo instala direto: é o que o botão **Instalar** do catálogo faz.

Importar um plugin que já está instalado cria uma cópia ao lado da que existe.

### A tela de instalação

Todo plugin que vem de fora abre primeiro no editor, com uma prévia do cartão. Quando ele precisa de algo que só você tem, como um token, a prévia usa dados de exemplo. Veja como ele fica, ajuste se quiser e clique em **Instalar**. Se faltar alguma informação, ela é pedida ali.

Um plugin que vem de fora diz tudo o que faz antes de entrar:

- o que ele lê e com que frequência;
- se ele roda algum programa ou script no seu Mac, com o conteúdo à vista;
- quais botões ele tem, e quais rodam sem perguntar;
- o que ele precisa que você preencha;
- se ele usa a internet e se pede um token;
- se ele lê algo do momento, como o que você copiou ou a página aberta no navegador;
- os apps que ele abre e os Atalhos que roda;
- as permissões que o macOS pode pedir.

O botão **Ver arquivo** mostra o arquivo inteiro antes de instalar.

> [!WARNING]
> Um plugin reimportado com botões que a cópia instalada não tem pergunta de novo e diz quais são. Leia antes de confirmar.

### Compartilhar

Abra o plugin no editor e use **Arquivo › Copiar**, ou clique com o botão direito na linha do plugin e escolha Compartilhar. O token e o que você preencheu não vão junto.

### O histórico

Toda execução de botão fica no histórico do plugin, com horário, gatilho, resultado e o erro real. O app guarda as 60 últimas de cada plugin.

### Apagar

A lixeira na linha do plugin.

> [!CAUTION]
> O plugin e todos os dados dele são excluídos, e não dá para desfazer.

## A janela de Configurações

Três formas de abrir: o orbe na ponta da faixa, a linha Configurações no menu da barra de menus, ou ⌘ e vírgula com o app na frente.

A barra lateral tem nove seções. O nome de cada uma aparece ao lado quando o ponteiro passa. O botão de energia no pé da barra fecha o app.

## Configurações › Módulos

A lista dos módulos instalados. Cada linha tem o ícone, o nome e o menu com os quatro lugares. Arraste uma linha para mudar a ordem na faixa.

Um módulo tem cartão próprio abaixo da lista, porque tem mais o que dizer:

- **Ler mais tarde**: o prazo padrão dos links novos, o interruptor de repetir o lembrete, o interruptor de perguntar quando você copia um link, e os botões de exportar e importar.

## Configurações › Plugins

A lista dos plugins instalados, com os botões **Ver plugins prontos**, **Importar…** e **Novo plugin**. Cada linha diz de onde o plugin lê e com que frequência. A lixeira apaga.

Veja [Plugins](#plugins).

## Configurações › Variáveis

Um valor que você escreve uma vez e reaproveita em qualquer plugin: a sua cidade, o seu usuário, um limite que você gosta de usar.

Cada variável tem um nome, um rótulo e um tipo: texto, número, sim ou não, uma escolha entre poucas opções, uma lista de linhas, ou um token. O botão de copiar ao lado de cada uma deixa ela pronta para colar num campo de plugin.

> [!NOTE]
> Um token nunca viaja num arquivo de plugin nem num backup.

## Configurações › Aparência

### Dock

| Ajuste | Opções |
| --- | --- |
| **Mostrar** | **Sempre mostrar**: a faixa fica aberta com tudo visível. **Mostrar ao passar o mouse**: uma pílula na borda, que abre quando o ponteiro chega. **Ocultar**: nada na tela. |

O Dock é desenhado em Liquid Glass, o vidro do sistema, que segue a aparência do Mac. Ele precisa de macOS 26; em versões anteriores o Dock fica preto sólido.

Com a faixa em **Ocultar**, o ícone na barra de menus continua abrindo as Configurações.

### Estilo

Duas silhuetas. As duas mantêm as quatro bordas, o hover, a seção oculta, o salto de atenção e o cartão.

| Estilo | O que é |
| --- | --- |
| **Barra** | Um bloco arredondado contra a borda. |
| **Círculos** | Sem moldura: cada ícone é um disco. |

### Cores

Dez temas, cinco escuros e cinco claros: Grafite, Meia-noite, Carvão, Floresta, Ametista, Névoa, Areia, Menta, Papel e Lavanda. O tema decide o ícone, o cartão e a cor de destaque.

### Ícones

A marca de cada módulo fica num círculo ou num quadrado arredondado.

### Posicionamento

| Ajuste | O que faz |
| --- | --- |
| **Tamanho** | De 0,75 a 1,5 do tamanho padrão. |
| **Lugar** | Direita, esquerda, topo ou base. No topo, num Mac com notch de hardware, a faixa assume o formato do notch. |
| **Telas** | Tela principal, ou todas as telas com uma faixa em cada. |
| **Tela** | Com uma faixa só, qual monitor a recebe, ou seguir a janela ativa. |
| **Posição** | Desliza a faixa ao longo da borda. O mesmo que Option e arrastar. |
| **Recentralizar** | Devolve a faixa ao meio da borda. |

A posição é lembrada por borda.

## Configurações › Notificações

### Atenção

- **Abrir o Dock quando um módulo tiver novidade**.
- **Ficar aberto por**: 3, 5 ou 10 segundos.

### Som

- **Tocar um som**.
- **Evento** e **Precisa de atenção**: um som para cada, com botão de prévia ao lado.

### Limiares

Onde o arco de um módulo vira âmbar e onde vira vermelho. O padrão é 50% e 70%.

As métricas do sistema não seguem esses limiares: CPU e GPU avisam em 70% e 85%, armazenamento em 80% e 90%, e memória segue a pressão que o kernel relata.

## Configurações › Teclado

Os atalhos ficam neste Mac. Eles não entram num plugin nem num backup.

| Grupo | O que o atalho faz |
| --- | --- |
| **O app** | Abre a faixa e leva o teclado para dentro dela. |
| **Módulos** | Abre o cartão daquele módulo direto. |
| **Botões de plugin** | Roda o botão sem abrir o cartão. Ele continua perguntando o que perguntaria. |

Clique no campo, aperte as teclas, e pronto. O `x` ao lado limpa. Um atalho já usado por outra linha aparece marcado como «Ocupado».

### Navegar pelo teclado

Aberto pelo teclado, o painel vira janela principal.

| Tecla | O que faz |
| --- | --- |
| Setas | Andam pelos ícones e pelas abas. |
| Tab e Shift-Tab | Percorrem os botões e as linhas do cartão. |
| Return ou Espaço | Abre a linha ou roda o botão. |
| ⌘ e um número | Roda o botão daquela posição. |
| Esc | Volta para o ícone, e de novo devolve o teclado ao app anterior. |

## Configurações › Energia

### Agora

O estado atual: se o Mac está na tomada, na bateria ou em Pouca Energia, se há rede, e se um Modo de Foco do macOS está ligado. Quando o Peek não consegue ler o Foco, a linha traz um botão que abre os Ajustes do Sistema.

### Economia

**Esperar mais longe da tomada** multiplica o intervalo de cada módulo.

| Situação | Padrão | Opções |
| --- | --- | --- |
| Na tomada | Sem espera extra | Fixo |
| Na bateria | 2× mais longo | 1×, 1,5×, 2×, 3×, 4×, 6× |
| Pouca Energia | 4× mais longo | 1×, 1,5×, 2×, 3×, 4×, 6× |

Além disso, e sempre:

- Nada é lido com a tela apagada.
- O que depende de rede espera a rede voltar.
- Um serviço que pede calma é respeitado: o Peek espera antes de tentar de novo.

### Por módulo

A lista mostra, para cada módulo ligado, o intervalo em vigor e como ele vem se saindo. O interruptor mantém aquele módulo no intervalo próprio, sem multiplicação.

## Configurações › Geral

| Seção | O que tem |
| --- | --- |
| **Iniciar** | Abrir ao fazer login. |
| **Idioma** | Seguir o sistema, ou um dos onze idiomas do app. |
| **Backup** | Exportar e importar um arquivo com tudo. |
| **Introdução** | Mostrar a introdução de novo. |
| **Segredos** | Onde os segredos ficam: Chaves do Mac ou arquivo na pasta do app. Trocar move os que já existem. |
| **Sincronização** | Manter plugins, respostas e ordem iguais entre Macs, pelo iCloud Drive. |
| **Atualizações** | Verificar a cada dois dias se há versão nova, e verificar agora. Quando há, um ícone pisca no fim do Dock, e o botão Baixar abre o download. Instale arrastando o Peek para Aplicativos. |

### Backup

**Exportar** grava um arquivo com os seus plugins, o que você preencheu neles e os ajustes do app. Tokens e atalhos não vão nele.

**Importar** mostra a lista antes de instalar. Para cada plugin que já existe, você escolhe manter, substituir ou criar uma cópia.

### Sincronização

Ligue e os seus plugins, o que você preencheu neles e a ordem da faixa passam a acompanhar você entre os seus Macs, pelo iCloud Drive. Tokens não sincronizam. A borda e a posição da faixa também não, porque cada Mac tem a própria tela.

Se o iCloud Drive estiver desligado, a linha avisa.

## Configurações › Licença

O estado do teste ou da licença e o campo para colar a chave.

| Linha | O que mostra |
| --- | --- |
| **Status** | Teste com os dias que faltam, teste encerrado, ou comprado. |
| **Chave** | O campo para colar a chave que chegou por e-mail, e o botão Desbloquear. |
| **Desativar neste Mac** | Libera a chave para ser usada em outro Mac. |

Veja [Teste e licença](#teste-e-licença).

## Onde ficam os dados

Tudo o que o app guarda fica numa pasta só, dentro da sua Biblioteca:

```
~/Library/Application Support/Peek/
```

Plugins, tarefas, links, blogs e os ajustes do app moram ali. Para levar tudo para outro Mac, use Configurações › Geral › Backup em vez de copiar a pasta na mão.

> [!CAUTION]
> O comando abaixo apaga tudo o que o Peek guardou neste Mac, sem volta.

```sh
rm -rf ~/Library/Application\ Support/Peek
```

## O que sai do seu Mac

O que sai do Mac é isto:

- **Os módulos que leem a rede**: notícias, ler mais tarde e os plugins que você instalou. Cada um fala com o serviço que está configurado nele, e com mais nada.
- **A sincronização pelo iCloud Drive**, se você ligar. O arquivo fica na sua conta do iCloud.
- **A licença**: o app fala com o nosso servidor para ativar e verificar a chave. Guardamos o e-mail da compra, o pedido e um identificador do Mac.
- **A verificação de versão nova**, a cada dois dias.
- **Uso e falhas**, pelo Firebase: as telas que você abre, os botões que usa e relatórios de falha. Sem tarefas, links, tokens nem o que os plugins leem.

Os seus tokens ficam onde você escolheu em Configurações › Geral › Segredos: nas Chaves do Mac ou num arquivo do app. Eles não entram no arquivo do plugin, no backup nem na sincronização, então compartilhar um plugin nunca compartilha um token.

Antes de instalar qualquer plugin, o app mostra tudo o que ele alcança.

## Quando algo não funciona

| Sintoma | O que fazer |
| --- | --- |
| A faixa não aparece | Veja Aparência › Dock › Mostrar. Em **Ocultar**, nada é desenhado. Em **Mostrar ao passar o mouse**, leve o ponteiro até a borda escolhida em Posicionamento › Lugar. |
| A faixa está fora de lugar | Aparência › Posicionamento › Recentralizar. |
| O cartão não abre | Deixe o ponteiro parado sobre o ícone por meio segundo. Atravessar a faixa não abre nada. |
| Um módulo mostra um valor antigo | O ícone mostra a última leitura boa quando a leitura nova falha. Clique no ícone para ler de novo. |
| Nada é lido | Veja Energia › Agora. Sem rede, só o que vive no Mac é lido. Com a tela apagada, nada é lido. |
| Os alertas não chegam na hora | Enquanto um Modo de Foco do macOS está ligado, eles ficam guardados e saem quando o foco termina. |
| Não chega notificação nenhuma | Ajustes do Sistema › Notificações, e autorize o Peek. |
| Um script de plugin não roda | Ajustes do Sistema › Privacidade e Segurança › Automação, e ligue o Peek. |
| Um plugin parou depois de muitas leituras | O serviço pediu calma e o Peek está esperando. Aumente o intervalo do plugin. |
| «Abrir ao fazer login» volta sozinho para desligado | Mova o app para a pasta Aplicativos e tente de novo. |