1. Abrir arquivos
Há quatro caminhos, e todos dão no mesmo lugar:
- Arraste o arquivo para a janela.
- Botão "Abrir arquivo" no canto superior direito, ou
⌘O. - Duplo clique no Finder, se o ProgViewer estiver associado àquele tipo.
- Abertos recentemente, na tela inicial ou em Arquivo → Abrir Recente.
Um arquivo por vez, mas quantas abas você quiser. Arrastar vários de uma vez abre uma aba para cada.
Abrir com o app do sistema
Quando o arquivo não é texto — um PDF, um vídeo, uma imagem — o ProgViewer mostra uma tela dizendo que não exibe aquele formato, com um botão para abrir no app padrão do sistema. Ele recusa executáveis: um arquivo com permissão de execução não é lançado, mesmo que você peça.
2. Abas
- Trocar de aba: clique nela,
⌘1a⌘9para ir direto à N-ésima, ou⌥←/⌥→para circular. - Fechar: o
✕da aba, ou⌘W. - Menu de contexto da aba (botão direito): recarregar do disco, copiar caminho, mostrar no Finder, fechar outras, mover para nova janela.
- Reordenar: arraste a aba pela barra.
- Mover para outra janela: arraste a aba até a outra janela. Soltando fora da barra, ela vira uma janela nova.
Passar o mouse sobre uma aba mostra o caminho completo do arquivo.
Há um teto de 20 abas. Ao passar disso, a aba usada há mais tempo sai sozinha.
3. Ler com conforto
| Recurso | Como |
|---|---|
| Zoom | ⌘+, ⌘−, ⌘0 para voltar a 100%. Ou digite o valor no campo do cabeçalho. |
| Tema | ⚙ → Tema: Sistema, Claro ou Escuro. ⌘⇧L alterna claro/escuro. |
| Tema do código | ⚙ → Tema do código: pode ser diferente do resto do app. |
| Quebra de linha | ⚙ → "Quebrar linhas longas", ou ⌘⇧B. |
Em Sistema, o app acompanha a aparência do macOS ao vivo — mudou lá, muda aqui, sem recarregar.
4. Encontrar o que interessa
Busca
⌘F abre a barra de busca. Enter vai para o próximo resultado, ⇧Enter para o anterior, e
Esc fecha. A contagem aparece ao lado do campo.
A busca atravessa o realce de sintaxe e encontra texto dentro de blocos recolhidos — quando o resultado está dentro de uma dobra, ela se abre para mostrá-lo.
Ir para a linha
Digite :200 na barra de busca para ir direto à linha 200. Não conta como resultado de
busca, e linha inexistente é ignorada em silêncio.
Sumário
Arquivos Markdown ganham um sumário com os títulos, clicável. Ligue ou desligue em ⚙,
com o botão ☰ do cabeçalho, ou com ⌘⇧S.
Dobrar blocos
Em arquivos de código, a coluna de números mostra um gatilho ao lado das linhas que abrem bloco. Clique para recolher.
- Recolher ou expandir tudo: o botão no canto superior esquerdo do bloco, ou
⌘⇧E. - Teclado:
Tabchega à coluna de dobras,↑/↓andam entre elas,EnterouEspaçodobra. - O estado das dobras acompanha a aba: trocar de aba e voltar não desfaz nada.
Copiar um trecho que atravessa uma dobra leva junto o conteúdo escondido.
5. Selecionar e copiar
- Copiar o bloco inteiro: botão Copiar, que aparece ao passar o mouse sobre o bloco.
- Copiar só o trecho marcado: selecione e use Copiar seleção, ou
⌘C. - Selecionar linhas inteiras: clique e arraste na coluna de números.
Os números de linha e os gatilhos de dobra nunca entram no que você copia — eles vivem fora do texto justamente por isso.
6. Imagens e links
Ambos são interruptores em ⚙, e valem para todos os arquivos:
- Mostrar imagens (
⌘⇧I) — desligado, uma imagem em Markdown aparece comoem texto. - Habilitar URL (
⌘⇧U) — desligado, endereços viram texto comum, sem cor nem clique. - Habilitar link em tags (
⌘⇧K) — o mesmo para referências a arquivos.
Imagem local funciona: o ProgViewer lê imagens da pasta do arquivo aberto e de suas subpastas. Imagem remota não é buscada — ela vira um chip com o texto alternativo, e nada sai para a internet.
Clicar num link de arquivo abre-o em nova aba. Clicar num link da web abre o navegador do sistema — a página nunca é carregada dentro do ProgViewer.
7. Visualizar
Alguns formatos ganham um botão Visualizar (⌘⇧V), que mostra o resultado em vez do
código:
| Formato | O que aparece |
|---|---|
.html |
A página renderizada |
.svg |
O desenho |
.css |
Os tokens de cor declarados e uma página de amostra com o CSS aplicado |
.scss .sass .less .styl |
As variáveis declaradas (sem compilar — veja §11) |
A visualização roda isolada, num quadro que não alcança o resto do app.
8. O arquivo mudou no disco
O ProgViewer confere o arquivo aberto a cada 1,5 segundo. Se ele mudou, a tela se atualiza sozinha, preservando a posição de leitura.
- Se o arquivo for apagado ou renomeado, o app avisa uma vez e para de conferir.
- O botão
⟳da aba (ou⌘R) força a releitura e recomeça a sondagem. - Com a janela oculta, a sondagem descansa — ela não bate no disco de fundo.
9. Imprimir
⌘P, o botão 🖨 do cabeçalho, ou Arquivo → Imprimir….
No papel sai só o documento: sem cabeçalho, sem abas, sem busca, sem sumário. Fundo branco, margem de 12 mm, e link externo com a URL impressa ao lado. Blocos dobrados saem inteiros — dobra é recurso de leitura, não corte de conteúdo.
Para gerar um PDF, use PDF → Salvar como PDF no painel de impressão do macOS.
10. Várias janelas
Arquivo → Nova Janela (⌘N) abre outra janela, com seu próprio conjunto de abas. Arraste
abas entre elas.
Em ⚙ → "Abrir arquivos em" você escolhe se um arquivo novo entra como aba ou como janela nova. A escolha vale também para o Finder e para a lista de recentes.
Cada janela guarda posição e tamanho, e volta onde estava ao reabrir o app.
11. Limites conhecidos
Nada aqui é defeito: são escolhas, e todas se anunciam na tela quando agem.
Arquivo grande degrada recurso, não conteúdo.
| Situação | O que muda |
|---|---|
| Linha com mais de 10 mil colunas | O excedente fica atrás de um marcador clicável |
| Arquivo acima de 2 MB | O realce de sintaxe sai |
| JSON acima de 5 MB | Não é reindentado |
| Arquivo com mais de 20 mil linhas | Modo simples: sem numeração, sem dobra, sem realce |
| Arquivo com mais de 500 mil linhas | O excedente não é exibido — é o único teto que corta conteúdo |
| Arquivo acima de 25 MB | Não abre |
No modo simples, recursos que dependem da numeração — ir para a linha, dobrar, selecionar pela coluna — não existem, e dizem isso quando você tenta usá-los.
Pré-processadores de CSS não são compilados. .scss, .sass, .less e .styl mostram
as variáveis declaradas, não o resultado: compilar depende dos @import do projeto, e um
visualizador de um arquivo por vez não tem essa árvore.
Script embutido não executa em arquivo aberto — nem no documento, nem na visualização.
12. Privacidade
- Nada vai para a rede. Nem conteúdo, nem nome de arquivo, nem estatística de uso. O app é lacrado para isso: só consegue falar consigo mesmo.
- Nenhum arquivo é modificado. O ProgViewer só lê.
- O que fica guardado no seu computador são preferências (tema, zoom, interruptores, atalhos) e a lista de arquivos recentes — só os caminhos, nunca o conteúdo.
- Imagem remota não é buscada, então quem hospeda a imagem não fica sabendo que você abriu o arquivo.