AirTranslate

Trascrizione e traduzione in tempo reale dell'audio di sistema per macOS.

AirTranslate cattura l'audio riprodotto sul tuo Mac, lo trasforma in una trascrizione live, lo traduce in tempo reale e può mostrare il risultato come un overlay di sottotitoli galleggianti. È progettato per riunioni, lezioni, video, interviste e streaming dove l'instradamento dell'audio tramite microfono è scomodo o con perdite.

Il flusso di lavoro predefinito utilizza i framework Apple. I modelli in tempo reale basati su GPT sono opzionali e possono essere abilitati dall'app fornendo la propria chiave API OpenAI.

Perché AirTranslate

• Priorità all'audio di sistema: cattura l'audio di riproduzione del Mac direttamente con ScreenCaptureKit.
• Spazio di lavoro leggibile in tempo reale: testo sorgente e tradotto rimangono affiancati.
• Sottotitoli galleggianti: mantieni i sottotitoli sopra altre app mentre guardi o ascolti.
• Apple per impostazione predefinita: Apple Speech e Apple Translation rimangono il percorso di base.
• Modalità GPT opzionale: la trascrizione e traduzione in tempo reale di OpenAI possono essere abilitate solo quando necessario.
• Archiviazione su Keychain: le chiavi API OpenAI vengono inserite dall'utente e archiviate nel Portachiavi di macOS.
• Cronologia in testo semplice: le trascrizioni salvate rimangono normali file .txt in Application Support.

"Trasforma qualsiasi audio del Mac in sottotitoli e traduzioni live, proprio dove stai guardando."

Funzioni Principali

• Cattura live dell'audio di sistema del Mac
• Trascrizione Apple Speech
• Output Apple Translation
• Modalità GPT con trascrizione e traduzione OpenAI in tempo reale
• Percorso del modello solo per la traduzione in tempo reale
• Scambio lingua sorgente/destinazione con un clic
• Finestra sottotitoli galleggiante
• Miglioramento della trascrizione basato sui suggerimenti di ortografia di macOS
• Output vocale tradotto opzionale
• Libreria di trascrizioni salvate con funzioni di modifica, eliminazione e accesso alle cartelle
• Selezione dell'interfaccia in inglese, coreano, giapponese e cinese semplificato basata sulla lingua del Mac

Modalità di Elaborazione

AirTranslate separa la scelta rapida dalla configurazione dettagliata.

I dettagli del modello GPT, l'inserimento della chiave API, il miglioramento della trascrizione e l'output vocale sono gestiti dalla finestra delle impostazioni a forma di ingranaggio. La barra laterale principale espone solo le scelte più importanti.

Privacy e Chiavi API

AirTranslate non include un sistema di account backend.

• La Modalità Apple utilizza i framework di macOS e gli asset linguistici Apple gestiti localmente.
• Le chiamate OpenAI avvengono solo quando la modalità GPT o i modelli di traduzione OpenAI sono abilitati.
• Le chiavi API OpenAI non sono mai cablate, commesse o incluse nei pacchetti di rilascio.
• Le chiavi sono salvate nel Portachiavi di macOS con kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly.
• Le trascrizioni salvate sono file di testo semplice sul tuo Mac.

Hai bisogno di una chiave API? Apri la pagina delle chiavi API OpenAI, crea una chiave, quindi incollala nella finestra delle impostazioni di AirTranslate.

Pacchetti Linguistici di Traduzione Apple

La Modalità Apple utilizza le lingue di traduzione gestite da macOS. Prima di usare la Modalità Apple con una nuova coppia di lingue, scarica i pacchetti linguistici di traduzione Apple necessari:

1. Apri Impostazioni di Sistema.
2. Vai su Generali > Lingua e Zona.
3. Clicca su Lingue di traduzione.
4. Clicca su Scarica per ogni lingua sorgente e di destinazione che desideri utilizzare.
5. Opzionale: attiva Modalità su dispositivo se desideri che macOS elabori le traduzioni supportate sul tuo Mac ogni volta che è possibile.

Se una coppia di lingue selezionata non è disponibile o non è scaricata, la traduzione in Modalità Apple potrebbe non avviarsi o mostrare uno stato non disponibile finché macOS non dispone degli asset linguistici richiesti.

Permessi

AirTranslate richiede i permessi necessari per il suo flusso di cattura e trascrizione.

• Registrazione schermo
• Registrazione audio di sistema
• Riconoscimento vocale

La registrazione dello schermo è richiesta perché ScreenCaptureKit fornisce il percorso di cattura dell'audio di sistema. AirTranslate non salva i frame dello schermo come registrazioni.

Dopo aver modificato i permessi sulla privacy di macOS, chiudi e riavvia l'app in modo che il bundle dell'app firmata riceva il nuovo stato di autorizzazione.

