Convertire documenti, immagini, video, ebook e altri contenuti digitali è un’attività quotidiana per molti utenti Linux e professionisti informatici. Spesso, per effettuare queste operazioni, si ricorre a servizi online che richiedono il caricamento dei propri file su server di terze parti, con possibili implicazioni legate alla privacy e alla gestione dei dati personali.
ConvertX rappresenta un’alternativa interessante per chi desidera avere a disposizione una piattaforma di conversione accessibile direttamente dal browser, mantenendo il controllo sull’infrastruttura utilizzata. Si tratta di un progetto open source self-hosted, sviluppato utilizzando TypeScript, Bun ed Elysia, progettato per gestire un numero molto elevato di formati attraverso diversi strumenti di conversione.
Il progetto supporta oltre 1.000 formati e consente di effettuare conversioni senza dover installare manualmente numerose applicazioni sul proprio computer. Tutte le operazioni vengono gestite dal server sul quale è installata l’applicazione, mentre l’interfaccia web permette di caricare i file e selezionare i formati desiderati.
Questa soluzione può risultare particolarmente utile per amministratori di sistema, professionisti, utenti Linux e appassionati di homelab che desiderano centralizzare alcuni strumenti all’interno della propria rete domestica o infrastruttura aziendale.
Oltre 1.000 formati supportati e conversioni multiple
Uno degli aspetti più interessanti di ConvertX è la varietà di formati gestibili. Il progetto integra numerosi strumenti open source specializzati, ognuno dedicato a specifiche categorie di file.
Per le immagini troviamo ImageMagick e GraphicsMagick, che permettono di lavorare con centinaia di formati differenti. A questi si aggiungono Vips, libheif e libjxl, dedicati rispettivamente all’elaborazione delle immagini, ai formati HEIF e JPEG XL.
Anche il settore video è ampiamente coperto grazie a FFmpeg, uno degli strumenti più conosciuti nel mondo Linux per la conversione e l’elaborazione dei contenuti multimediali. Il supporto comprende circa 472 formati in ingresso e 199 formati in uscita, offrendo numerose possibilità di trasformazione dei file.
ConvertX non si limita però ai contenuti multimediali. Attraverso LibreOffice, Pandoc e Calibre è possibile convertire documenti, ebook e numerosi altri tipi di contenuto. Sono presenti anche strumenti dedicati alla grafica vettoriale, come Inkscape, resvg, Potrace e VTracer, oltre ad Assimp per la gestione degli asset tridimensionali.
Tra le funzionalità principali troviamo:
- Conversione tra numerosi formati di file.
- Elaborazione contemporanea di più file.
- Protezione dell’accesso tramite password.
- Supporto per più account utente.
- Interfaccia web accessibile attraverso il browser.
- Gestione autonoma dei file e dei dati sul proprio server.
La presenza di più account permette inoltre di utilizzare ConvertX in ambienti condivisi, evitando di dover predisporre un’installazione separata per ogni utente.
Installazione di ConvertX con Docker su Linux
Uno dei punti di forza del progetto è la semplicità di installazione. ConvertX può essere eseguito utilizzando Docker, evitando procedure manuali complesse per configurare tutte le dipendenze necessarie.
Per avviare il servizio è sufficiente utilizzare il seguente comando dal terminale:
docker run -p 3000:3000 \
-e PUID=1000 \
-e PGID=1000 \
-v ./data:/app/data \
ghcr.io/c4illin/convertxIl comando scarica l’immagine disponibile su GitHub Container Registry e avvia il container, pubblicando il servizio sulla porta 3000. La directory locale ./data viene collegata alla cartella /app/data del container, così da conservare i dati anche dopo un eventuale riavvio.
È importante configurare correttamente le variabili PUID e PGID, che devono corrispondere rispettivamente all’identificativo dell’utente e del gruppo presenti sul sistema host. Per recuperare questi valori è possibile utilizzare:
id -u
id -gQuesta configurazione permette di evitare problemi di autorizzazione durante la scrittura dei file nella directory condivisa. Qualora dovessero comparire errori relativi all’apertura del database, è consigliabile verificare i permessi della cartella utilizzata e, se necessario, correggerli con:
chown -R $USER:$USER ./dataTerminata l’installazione, ConvertX sarà raggiungibile dal browser attraverso:
http://localhost:3000Al primo accesso sarà necessario creare un account per utilizzare la piattaforma. Un dettaglio importante riguarda la sicurezza: non bisogna lasciare l’installazione iniziale aperta e non configurata, perché il primo account può essere registrato da chiunque riesca a raggiungere il servizio.
Per questo motivo, prima di rendere ConvertX accessibile dall’esterno della propria rete, è opportuno configurare correttamente gli account e le protezioni di accesso, evitando di esporre un’installazione non ancora protetta su Internet.
ConvertX è quindi una soluzione interessante per chi desidera disporre di un servizio centralizzato per la conversione dei file, sfruttando strumenti open source consolidati e mantenendo il controllo sui propri dati.