Windows 10/11I tuoi presetOutput JSON

La riga di comando filee

Converti file dal Prompt dei comandi, da PowerShell o dai tuoi script con gli stessi motori e preset dell'app, oppure lascia che una cartella converta tutto ciò che vi arriva. Tutto resta sul tuo PC.

Scegli un download Vedi i comandi

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 il comando filee

1
Lascialo selezionato nell'installazione
Nella pagina delle opzioni del programma di installazione di Filee, lascia selezionato Aggiungi il comando "filee" al PATH (è attivo per impostazione predefinita). Filee è già installato? Esegui di nuovo l'ultimo programma di installazione.
2
Apri un nuovo terminale
Apri una nuova finestra del Prompt dei comandi, di PowerShell o di Windows Terminal (una già aperta non vede il nuovo PATH) ed esegui filee version.
3
Versione portable o senza PATH
È tutto nella cartella di Filee: esegui filee-cli.exe da lì, oppure aggiungi tu la sua cartella cli al PATH. Non serve che l'app sia in esecuzione.

Per iniziare

Indica nomi di file, caratteri jolly come *.heic o intere cartelle. I risultati vengono salvati accanto agli originali, a meno che tu non aggiunga -o.

Una foto in JPG
```
filee convert photo.heic --to jpg
```
Tutti i PNG in WebP con qualità 80, in un'unica cartella
```
filee convert *.png --to webp --quality 80 -o converted
```

Una cartella e le sue sottocartelle con un preset

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

Una cartella di arrivo che crea PDF

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

In cosa può diventare un HEIC?
```
filee formats heic
```
I tuoi preset, per id e nome
```
filee presets
```

Comandi

`filee convert`

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

Converte file, caratteri jolly (*.heic) e cartelle. Per una cartella converte i file che Filee conosce; aggiungi -r per le sottocartelle. Indica un formato di destinazione oppure uno dei tuoi preset.

Opzioni

`-t, --to <format>`	Formato di destinazione per id o estensione: jpg, png, webp, pdf, docx, hwpx, mp4, mp3… (vedi `filee formats`)
`-p, --preset <preset>`	Un preset dell'app, per id o per nome (vedi `filee presets`)
`-o, --output <folder>`	Salva lì invece che accanto ai file di origine
`-r, --recursive`	Includi le sottocartelle
`-q, --quality <1-100>`	Qualità dell'immagine per JPG, WebP, AVIF e altri formati con perdita
`--overwrite`	Sostituisci i file di output esistenti (per impostazione predefinita al nuovo nome si aggiunge un numero)
`--skip`	Lascia invariati i file di output esistenti
`--keep-dates`	Dai ai file convertiti le date di creazione e di modifica degli originali
`--json`	Stampa il risultato come un unico documento JSON, per gli script
`--quiet`	Stampa solo gli errori

`filee watch`

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

Converte ogni file che arriva nella cartella finché non premi Ctrl+C. I file convertiti vanno in una cartella converted al suo interno, a meno che tu non aggiunga -o.

Opzioni

`-t, --to <format>`	Formato di destinazione
`-p, --preset <preset>`	Un preset dell'app, per id o per nome
`-o, --output <folder>`	Dove vanno i file convertiti (predefinito: `<folder>\converted`)
`-r, --recursive`	Monitora anche le sottocartelle (i loro file mantengono la sottocartella nell'output)
`--move-originals`	Sposta ogni file di origine convertito in `<folder>\originals` e all'avvio converte i file che vi sono già in attesa
`--settle <seconds>`	Per quanto tempo un file deve restare invariato prima di essere convertito (predefinito 2)
`--keep-dates`	Dai ai file convertiti le date di creazione e di modifica degli originali
`--quiet`	Stampa solo gli errori

`filee formats`

filee formats [<format>]

Elenca ogni formato con il suo id e le sue estensioni, oppure in cosa si converte un formato, compreso ciò che aggiungerebbe un motore facoltativo.

`filee presets`

filee presets

Elenca i preset integrati e quelli che hai creato nell'app, con id, nome e formato di destinazione.

`filee help`

filee help [<command>]
filee version

Mostra come usare tutti i comandi o uno solo, e la versione installata.

Cartelle monitorate

Lascia che una cartella converta tutto ciò che ci metti: download, scansioni, esportazioni da altre app.

I file vengono convertiti quando sono completi, non crescono più e non sono aperti in un altro programma, quindi download e copie lunghe sono al sicuro.
I file temporanei e nascosti (.crdownload, .part, .tmp, file ~$) e i formati che Filee non conosce vengono ignorati.
I file convertiti vanno in una cartella converted dentro la cartella monitorata, o dove indica -o. Con -r i file delle sottocartelle vi mantengono la loro sottocartella (2025\a.png → converted\2025\a.pdf).
Con --move-originals ogni file di origine convertito va in originals, così la cartella funziona come una casella di posta. I file già in attesa vengono convertiti all'avvio.

Oppure nell'app, in background

La pagina Cartelle monitorate di Filee fa lo stesso senza terminale: aggiungi le cartelle, scegli un preset per ognuna e vengono convertite mentre Filee è nell'area di notifica.

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

Usalo negli script

--json stampa un unico documento JSON con il risultato di ogni file, e il codice di uscita dice al tuo script com'è andata.

`--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)"
    }
  ]
}

Codici di uscita

`0`	Nessun errore
`1`	Alcuni file non sono riusciti (gli altri sono stati convertiti)
`2`	Argomenti errati, un formato o un preset sconosciuto, oppure un file di input mancante
`3`	Niente da convertire

Esempio in 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)" }
}

Buono a sapersi

Stessi motori e preset dell'app: un preset che crei o modifichi in Filee funziona subito con --preset, per id o per nome.
I motori facoltativi (FFmpeg, LibreOffice…) si installano nell'app in Impostazioni → Motori. filee formats <format> mostra quali conversioni ne richiedono uno.
I caratteri jolly li espande filee stesso, quindi *.heic funziona sia nel Prompt dei comandi sia in PowerShell. Metti tra virgolette i percorsi con spazi.
Non viene caricato nulla e non serve internet: i file vengono convertiti sul tuo PC, come nell'app.
I messaggi sono in inglese, così script e log si leggono allo stesso modo su ogni PC.

Scarica Filee con il comando filee

La riga di comando è inclusa in Filee per Windows 10/11: gratuita, open source e offline.

Scarica per Windows

macOS è in anteprima. Linux richiede Ubuntu 22.04 o successivo; i gesti di trascinamento richiedono X11 (sperimentali su KDE Plasma con Wayland).

Tutte le versioni Codice sorgente

La riga di comando filee

Lascialo selezionato nell'installazione

Apri un nuovo terminale

Versione portable o senza PATH

Una foto in JPG

Tutti i PNG in WebP con qualità 80, in un'unica cartella

Una cartella e le sue sottocartelle con un preset

Una cartella di arrivo che crea PDF

In cosa può diventare un HEIC?

I tuoi preset, per id e nome

filee convert

Opzioni

filee watch

Opzioni

filee formats

filee presets

filee help

Cartelle monitorate

Oppure nell'app, in background

--json

Codici di uscita

Esempio in PowerShell

Buono a sapersi

Scarica Filee con il comando filee

`filee convert`

`filee watch`

`filee formats`

`filee presets`

`filee help`

`--json`