Como o PrimoDock funciona

O PrimoDock desenha a própria barra de Dock e esconde a do macOS. Nada é apagado: o Dock do macOS volta quando você desliga o Dock do PrimoDock ou fecha o app.

A barra funciona como o Dock que você já conhece (apps fixados, apps abertos, pastas, Downloads, Lixeira), com duas coisas a mais:

• Ambientes. Cada ambiente tem o seu Dock: seus apps fixados, suas pastas, seus widgets. As janelas abertas num ambiente saem da frente quando você troca e voltam quando você volta.
• Widgets. Tiles vivos dentro da barra: relógio, calendário, timer, clima, bateria, GitHub e mais. Clicar num widget abre um painel com os detalhes.

Onde ele mora

O PrimoDock não tem ícone no Dock nem aparece no ⌘Tab. Ele mora na barra de menus, no ícone de Dock perto do relógio. Esse menu tem:

• a lista de ambientes, com um ✓ no atual e o atalho de cada um;
• Novo workspace…, Editar workspaces… e Widgets…;
• Buscar atualizações…, Sobre o PrimoDock, Ajustes… (⌘,) e Encerrar PrimoDock (⌘Q).

Enquanto a janela de Ajustes está aberta, o PrimoDock vira um app normal: aparece no ⌘Tab e ganha um ícone na barra. Nessa janela, ⌘Q fecha só a janela, não o app.

Nos menus e nos Ajustes, o app ainda chama os ambientes de workspaces. É a mesma coisa: este guia diz "ambiente" no texto e cita os rótulos exatamente como aparecem na tela.

A primeira vez

Na primeira abertura, o PrimoDock cria um ambiente chamado Default com uma cópia do seu Dock atual e mostra uma apresentação curta. Nela você escolhe:

• Usar o Dock do PrimoDock (ligado por padrão);
• o que fazer com o Dock do macOS: Oculto, Ocultar automaticamente (padrão) ou Sem mudança;
• Ocultar e mostrar automaticamente a barra do PrimoDock (começa igual ao que o Dock do macOS já fazia);
• Abrir ao iniciar sessão (desligado por padrão).

Dá para rever a apresentação em Ajustes › Sobre › Rever a apresentação….

Voltar ao Dock do macOS

Três jeitos, do mais leve ao mais forte:

1. Encerre o PrimoDock pela barra de menus. O Dock do macOS volta.
2. Em Ajustes › Geral, desligue Usar o Dock do PrimoDock. Nesse modo, o PrimoDock só troca os ícones fixados do Dock do macOS a cada ambiente.
3. Em Ajustes › Geral › Zona de perigo, use Restaurar o Dock do macOS ou Redefinir o auto-ocultar do Dock do macOS.

Cada ambiente guarda os seus apps fixados e a ordem deles, as suas pastas, arquivos e links e os seus widgets. Os apps que você abre pertencem ao ambiente onde foram abertos: com Só apps da mesa atual ligado (padrão), a barra mostra só os daquele ambiente.

Criar

1. Na barra de menus, escolha Novo workspace… (ou o + embaixo da lista em Ajustes › Workspaces).
2. Dê um nome e escolha uma Cor: Azul, Rosa, Laranja, Verde, Roxo ou Grafite.
3. Clique em Criar. O ambiente novo começa como cópia do seu Dock atual.

Editar

Em Ajustes › Workspaces (ou Editar workspaces… na barra de menus), escolha o ambiente na lista. A página tem:

• nome, Cor e Indicador de apps abertos;
• O Dock deste workspace: uma prévia viva da barra. Arraste um item para reordenar; puxe para fora da barra para remover;
• apps: Adicionar app ou espaçador;
• Pastas, arquivos e links: Arquivo ou pasta… ou uma URL;
• Ativar nas mesas: uma chave para cada Mesa do macOS (Spaces). Ligue quantas quiser; ao ir para qualquer uma delas, o ambiente entra sozinho;
• Atalho: um atalho de teclado só deste ambiente.

Guarde com Salvar (⌘S) ou jogue fora com Descartar. Para apagar um ambiente, use o − embaixo da lista. O último ambiente não pode ser apagado.

Trocar de ambiente