Download

Scarica l'ultima build open-source da GitHub Releases. Il DMG è il percorso di installazione più semplice, e il ZIP rimane disponibile come opzione leggera originale.

AirTranslate rimane completamente open-source sotto la Licenza Apache-2.0. Il DMG è fornito solo come un comodo installer per macOS, mentre tutto il codice sorgente, gli script di build, i materiali di rilascio, la LICENZA e i file NOTICE rimangono disponibili in questo repository.

• Scarica AirTranslate.dmg
• Scarica AirTranslate-1.2.1.zip
• Scarica AirTranslate.dmg.sha256
• Visualizza la cronologia delle versioni

Il DMG e lo ZIP open-source sono build firmate ad-hoc per la distribuzione pre-notarizzazione. Al primo avvio, macOS potrebbe mostrare un avviso "sviluppatore non identificato". Per aprire l'app:

1. Apri il DMG e trascina AirTranslate.app in Applicazioni.
2. In Applicazioni, fai Control-clic o clic destro su AirTranslate.app.
3. Scegli Apri, quindi scegli di nuovo Apri nella finestra di avviso di macOS.

Puoi verificare il checksum del DMG dopo il download:

shasum -a 256 AirTranslate.dmg
cat AirTranslate.dmg.sha256

La firma con Developer ID e la notarizzazione sono pianificate per una fase di distribuzione successiva.

Requisiti

• macOS 26.0 o successivo
• Swift 6.2 o successivo
• Un Mac che supporta la cattura dell'audio di sistema
• Disponibilità dei framework Apple Speech e Apple Translation
• Opzionale: una chiave API OpenAI per la modalità GPT

Costruire dal Sorgente

Esegui il bundle dell'app:

./script/build_and_run.sh

Costruisci e verifica l'avvio:

./script/build_and_run.sh --verify

Visualizza i log:

./script/build_and_run.sh --logs

Reimposta i permessi di sviluppo:

./script/build_and_run.sh --reset-permissions

Controlli SwiftPM:

swift build
swift test

Utilizzo di Base

1. Scegli le lingue sorgente e di destinazione.
2. Usa il pulsante centrale per invertire la direzione se lo desideri.
3. Scegli la Modalità Apple o la Modalità GPT.
4. Per la Modalità GPT, aggiungi la tua chiave API OpenAI nella finestra delle impostazioni se richiesto.
5. Premi Start.
6. Riproduci l'audio di una riunione, lezione, video, intervista o streaming sul tuo Mac.
7. Leggi la trascrizione e la traduzione nell'area di lavoro principale o nella finestra dei sottotitoli galleggianti.
8. Premi Stop per salvare la trascrizione corrente.

Trascrizioni Salvate

Le trascrizioni salvate sono archiviate come file di testo semplice:

~/Library/Application Support/AirTranslate/Transcripts/*.txt

Quando sorgente e traduzione vengono salvate insieme, AirTranslate scrive file separati _original.txt e _translation.txt mentre li presenta come un elemento raggruppato nell'interfaccia utente della libreria.

Mappa del Progetto

Package.swift
Resources/
  AppIcon.png
  AppIcon.icns
Sources/AirTranslate/
  App/
  Models/
  Services/
  Support/
  Views/
Sources/AirTranslateCore/
Tests/
script/
  build_and_run.sh
docs/assets/
  airtranslate-readme-hero.png

Aree di Implementazione Chiave

• SystemAudioCapture: cattura l'audio di sistema del Mac tramite ScreenCaptureKit.
• LiveSpeechTranscriber: gestisce il riconoscimento vocale in streaming tramite Apple Speech.
• AppleTranslationService: isola il lavoro di Apple Translation.
• OpenAIRealtimeTranscriber: gestisce la trascrizione in tempo reale opzionale.
• OpenAITranslationService: gestisce le richieste di traduzione in tempo reale opzionali.
• OpenAIAPIKeyStore: salva la chiave API nel Portachiavi di macOS.
• TranslationSessionStore: coordina la cattura, lo stato della trascrizione, la traduzione, il salvataggio e la riproduzione.
• SidebarView: punti di ingresso per lingua, modalità, sessione e impostazioni.
• CaptionBoardView: trascrizione live, traduzione, controlli e misuratore audio.
• TranscriptLibraryView: gestione delle trascrizioni salvate.
• FloatingCaptionWindowController: ciclo di vita della finestra dei sottotitoli galleggianti.

Licenza

AirTranslate è rilasciato sotto la Licenza Apache 2.0. L'attribuzione del copyright è fornita in NOTICE.

AirTranslate è un progetto open-source indipendente e non è affiliato con Apple o OpenAI.