Feather CLI: o Feather no Terminal
Em breve O Feather CLI ainda não saiu. Esta página mostra o que vai fazer; o comando de instalação chega aqui no dia do lançamento.
Feather CLI é a ferramenta de linha de comandos do Feather: o comando feather no Terminal. Reduz fotografias, vídeos, PDF e documentos com o mesmo motor da app, para scripts, pastas inteiras e automatização. Vem com o Feather Pro.
Tudo acontece no teu Mac. O Feather CLI não envia ficheiros, não precisa de conta e não transmite nada para lado nenhum.
O que precisas
- Um Mac com processador Apple e macOS 15 Sequoia ou posterior.
- Feather da Mac App Store, com o Feather Pro neste Mac.
- Homebrew, para o instalar.
Instalar
O Feather CLI ainda não saiu. Será instalado com o Homebrew, e o comando estará nesta página no dia do lançamento.
Depois de instalado, feather pro diz-te se encontra o Feather Pro neste Mac. Se não, abre o Feather e vai a Definições › Feather Pro: compra o Pro aí, ou escolhe Restaurar compra se já o tens.
Experimenta
feather photo.jpg
Isto escreve photo-min.jpg ao lado do original, sem perdas: os píxeis ficam exatamente iguais e os dados privados do ficheiro são removidos (localização, autor, números de série da câmara). Mais alguns:
# cada PNG da secretáriafeather ~/Desktop/*.png# uma pasta e as suas subpastas, ainda mais pequenofeather -m lossy -r ~/Pictures/Export# o formato mais pequeno para cada fotografia, numa pastafeather -m best -o ~/Sites/img ~/Export# o tamanho e o formato que o Instagram mostrafeather -t instagram holiday.jpg# menos de 2 MBfeather --max-size 2mb scan.jpg video.mov# cada imagem para WebPfeather convert --to webp -r ./assets# um vídeo para MP4feather convert --to mp4 clip.mov
feather --help lista todas as opções.
Quanto mais pequeno
| Modo | O que faz |
|---|---|
lossless (a predefinição) | Os mesmos píxeis, ficheiro mais pequeno. Nada do que vês muda. |
lossy | Ainda mais pequeno, com a qualidade que defines com --quality (80 por predefinição). |
best | Experimenta JPEG, PNG, WebP e AVIF (também JPEG XL onde o destino o aceita) e fica com o mais pequeno. |
Para onde vão os ficheiros
-t (--target) prepara os ficheiros para o seu destino. Abrange:
- ferramentas de design: Figma, Miro, Mural, Canva, Notion;
- redes sociais: Instagram, Threads, Facebook, LinkedIn, X, Bluesky, Mastodon, Pinterest, TikTok, Discord;
- finalidades: site, diapositivos, avatar;
- tamanhos de ficheiro: de menos de 500 KB a menos de 100 MB.
feather targets mostra-os todos, com os seus limites. Os teus próprios limites também funcionam: --long-side 2000, --megapixels 12, --max-size 1mb.
Os teus predefinidos
Os predefinidos que criaste no Feather também funcionam no Feather CLI:
- No Feather, vai a Definições › Predefinidos › Exportar predefinidos….
- Guarda o ficheiro como
~/.config/feather/presets.json. - Usa um predefinido pelo nome:
feather -t "Client website" ~/Export
Um ficheiro noutro local funciona com --presets <file>. Volta a exportar depois de alterares um predefinido.
Onde ficam os resultados
- Ao lado do original (a predefinição), com
-minno nome. Altera-o com--suffixe--prefix. - Numa pasta:
-o <folder>, com os nomes originais. - No lugar do original:
--replace. O original é substituído. Só vai para o Lixo quando o ficheiro foi redimensionado, recebeu uma marca de água ou foi convertido para outro formato. Experimenta primeiro o teu comando numa cópia.
Numa pasta, o Feather CLI ignora os ficheiros ocultos e os seus próprios resultados anteriores. Executá-lo duas vezes não volta a comprimir as cópias.
Privacidade
Por predefinição, o Feather CLI remove os dados privados de um ficheiro: localização, autor, dados e números de série da câmara, datas e histórico de edição.
- Para manter os dados da câmara e da exposição, usa
--keep-metadata camera(apenas JPEG: outros formatos não os conseguem guardar). - Para manter tudo, usa
--keep-metadata all.
Para ver o que está dentro de um ficheiro antes de o partilhares:
feather inspect photo.jpg report.pdf
inspect é gratuito e não altera nada.
Marca de água
feather --watermark "© Studio Max Redecker" --position bottom-right ~/Export
feather --logo logo.png --tile ~/Export
Em scripts
--json imprime um documento JSON com cada ficheiro, os seus tamanhos, o que foi removido e onde ficou o resultado:
feather --json -o out ~/Export | jq '.totals'
Códigos de saída:
| Código | Significado |
|---|---|
| 0 | Concluído |
| 1 | Um ou mais ficheiros não puderam ser reduzidos |
| 2 | O comando não estava correto |
| 3 | É necessário o Feather Pro |
| 130 | Parado com Ctrl-C |
O Feather CLI trabalha em, no máximo, quatro fotografias e um vídeo ao mesmo tempo, para nunca usar mais memória do que o teu Mac pode dispensar. Com -j 1 trabalha num ficheiro de cada vez. Ctrl-C para: os ficheiros em curso são terminados ou descartados, e os originais ficam como estavam.
Perguntas
Porque é que o Feather CLI não está na App Store com o Feather?
As apps da App Store correm numa sandbox. Uma ferramenta de linha de comandos numa sandbox não consegue abrir os ficheiros que indicas no Terminal, por isso o Feather CLI é instalado à parte. Estará assinado com o nosso Developer ID e autenticado pela Apple.
Como é que o Feather CLI sabe que tenho o Feather Pro?
Lê o recibo da App Store do Feather neste Mac: verifica a assinatura da Apple e se o recibo pertence a este Mac. Isto acontece offline, e nada é enviado.
Funciona num servidor ou em CI?
De momento, não. O Feather CLI precisa do Feather com o Feather Pro no mesmo Mac.
Funciona num Mac com Intel?
Não. O Feather 2 foi feito para processadores Apple.
Perguntas ou ideias? Contacta-nos através de studiomaxredecker.com.