• Na barra de menus, clicando no nome do ambiente.
• No teclado: ⌃⌥1 até ⌃⌥9, na ordem da lista, ou o atalho próprio do ambiente.
• Na barra: deslize dois dedos para o lado no trackpad, ou ⌘ + rolagem, em cima do Dock.
• Botão direito na barra › Workspace (aparece quando há 2 ou mais).
• No teclado, com Próximo workspace e Workspace anterior, que você grava em Ajustes › Geral › Atalhos. Depois do último vem o primeiro.
• Indo para uma Mesa do macOS ligada a um ambiente.
• Com Seletor de workspace no Dock ligado em Ajustes › Geral, a barra ganha uma bolinha colorida por ambiente.

Um Dock em cada monitor

Com Em todos os monitores ligado em Ajustes › Geral, cada monitor ganha a sua barra, e cada barra guarda o seu ambiente. Trocar de ambiente muda só o monitor em que você está, e clicar na barra de outro monitor faz do ambiente dela o ativo. Um monitor que vai para uma Mesa ligada a um ambiente passa a mostrar esse ambiente. Trocar num monitor nunca esconde os apps do ambiente que aparece no outro. Desligado, há uma barra só, que segue o ponteiro como a do macOS.

Backup

O PrimoDock guarda uma cópia dos seus ambientes toda vez que abre e fecha. Em Ajustes › Backups, escolha uma para ver e use Restaurar…. Para levar tudo para outro Mac, use Ajustes › Geral › Backup dos workspaces, com Exportar… e Importar….

Apps

Os apps fixados vêm primeiro; os abertos que não estão fixados aparecem depois de um separador (Mostrar apps abertos). Passar o mouse num app aberto mostra prévias das janelas. Para fixar, arraste o app para a barra; para tirar, puxe para fora.

O botão direito num app tem Opções (Manter no Dock, Remover do Dock, Mostrar no Finder, Atribuir a), Criar coleção, Mostrar todas as janelas, Ocultar (com ⌥, vira Ocultar outros), Encerrar e Forçar encerramento.

Em Opções › Atribuir a, escolha onde as janelas do app abrem: Todas as mesas, uma Mesa do macOS ou Nenhum, como no Dock do macOS. Cada Mesa aparece com o nome do ambiente ligado a ela. A escolha fica guardada no mesmo lugar que a do Dock do macOS, então os dois concordam.

Pastas e Downloads

Clicar numa pasta abre uma pilha. O botão direito tem Ver como (Grade ou Lista), Ordenar por (Nome, Tipo, Data de adição), Cor, Abrir no Finder e Remover do Dock. A pilha de Downloads mostra quantos arquivos novos chegaram.

Lixeira

Solte arquivos nela para apagar, ou arraste um item do Dock até ela para tirá-lo da barra. O botão direito tem Esvaziar Lixeira. Para o ícone mostrar quando a Lixeira tem algo, o PrimoDock precisa de Acesso Total ao Disco.

Espaçadores

Botão direito na barra › Adicionar espaçador pequeno ou Adicionar espaçador grande. Também em Ajustes › Espaçadores. Para tirar, botão direito no espaçador › Remover espaçador.

O menu da barra

O botão direito num espaço vazio da barra tem: os espaçadores, Ocultar automaticamente, Efeito ao passar o mouse (Nenhum, Escala, Ampliação), Mostrar apps abertos, Workspace, Widgets… e Ajustes do Dock….

Drop Zone

Ao arrastar arquivos, uma bandeja de vidro aparece no canto inferior esquerdo para você soltá-los ali. Se você tem o widget Prateleira, os arquivos vão para ele. Liga e desliga em Ajustes › Utilitários.

Pelo teclado

⌃⌥D leva o foco para o Dock. Depois, as setas andam pelos itens, Return ou Espaço abrem e Esc sai.

Adicionar

1. Na barra de menus, escolha Widgets… (também está no fim do menu de botão direito de qualquer item do Dock).
2. Em Todos os widgets, procure pelo nome ou navegue pelos grupos.
3. Clique no cartão. O widget é criado e vai direto para o fim do Dock do ambiente atual. Não tem passo extra.

Os widgets que você já adicionou ficam em Em uso, na mesma página.

Configurar

Três caminhos levam ao mesmo lugar:

• botão direito no widget › Editar widget…;
• clique no widget para abrir o painel e use o botão de editar do rodapé (por exemplo, Editar timer…);
• Ajustes › Widgets › Em uso e escolha o widget.

Todo widget tem, além das opções próprias (veja o catálogo):

• Nome;
• Estilo, quando o widget tem mais de um visual (Bateria, Calendário, Clima e outros);
• Largura do tile: de Um ícone a Quatro ícones. Mais largo mostra mais coisa;
• Mostrar nos workspaces: um botão por ambiente. O widget entra no fim do Dock de cada ambiente ligado.

