Windows 10/11Suas predefiniçõesSaída JSON

A linha de comando do filee

Converta arquivos pelo Prompt de Comando, pelo PowerShell ou pelos seus próprios scripts, com os mesmos motores e predefinições do app, ou deixe uma pasta convertendo tudo o que cair nela. Tudo fica no seu PC.

Escolha um download 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).

Configure o comando filee

1
Deixe marcado no instalador
Na página de opções do instalador do Filee, deixe Adicionar o comando “filee” ao PATH marcado (vem ativado por padrão). Já tem o Filee instalado? Execute de novo o instalador mais recente.
2
Abra um terminal novo
Abra uma nova janela do Prompt de Comando, do PowerShell ou do Terminal do Windows (uma janela que já estava aberta não enxerga o novo PATH) e execute filee version.
3
Versão portátil ou sem PATH
Está tudo na pasta do Filee: execute filee-cli.exe ali ou adicione você mesmo a pasta cli dela ao PATH. O app não precisa estar aberto.

Início rápido

Passe nomes de arquivo, curingas como *.heic ou pastas inteiras. Os resultados são salvos ao lado dos originais, a menos que você adicione -o.

Uma foto 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 suas subpastas com uma predefinição

filee convert D:\Scans --recursive --preset to-pdf

Uma pasta de entrada que gera PDFs

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

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

Comandos

`filee convert`

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

Converte arquivos, curingas (*.heic) e pastas. Numa pasta, são convertidos os arquivos que o Filee conhece; adicione -r para incluir as subpastas. Informe um formato de destino ou uma das suas predefinições.

Opções

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

`filee watch`

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

Converte cada arquivo que cai na pasta até você pressionar Ctrl+C. Os arquivos convertidos vão para uma pasta converted dentro dela, a menos que você adicione -o.

Opções

`-t, --to <format>`	Formato de destino
`-p, --preset <preset>`	Uma predefinição do app, por id ou por nome
`-o, --output <folder>`	Para onde vão os arquivos convertidos (padrão: `<folder>\converted`)
`-r, --recursive`	Monitorar também as subpastas (os arquivos delas mantêm a subpasta na saída)
`--move-originals`	Mover cada original convertido para `<folder>\originals` e, ao iniciar, converter os arquivos que já estiverem esperando na pasta
`--settle <seconds>`	Por quanto tempo um arquivo precisa ficar sem mudanças antes de ser convertido (padrão: 2)
`--keep-dates`	Dar aos arquivos convertidos as datas de criação e modificação dos originais
`--quiet`	Não exibir nada além de erros

`filee formats`

filee formats [<format>]

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

`filee presets`

filee presets

Lista as predefinições integradas e as que você criou no app, 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 monitoradas

Deixe uma pasta converter tudo o que você colocar nela: downloads, digitalizações, exportações de outros apps.

Os arquivos são convertidos quando estão completos: pararam de crescer e não estão abertos em outro programa. Assim, downloads e cópias demoradas não dão problema.
Arquivos temporários e ocultos (.crdownload, .part, .tmp, arquivos ~$) e formatos que o Filee não conhece são ignorados.
Os arquivos convertidos vão para uma pasta converted dentro da pasta monitorada, ou para onde -o indicar. Com -r, os arquivos de subpastas mantêm a subpasta lá (2025\a.png → converted\2025\a.pdf).
Com --move-originals, cada original convertido vai para originals, então a pasta funciona como uma caixa de entrada. Arquivos que já estiverem esperando ali são convertidos ao iniciar.

Ou no app, em segundo plano

A página Pastas monitoradas do Filee faz o mesmo sem terminal: adicione pastas, escolha uma predefinição para cada uma e os arquivos são convertidos enquanto o Filee roda na bandeja.

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

Use em scripts

--json exibe um único documento JSON com o resultado de cada arquivo, e o código de saída diz ao seu script como foi.

`--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 arquivos falharam (os outros foram convertidos)
`2`	Argumentos errados, formato ou predefinição desconhecidos, ou entrada ausente
`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

Mesmos motores e predefinições do app: uma predefinição que você cria ou altera no Filee já funciona com --preset, por id ou por nome.
Os motores opcionais (FFmpeg, LibreOffice…) são instalados no app, em Configurações → Motores. filee formats <format> mostra quais conversões precisam de um deles.
O próprio filee expande os curingas, então *.heic funciona tanto no Prompt de Comando quanto no PowerShell. Coloque entre aspas os caminhos com espaços.
Nada é enviado e não é preciso internet: os arquivos são convertidos no seu PC, como no app.
As mensagens são em inglês, para que scripts e logs fiquem iguais em qualquer PC.

Baixe o Filee com o comando filee

A linha de comando vem com o Filee para Windows 10/11: grátis, de código aberto e offline.

Baixar para Windows

O macOS está em prévia. O Linux requer 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 comando do filee

Deixe marcado no instalador

Abra um terminal novo

Versão portátil ou sem PATH

Uma foto para JPG

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

Uma pasta e suas subpastas com uma predefinição

Uma pasta de entrada que gera PDFs

Em que formatos o HEIC pode ser convertido?

Suas predefinições, por id e nome

filee convert

Opções

filee watch

Opções

filee formats

filee presets

filee help

Pastas monitoradas

Ou no app, em segundo plano

--json

Códigos de saída

Exemplo no PowerShell

Bom saber

Baixe o Filee com o comando filee

`filee convert`

`filee watch`

`filee formats`

`filee presets`

`filee help`

`--json`