Ihre erste Übersetzung

Vom eigenen Buch zur Übersetzung – Schritt für Schritt

Sie müssen nicht programmieren können. Wenn Sie eine Datei herunterladen, eine Zeile bearbeiten und einen Befehl kopieren können, können Sie Ihre erste Übersetzung vorbereiten.

Was Sie benötigen

Bereiten Sie vier Dinge vor. Kosten entstehen nur durch die Nutzung des gewählten Sprachmodells.

  • Einen Computer mit Windows, macOS oder Linux.
  • Ihre EPUB-, PDF- oder MOBI-Datei, die Sie verarbeiten dürfen.
  • Das kostenlose Python 3.10 oder neuer.
  • Einen API-Schlüssel von OpenAI oder Anthropic. Sie benötigen nicht beide.

API-Schlüssel anlegen

Ein API-Schlüssel ist ein privates Passwort. Damit kann Berilo Text direkt an den gewählten Anbieter senden und die Nutzung über Ihr Konto abrechnen. Ein ChatGPT- oder Claude-Abonnement umfasst die API-Nutzung nicht unbedingt; prüfen Sie die Abrechnung in der Anbieterkonsole.

OpenAI

Erstellen Sie ein Konto auf der OpenAI Platform, hinterlegen Sie Guthaben oder eine Zahlungsmethode, öffnen Sie API keys und wählen Sie Create new secret key. Kopieren Sie den Schlüssel sofort, da er später nicht mehr vollständig angezeigt wird.

OpenAI-Schlüssel erstellen

Anthropic

Erstellen Sie ein Konto in der Claude-Konsole, richten Sie die Abrechnung ein, öffnen Sie API Keys und wählen Sie Create Key. Auch dieser Schlüssel wird nur einmal angezeigt.

Anthropic-Schlüssel erstellen

Versenden Sie den Schlüssel nicht per E-Mail, veröffentlichen Sie ihn nicht und fügen Sie ihn nicht auf dieser Website ein. Speichern Sie ihn ausschließlich in der unten beschriebenen lokalen .env-Datei. Legen Sie beim Anbieter ein Ausgabenlimit fest.

Berilo und Python herunterladen

Laden Sie das Berilo-Projekt als ZIP-Datei von GitHub herunter und entpacken Sie es an einem leicht auffindbaren Ort, zum Beispiel Dokumente/Berilo.

Installieren Sie anschließend Python 3.10 oder neuer. Aktivieren Sie unter Windows im Installationsprogramm Add Python to PATH.

Python von der offiziellen Website herunterladen

Schlüssel eintragen und Übersetzer installieren

Suchen Sie im entpackten Berilo-Ordner nach .env.example. Falls Dateien mit einem Punkt am Anfang nicht sichtbar sind, aktivieren Sie im Dateimanager die Anzeige versteckter Dateien.

  1. Erstellen Sie eine Kopie von .env.example und benennen Sie die Kopie in .env um.
  2. Öffnen Sie .env in einem Texteditor. Fügen Sie den Schlüssel hinter OPENAI_API_KEY= oder ANTHROPIC_API_KEY= ein. Die andere Zeile kann leer bleiben.
  3. Öffnen Sie ein Terminal im Berilo-Ordner. Geben Sie unter Windows powershell in die Adressleiste des Ordners ein; öffnen Sie unter macOS Terminal und ziehen Sie den Ordner in das Fenster.
python -m pip install -e ./translator

Prüfen Sie nach der Installation die Verbindung. Der Test übersetzt einen Satz und kostet praktisch nichts.

berilo doctor

Kosten prüfen und übersetzen

Kopieren Sie das Buch in den Berilo-Ordner oder verwenden Sie im Befehl den vollständigen Pfad. Setzen Sie Pfade mit Leerzeichen immer in Anführungszeichen.

Prüfen Sie zuerst, ob Berilo das Buch lesen kann:

berilo inspect "moja-knjiga.epub"

Lassen Sie anschließend kostenlos die Kosten schätzen. Tun Sie dies immer vor der Übersetzung:

berilo translate "moja-knjiga.epub" --to sl --dry-run

Wenn die Schätzung für Sie passt, starten Sie die Übersetzung:

berilo translate "moja-knjiga.epub" --to sl

Das übersetzte EPUB wird neben dem Original gespeichert. Eine unterbrochene Übersetzung kann neu gestartet werden: Berilo setzt sie aus dem Zwischenspeicher fort und berechnet bereits abgeschlossene Abschnitte nicht erneut.

Übersetztes Buch öffnen

Sie können das übersetzte EPUB sofort in jedem EPUB-Leseprogramm öffnen. Wenn die offizielle Berilo-APK veröffentlicht wird, laden Sie sie ausschließlich unter Releases herunter: Erlauben Sie in Android die Installation unbekannter Apps für den Browser oder Dateimanager und öffnen Sie anschließend die heruntergeladene APK.

Offizielle Veröffentlichungen prüfen
Für Fortgeschrittene: Android-App aus dem Quellcode erstellen

Dieser Weg erfordert Android Studio, ein JDK und adb. Er richtet sich an technisch erfahrene Personen und ist für Ihre erste Übersetzung nicht erforderlich.

cd android
./gradlew assembleRelease
adb install -r app/build/outputs/apk/release/app-release.apk

Eine faire Grenze

Berilo hilft beim Lesen, nicht beim Beschaffen von Büchern.

Verwenden Sie ausschließlich Dateien, die Sie rechtmäßig besitzen und verarbeiten dürfen. Berilo bietet keinen Buchkatalog, keine Downloads, keine DRM-Entfernung und keine Freigabefunktion. So bleibt das Werkzeug offen und für Leserinnen und Leser nützlich und respektiert zugleich Autoren und Verlage.

Zurück zu Berilo