Dal sorgente
all'immagine.
Franchetti Raw Converter Pro è lo stesso programma su ogni sistema. Qui trovi la strada completa per avviarlo su Linux e macOS: cosa scaricare, quali pacchetti servono, come compilare l'eseguibile e cosa fare quando qualcosa non torna.
01Cosa scaricare
Due archivi leggeri, senza installer e senza binari compilati: contengono lo stesso programma, la documentazione e lo script di diagnosi. Si scompattano in una cartella qualsiasi.
macOS · avvio assistito
Doppio clic su «Avvia Franchetti Raw Converter.command»: prepara l'ambiente al primo avvio e apre il programma. Non è un'app firmata.
Scarica per macOSLinux · sorgente
Il sorgente completo con la guida: cinque comandi nel terminale, oppure la compilazione dell'eseguibile con build_exe.py.
Il pacchetto macOS contiene in più Avvia Franchetti Raw Converter.command e LEGGIMI.txt. Il pacchetto Linux e quello macOS contengono lo stesso programma: cambia solo il modo di avviarlo.
| File | A cosa serve |
|---|---|
main.py | Il programma completo: interfaccia, pipeline RAW, batch, tethering. |
Avvia ... .command | Solo nel pacchetto macOS: prepara l'ambiente e apre il programma. Non è un'app firmata. |
requirements.txt | Le dipendenze Python, con le versioni minime. |
build_exe.py | Compila l'eseguibile con PyInstaller. Su Linux usa --onedir. |
LINUX_MACOS.md | La stessa guida in formato testo, da tenere accanto al programma. |
USER_MANUAL.md | Il manuale d'uso: batch, parametri, watermark, preset, LUT. |
GUIDA_COMPLETA.html | La guida illustrata, apribile nel browser senza connessione. |
tools/diagnosi_linux.sh | Misura memoria e processi durante l'avvio e scrive un report. |
LICENSE | Termini d'uso del programma. |
02Prima di iniziare
Non serve essere programmatori. Su Linux sono cinque comandi da incollare nel terminale; su macOS c'è un file di avvio automatico. In entrambi i casi serve Python con la sua libreria grafica, Tk.
| Voce | Richiesta |
|---|---|
| Python | 3.11 o 3.12. Con 3.14 o superiore il batch può comportarsi male: la build avvisa. |
| Tk | La libreria grafica di Python. Su molte distribuzioni non è installata di serie. |
| Spazio su disco | Circa 1 GB tra dipendenze e build. |
| RAM | 2 GB minimo, 8 GB consigliati con RAW da 40-60 MP. |
| Sistema | Linux x86_64; macOS Intel o Apple Silicon. |
Tk, comando per distribuzione
| Distribuzione | Comando |
|---|---|
| Debian, Ubuntu, Mint | sudo apt install python3-tk |
| Fedora | sudo dnf install python3-tkinter |
| Arch, Manjaro | sudo pacman -S tk |
| openSUSE | sudo zypper install python3-tk |
| macOS con Homebrew | brew install python-tk@3.12 |
Su macOS va benissimo anche la Python di python.org, che include Tk: in quel caso non serve installare altro.
03Linux, passo per passo
Questa è la procedura provata su Linux Mint 22.3 in macchina virtuale, con Python 3.12.0 e PyInstaller 6.22.3. Vale allo stesso modo su Ubuntu e Debian.
Scompatta l'archivio
Apri il terminale nella cartella dove hai scaricato lo ZIP, di solito Scaricati.
cd ~/Scaricati unzip Franchetti_Raw_Converter_Sorgente_2.58.2.zip cd FranchettiRawConverterPro-2.58.2
Installa Tk, se manca
Se al primo avvio compare No module named tkinter, manca Tk. Su Debian, Ubuntu e Mint:
sudo apt update sudo apt install python3-tk
Crea l'ambiente Python
Un ambiente separato tiene le dipendenze del programma lontane dal resto del sistema. Si crea una volta sola.
python3 -m venv .venv source .venv/bin/activate
Il prompt cambia e mostra (.venv) all'inizio della riga. Per uscire: deactivate.
Installa le dipendenze
Il primo download è di circa 250 MB: comprende LibRaw, Pillow, NumPy, OpenCV e le altre librerie.
python3 -m pip install --upgrade pip pip install -r requirements.txt
Avvia il programma
Si apre la finestra normale: seleziona la cartella dei RAW, la destinazione e premi «Avvia conversione batch».
python3 main.py
Alla prima esecuzione compare nel log la riga di avvio, con versione di Python, PID e metodo dei processi: serve a capire subito come sta girando il programma.
Facoltativo: compila l'eseguibile
Se preferisci non dipendere dal terminale, costruisci la cartella eseguibile. Su Linux il risultato è dist/FranchettiRawConverterPro/ e va tenuto intero.
python3 build_exe.py ./dist/FranchettiRawConverterPro/FranchettiRawConverterPro
La build usa --onedir: i file restano accanto all'eseguibile e non vengono più estratti in /tmp a ogni avvio. È la combinazione che ha chiuso il consumo anomalo di memoria.
04macOS, passo per passo
Il pacchetto per macOS contiene un avvio automatico: non devi digitare comandi. Questa parte non è mai stata provata su una macchina Apple reale: considerala sperimentale e, se qualcosa non torna, scrivi all'autore.
Scompatta e fai doppio clic
Scompatta lo ZIP, tieni la cartella dove vuoi e apri Avvia Franchetti Raw Converter.command. La prima volta macOS può chiedere conferma: clic destro sul file, poi Apri, poi Apri. Se il doppio clic non fa nulla, scegli Apri con → Terminale.
Al primo avvio il file prepara l'ambiente dentro la cartella e scarica le dipendenze (circa 250 MB, serve internet solo quella volta). Le volte successive il programma si apre in pochi secondi.
Se preferisci non usare il file di avvio, i comandi manuali sono al passo 4.
Se macOS blocca il file scaricato
Il file arriva dal browser e porta il segno di quarantena. Tre modi, dal più semplice:
- clic destro sul file → Apri → Apri;
- Impostazioni di Sistema → Privacy e Sicurezza → in fondo, Apri comunque;
- da Terminale, nella cartella del programma:
xattr -dr com.apple.quarantine .
La quarantena riguarda il file scaricato, non il programma in sé: una volta aperto, non viene più chiesta.
Serve Python con Tk
Il pacchetto non include Python: usa quello del sistema. Va bene la versione di python.org, che include Tk. Se usi Homebrew, aggiungi il pacchetto grafico della stessa versione:
brew install python-tk@3.12 python3 --version
Se manca Python, l'avvio automatico lo dice e si ferma: non installa nulla al posto tuo.
In alternativa: da terminale
Gli stessi passaggi a mano, se preferisci vedere cosa succede. Il terminale si apre da Applicazioni → Utility → Terminale.
cd ~/Downloads unzip Franchetti_Raw_Converter_macOS_2.58.2.zip cd FranchettiRawConverterPro-macOS-2.58.2 python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt python3 main.py
.app con icona. Per distribuire un .dmg che si apre con un doppio clic servirebbe l'Apple Developer Program (99 $ l'anno): non è previsto.
Se compili su un Mac Apple Silicon, l'eseguibile funziona su Apple Silicon. Per Intel serve compilare su Intel, oppure una build universale, più delicata da preparare.
05Compilare l'eseguibile
La build serve solo se vuoi un programma da avviare senza terminale. Richiede le dipendenze già installate nell'ambiente virtuale.
source .venv/bin/activate python3 build_exe.py
| Risultato | Dove |
|---|---|
| Linux | dist/FranchettiRawConverterPro/ — cartella intera, con l'eseguibile dentro |
| macOS | dist/FranchettiRawConverterPro — singolo eseguibile, senza bundle .app |
Icona, proprietà del file e manifest sono opzioni Windows: su Linux e macOS la build le salta e lo scrive nell'output. Non è un errore.
Due variabili, quando servono
| Variabile | Effetto |
|---|---|
FRC_ONEFILE=1 | Torna al pacchetto singolo. Sconsigliato: si ri-estrae in /tmp a ogni avvio. |
FRC_THREADS=1 | Forza il batch con i thread invece dei processi. |
forkserver. Con un programma impacchettato è la combinazione che manda in crash l'applicazione a catena. Per la build usa Python 3.11 o 3.12.
06Log e diagnosi
Il log non è sul Desktop: sta nella cartella dati dell'utente, dove il programma ha sempre il permesso di scrivere.
| Sistema | Percorso |
|---|---|
| Linux | ~/.local/share/FranchettiRawConverterPro/franchetti_log.txt |
| macOS | ~/Library/Application Support/FranchettiRawConverterPro/franchetti_log.txt |
Per le ultime righe, senza aprire editor:
tail -n 40 ~/.local/share/FranchettiRawConverterPro/franchetti_log.txt
Su Linux c'è anche uno script che avvia il programma, campiona ogni tre secondi memoria libera e numero di copie del processo, e scrive un report:
bash tools/diagnosi_linux.sh # report: ~/diagnosi-frc.txt
Nel log trovi anche le righe che iniziano con Anteprima: dicono se il problema è la decodifica del RAW o il disegno dell'immagine.
07Cosa è dichiarato sperimentale
Nessuna promessa oltre ciò che è stato provato. Questi sono i limiti reali, al momento.
| Voce | Stato |
|---|---|
| Pacchetti pronti | Nessun .deb, .rpm, .AppImage, .dmg o .app |
| Firma Apple | Assente: il file scaricato va aperto con «Apri comunque» |
| Icona e proprietà | Non impostate su Linux e macOS |
| Tethering e FTP | Sony Wi-Fi, server FTP e hot-folder non sono stati provati su Linux o macOS |
| Aggiornamenti | Nessun aggiornamento automatico: si riscarica lo ZIP |
| Distribuzioni | Provata una sola: altre possono richiedere pacchetti aggiuntivi |
08Problemi comuni
I messaggi che capitano più spesso, con la soluzione. Se non trovi il tuo, scrivi all'autore con il log: si parte da lì.
| Messaggio | Cosa fare |
|---|---|
No module named tkinter | Manca Tk: installalo con il comando della tua distribuzione (sezione 02). |
ModuleNotFoundError: rawpy | L'ambiente virtuale non è attivo: source .venv/bin/activate, poi reinstalla le dipendenze. |
Permission denied | Sull'eseguibile: chmod +x dist/FranchettiRawConverterPro/FranchettiRawConverterPro. In alternativa avvia python3 main.py. |
| L'app Mac non si apre | Clic destro → Apri, oppure xattr -dr com.apple.quarantine sulla cartella. |
| Memoria che cresce, processo ucciso | Usa la build --onedir con Python 3.11/3.12 e non FRC_ONEFILE=1. |
| Anteprima PRIMA/DOPO vuota | Apri il log e cerca le righe «Anteprima»: indicano se fallisce la decodifica o il disegno. |
python3: command not found | Installa Python dal gestore pacchetti o da python.org, poi riapri il terminale. |
| Batch lento | Controlla quanti core usa il programma nelle opzioni: su macchine virtuali i core disponibili sono pochi. |
09Segnalare un problema
Una segnalazione con quattro informazioni si risolve quasi sempre al primo scambio. Scrivi a reportage@libero.it indicando:
Sistema
Distribuzione e versione, per esempio «Linux Mint 22.3» oppure «macOS 15.2, M2».
Python
L'output di python3 --version, e se hai usato python.org, Homebrew o conda.
Passi e log
Cosa hai fatto prima dell'errore, il file franchetti_log.txt e, su Linux, ~/diagnosi-frc.txt.
Pronto a provarlo?
Scarica il sorgente, segui i cinque comandi della guida e apri il primo RAW. Se qualcosa non torna, il log dice dove guardare.