---
title: "FinderSidebarIcons — Lab — Ronan Rodrigo Nunes"
description: "Ícone personalizado em qualquer item da sidebar do Finder: uma extensão Finder Sync por pasta, criada pelo CLI sidebar-icon e gerenciada pelo app Manager."
canonical: "https://ronanrodrigo.dev/lab/finder-sidebar-icons"
markdown: "https://ronanrodrigo.dev/lab/finder-sidebar-icons.md"
last-updated: ""
---
# FinderSidebarIcons

_Lab · app e linha de comando para o macOS_

Ícone personalizado em qualquer item da sidebar do Finder: uma extensão Finder Sync por pasta, criada pelo CLI sidebar-icon e gerenciada pelo app Manager.

Stack: macos, swift, finder sync, homebrew, open source

## Instalação

```sh
brew install ronanrodrigo/tap/finder-sidebar-icons
```

Requer as Xcode command line tools (`xcode-select --install`) e uma identidade Apple Development para assinar a extensão (`security find-identity -v -p codesigning`).
A sidebar ignora o ícone personalizado de uma pasta: o que aparece é o ícone do app auxiliar daquela pasta — o mesmo caminho que Dropbox e Google Drive usam.

![Capa do projeto FinderSidebarIcons em pixel art: uma sala ao entardecer com poltrona, dois abajures, estante e uma janela com o sol se pondo.](/lab/finder-sidebar-icons/hero-banner.png)

_Capa do projeto._

## O que ele faz

O Finder não aceita ícone personalizado na sidebar desde o macOS 13. A rota suportada é a das extensões Finder Sync: um app auxiliar minúsculo por pasta, que desenha no item o símbolo escolhido do SF Symbols. É isso que `sidebar-icon add` cria — e o Manager lista, ativa e remove depois.

![A mesma janela do Finder, mesma pasta e mesma visão, em dois quadros: à esquerda, Finder · before, com ícones azuis padrão nos itens da sidebar; à direita, Finder · after, com Developer usando o símbolo </> e Downloads, Pictures e External com ícones próprios. Os nomes das pastas e as tags da sidebar estão desfocados.](/lab/finder-sidebar-icons/screenshot-finder-before-after.png)

_Print real do Finder: a mesma janela antes e depois dos ícones._

![O app FinderSidebarIcons Manager listando quatro ícones da sidebar — Developer, Downloads, Pictures e External — todos com o estado ativo, cada linha com os botões Edit e Remove.](/lab/finder-sidebar-icons/screenshot-manager.png)

_O Manager: o que está instalado, o estado de cada extensão e o reinício do Finder num clique._

## Comandos

O CLI faz o trabalho; o Manager é a interface.

- `sidebar-icon add --name Developer --target "$HOME/Developer" --symbol chevron.left.forwardslash.chevron.right` — cria o app auxiliar da pasta com o símbolo escolhido.
- `sidebar-icon manager` — compila e abre o app Manager.
- `sidebar-icon status` — mostra se cada extensão está ativa.
- `sidebar-icon uninstall` — remove os apps auxiliares e os ícones.

Sem Homebrew, o `Makefile` tem os mesmos passos (`make icon`, `make examples`, `make manager`).

## Onde encontrar o resto

- Repositório: [github.com/ronanrodrigo/finder-sidebar-icons](https://github.com/ronanrodrigo/finder-sidebar-icons) — código, README e licença MIT.
- Lista de comandos e armadilhas de assinatura: [README](https://github.com/ronanrodrigo/finder-sidebar-icons#readme).

Página: [FinderSidebarIcons](/lab/finder-sidebar-icons) · [Voltar ao lab](/lab)