Windows 10/11As tuas predefiniçõesSaída JSON

A linha de comandos do filee

Converte ficheiros a partir da Linha de Comandos, do PowerShell ou dos teus próprios scripts, com os mesmos motores e predefinições da aplicação, ou deixa uma pasta converter tudo o que lá chegar. Tudo fica no teu computador.

Escolhe uma transferência Ver os comandos

D:\Photos> filee convert *.heic --to jpg
ok    IMG_0412.heic -> IMG_0412.jpg
ok    IMG_0413.heic -> IMG_0413.jpg
ok    IMG_0414.heic -> IMG_0414.jpg
Converted 3 of 3 file(s).

Configura o comando filee

1
Deixa a opção selecionada no instalador
Na página de opções do instalador do Filee, deixa Adicionar o comando «filee» ao PATH selecionado (vem ativado de origem). Já tens o Filee instalado? Volta a executar o instalador mais recente.
2
Abre um terminal novo
Abre uma nova janela da Linha de Comandos, do PowerShell ou do Terminal do Windows (uma janela que já estava aberta não vê o novo PATH) e executa filee version.
3
Versão portátil ou sem PATH
Está tudo na pasta do Filee: executa lá o filee-cli.exe ou adiciona tu mesmo a pasta cli ao PATH. A aplicação não precisa de estar aberta.

Início rápido

Indica nomes de ficheiros, carateres universais como *.heic ou pastas inteiras. Os resultados são guardados junto aos originais, a menos que acrescentes -o.

Uma fotografia para JPG
```
filee convert photo.heic --to jpg
```

Todos os PNG para WebP com qualidade 80, numa só pasta

filee convert *.png --to webp --quality 80 -o converted

Uma pasta e as suas subpastas com uma predefinição
```
filee convert D:\Scans --recursive --preset to-pdf
```

Uma pasta de entrada que produz PDF

filee watch D:\Inbox --to pdf --move-originals

Para que formatos pode o HEIC ser convertido?
```
filee formats heic
```
As tuas predefinições, por id e nome
```
filee presets
```

Comandos

`filee convert`

filee convert <files or folders...> (--to <format> | --preset <preset>) [options]

Converte ficheiros, carateres universais (*.heic) e pastas. Numa pasta, são convertidos os ficheiros que o Filee conhece; acrescenta -r para incluir as subpastas. Indica um formato de destino ou uma das tuas predefinições.

Opções

`-t, --to <format>`	Formato de destino por id ou extensão: jpg, png, webp, pdf, docx, hwpx, mp4, mp3… (vê `filee formats`)
`-p, --preset <preset>`	Uma predefinição da aplicação, por id ou por nome (vê `filee presets`)
`-o, --output <folder>`	Guardar aí em vez de junto aos originais
`-r, --recursive`	Incluir subpastas
`-q, --quality <1-100>`	Qualidade de imagem para JPG, WebP, AVIF e outros formatos com perdas
`--overwrite`	Substituir os ficheiros de saída existentes (por omissão, é acrescentado um número ao novo nome)
`--skip`	Não mexer nos ficheiros de saída existentes
`--keep-dates`	Dar aos ficheiros convertidos as datas de criação e modificação dos originais
`--json`	Mostrar o resultado como um único documento JSON, para scripts
`--quiet`	Não mostrar nada além dos erros

`filee watch`

filee watch <folder> (--to <format> | --preset <preset>) [options]

Converte cada ficheiro que chega à pasta até premires Ctrl+C. Os ficheiros convertidos vão para uma pasta converted dentro dela, a menos que acrescentes -o.

Opções

`-t, --to <format>`	Formato de destino
`-p, --preset <preset>`	Uma predefinição da aplicação, por id ou por nome
`-o, --output <folder>`	Para onde vão os ficheiros convertidos (por omissão: `<folder>\converted`)
`-r, --recursive`	Monitorizar também as subpastas (os ficheiros destas mantêm a subpasta na saída)
`--move-originals`	Mover cada original convertido para `<folder>\originals` e, ao iniciar, converter os ficheiros que já estiverem à espera na pasta
`--settle <seconds>`	Durante quanto tempo um ficheiro tem de ficar sem alterações antes de ser convertido (por omissão: 2)
`--keep-dates`	Dar aos ficheiros convertidos as datas de criação e modificação dos originais
`--quiet`	Não mostrar nada além dos erros

`filee formats`

filee formats [<format>]

Lista todos os formatos com o id e as extensões de cada um, ou os formatos para que um formato converte, incluindo o que um motor opcional acrescentaria.

`filee presets`