As mudanças aparecem na barra na hora, e a prévia No Dock mostra como vai ficar.

Mover e tirar

• Mover: arraste o widget pela barra.
• Tirar do ambiente: puxe para fora da barra, ou botão direito › Remover do Dock. O widget sai só daquele ambiente e continua existindo.
• Apagar de vez: em Ajustes › Widgets › Em uso, botão direito › Apagar, ou o −.

Pilhas de widgets

Uma pilha põe vários widgets no mesmo lugar da barra, e você troca entre eles rolando.

1. Botão direito num widget › Empilhar com › escolha outro widget. Só aparecem os que têm a mesma largura e já estão no ambiente.
2. Para ver o próximo, role em cima da pilha: um passo da roda do mouse ou um deslize no trackpad passa um widget, e no fim volta ao primeiro. Os pontinhos ao lado mostram onde você está.
3. No botão direito da pilha: Adicionar à pilha, Subir na pilha, Descer na pilha, Tirar da pilha e Desfazer a pilha.

Mudar a largura de um widget da pilha muda a de todos. Puxar a pilha para fora da barra tira todos os widgets dela do ambiente.

O clique

Clicar num widget abre o painel dele. Cinco exceções: o Atalho roda o atalho, o AirDrop abre a janela de AirDrop do Finder, o Tocando agora traz o player para a frente, o Ventoinhas alterna entre automático e velocidade máxima e a Trava do teclado trava o teclado (o painel desses três fica no botão direito).

Com o Dock do PrimoDock desligado, os widgets vão para dentro do Dock do macOS. Lá eles são sempre quadrados, cabem no máximo 12 e o clique sempre abre o painel. Pilhas só existem na barra do PrimoDock.

Os ícones que o PrimoDock desenha na barra podem vir de três lugares, nesta ordem: uma imagem escolhida para aquele app, um pacote de ícones (para todos os apps ou só alguns) ou o ícone do próprio app. Nada muda no app em si: o Finder, o Launchpad e o ⌘Tab continuam com o ícone de sempre.

Galeria de ícones

Em Ajustes › Galeria de ícones ficam os pacotes prontos, com um em Destaque no topo. Cada cartão mostra alguns ícones do pacote e uma linha como Cobre 9 dos seus 12 apps: quantos apps do seu Dock ele desenha. Clique no cartão para ver o pacote inteiro e, depois de instalado, como ele fica nos seus apps.

1. Instalar baixa o pacote.
2. Usar no Dock põe o pacote em todos os apps. Os apps que ele não desenha ficam com o ícone original.
3. Com o pacote Em uso, o menu dele tem Parar de usar e Desinstalar.

Pacotes novos chegam sem atualizar o app: o PrimoDock confere a galeria pouco depois de abrir, a cada seis horas e sempre que você abre a página. Os que você ainda não viu ganham a marca Novo e um contador na barra lateral. Quando um pacote instalado é atualizado, a versão nova é baixada sozinha; se não der (sem internet, por exemplo), o cartão mostra Atualizar.

Os pacotes fazem parte da licença e do teste. Com o teste acabado e sem licença, a galeria, o IconStudio e o menu de ícones ficam só para ver: os ícones que já estão em uso continuam lá.

Um ícone para um app só

Botão direito no app › Opções › Ícone. Lá estão Original, cada pacote instalado que tem um ícone para aquele app, Escolher imagem… (PNG, ou o .icns de dentro de outro app) e Abrir pasta de pacotes de ícones. A escolha de um app vale por cima do pacote usado em todos.

Em Ajustes › Aparência › Ícones dos apps, cada pacote instalado aparece num cartão com a prévia nos seus apps e quantos deles ele cobre; clicar num cartão usa aquele pacote em todos.

IconStudio

Em Ajustes › IconStudio você desenha ícones. Escolha o app na fileira do topo (cada um com o nome embaixo) e o que vai no ícone:

Depois, Tamanho e o Fundo: oito combinações prontas ou as cores de Cima e de Embaixo, o Ângulo do degradê e o Brilho. Uma imagem ou um ícone no tamanho máximo cobre o ícone inteiro e é usado como veio, sem fundo. A prévia mostra o ícone grande e no tamanho do Dock, entre os vizinhos dele na barra.

Um ícone desenhado só aparece no Dock depois de salvo, e a barra de baixo diz em que pé ele está (Ainda não salvo, No seu Dock, Em Meus ícones, fora de uso):

• Salvar neste app (⌘S) usa o ícone naquele app.
• Usar este estilo em todos os apps desenha todos os apps do Dock com o mesmo fundo, cada um com as próprias letras. Com um ícone de pacote, o botão vira Usar este pacote em todos os apps e dá a cada app o ícone dele naquele pacote.
• Descartar volta ao que estava salvo; Tirar de Meus ícones apaga o ícone salvo.

Os ícones salvos formam um pacote seu, Meus ícones, que aparece nos menus como qualquer outro. Mudanças não salvas ficam guardadas enquanto o app está aberto, com uma bolinha laranja no app e um contador na barra lateral, e o PrimoDock pergunta antes de você fechar a janela.

Restaurar ícones do sistema…, no topo do IconStudio, devolve o ícone do macOS a todos os apps. Os pacotes e os Meus ícones continuam instalados para você usar de novo; só as imagens escolhidas para um app são apagadas.

Fazer o seu pacote

Um pacote é uma pasta de PNGs dentro de ~/Library/Application Support/PrimoDock/IconPacks (o atalho é Abrir pasta de pacotes de ícones). Cada arquivo tem o nome do app que ele substitui: Spotify.png, visual-studio-code.png ou o identificador do app, como com.spotify.client.png. Maiúsculas, espaços e traços não importam. Um pack.json opcional dá nome ao pacote e liga apps a arquivos com outros nomes:

{ "name": "Neon", "author": "Você", "padding": 0.1,
  "icons": { "Google Chrome": "navegador.png" } }

padding é a margem de cada lado, de 0 a 0,4: os ícones do macOS deixam cerca de um décimo vazio, então um pacote desenhado de ponta a ponta usa 0,1 para ficar do tamanho dos outros. Use PNG de preferência com 1024 px. Depois de mexer na pasta, use Recarregar pacotes em Aparência › Ícones dos apps.

Os pacotes valem para a barra do PrimoDock. Com Usar o Dock do PrimoDock desligado, o Dock do macOS mostra os ícones de sempre.

No Windows

No PrimoDock para Windows (desde a 0.5.0-beta) a Galeria de ícones e o IconStudio ficam em Configurações, com os mesmos pacotes. O botão direito em qualquer app, pasta, Downloads ou Lixeira tem o submenu Ícone, que também aceita ICO, JPG ou o ícone de outro programa, e o próprio botão Iniciar do Dock pode ganhar o ícone do pacote. Os pacotes reconhecem os apps do Windows pelo nome, em português ou inglês: o Edge ganha o ícone de navegador, o Explorador de Arquivos o de arquivos, a Lixeira o de lixeira. No Windows a pasta é %APPDATA%\PrimoDock\IconPacks.

A janela tem uma busca no topo (⌘F) e estas páginas:

Uma dica de tamanho: além do ajuste em Aparência, dá para arrastar o separador da barra para aumentar ou diminuir os ícones, como no Dock do macOS.

Todas ficam em Ajustes › Permissões, com o estado de cada uma: Permitido, Não permitido ou Ainda não pedido. As dos widgets só são pedidas na hora em que você usa o widget.

O PrimoDock não pede localização: o widget de Clima usa a cidade que você escolhe. Redefinir permissões, na mesma página, zera todas e reabre o app.

O teste

São 7 dias contados do primeiro uso, com tudo liberado: nenhum widget ou função fica de fora. Quem começou o teste até 30 de setembro de 2026 ganhou 14 dias. Nos últimos 3 dias, o PrimoDock avisa com notificações (a 3 dias, a 1 dia e no fim) e com uma linha no menu da barra de menus.

Quando o teste acaba, a barra continua na tela, mas cinza e parada, com um cadeado. A troca de ambiente e a Drop Zone param, e o Dock do macOS volta. Seus ambientes, widgets e ajustes ficam onde estavam.

Ativar a licença

1. Abra Ajustes › Licença (ou clique no cadeado da barra).
2. Cole a chave que veio no e-mail da compra, no formato PRIMO-XXXX-XXXX-XXXX.
3. Clique em Ativar. A chave fica guardada neste Mac e funciona sem internet.

Cada chave vale para 2 Macs e inclui um ano de atualizações. Depois desse ano, o app continua funcionando. Para passar a licença para outro Mac, use Desativar este Mac no Mac antigo, ou veja Minha licença.

Atualizações

O PrimoDock procura atualizações sozinho uma vez por dia. Para procurar na hora, use Buscar atualizações… na barra de menus.