filee presets

Lista as predefinições integradas e as que criaste na aplicação, com id, nome e formato de destino.

`filee help`

filee help [<command>]
filee version

Mostra como usar todos os comandos ou um deles, e a versão instalada.

Pastas monitorizadas

Deixa uma pasta converter tudo o que lá colocares: transferências, digitalizações, exportações de outras aplicações.

Os ficheiros são convertidos quando estão completos: deixaram de crescer e não estão abertos noutro programa. Assim, as transferências e as cópias demoradas não dão problemas.
Os ficheiros temporários e ocultos (.crdownload, .part, .tmp, ficheiros ~$) e os formatos que o Filee não conhece são ignorados.
Os ficheiros convertidos vão para uma pasta converted dentro da pasta monitorizada, ou para onde -o indicar. Com -r, os ficheiros das subpastas mantêm lá a subpasta (2025\a.png → converted\2025\a.pdf).
Com --move-originals, cada original convertido vai para originals, pelo que a pasta funciona como uma caixa de entrada. Os ficheiros que já lá estiverem à espera são convertidos ao iniciar.

Ou na aplicação, em segundo plano

A página Pastas monitorizadas do Filee faz o mesmo sem terminal: adiciona pastas, escolhe uma predefinição para cada uma e os ficheiros são convertidos enquanto o Filee está em execução na área de notificação.

D:\Inbox> filee watch . --to pdf --move-originals
Watching D:\Inbox → PDF, saving to D:\Inbox\converted. Press Ctrl+C to stop.
ok    scan-0412.jpg -> converted\scan-0412.pdf

Usar em scripts

--json mostra um único documento JSON com o resultado de cada ficheiro, e o código de saída diz ao teu script como correu.

`--json`

{
  "preset": "WEBP",
  "target": "webp",
  "converted": 2,
  "skipped": 0,
  "failed": 1,
  "files": [
    {
      "source": "D:\\Exports\\cover.png",
      "state": "done",
      "outputs": [ "D:\\Exports\\cover.webp" ]
    },
    {
      "source": "D:\\Exports\\broken.png",
      "state": "failed",
      "outputs": [],
      "error": "The engine reported an error (improper image header)"
    }
  ]
}

Códigos de saída

`0`	Nada falhou
`1`	Alguns ficheiros falharam (os outros foram convertidos)
`2`	Argumentos errados, formato ou predefinição desconhecidos, ou entrada em falta
`3`	Nada para converter

Exemplo no PowerShell

$result = filee convert D:\Exports\*.png --to webp --json | Out-String | ConvertFrom-Json
if ($LASTEXITCODE -eq 1) {
  $result.files | Where-Object state -eq 'failed' | ForEach-Object { "$($_.source): $($_.error)" }
}

Bom saber

Os mesmos motores e predefinições da aplicação: uma predefinição que crias ou alteras no Filee funciona logo com --preset, por id ou por nome.
Os motores opcionais (FFmpeg, LibreOffice…) são instalados na aplicação, em Definições → Motores. filee formats <format> mostra que conversões precisam de um deles.
O próprio filee expande os carateres universais, pelo que *.heic funciona tanto na Linha de Comandos como no PowerShell. Coloca entre aspas os caminhos com espaços.
Nada é enviado e não é preciso Internet: os ficheiros são convertidos no teu computador, tal como na aplicação.
As mensagens estão em inglês, para que os scripts e os registos fiquem iguais em qualquer computador.

Descarrega o Filee com o comando filee

A linha de comandos vem com o Filee para Windows 10/11: gratuito, de código aberto e offline.

Descarregar para Windows

O macOS está em pré-visualização. O Linux requer o Ubuntu 22.04 ou posterior; os gestos de arrastar precisam do X11 (experimental no KDE Plasma com Wayland).

Todas as versões Código-fonte

A linha de comandos do filee

Deixa a opção selecionada no instalador

Abre um terminal novo

Versão portátil ou sem PATH

Uma fotografia para JPG

Todos os PNG para WebP com qualidade 80, numa só pasta

Uma pasta e as suas subpastas com uma predefinição

Uma pasta de entrada que produz PDF

Para que formatos pode o HEIC ser convertido?

As tuas predefinições, por id e nome

filee convert

Opções

filee watch

Opções

filee formats

filee presets

filee help

Pastas monitorizadas

Ou na aplicação, em segundo plano

--json

Códigos de saída

Exemplo no PowerShell

Bom saber

Descarrega o Filee com o comando filee

`filee convert`

`filee watch`

`filee formats`

`filee presets`

`filee help`

`--json`