This tool is designed to help users convert text from one format to another, as well as translate it into a different language using the OpenAI API (model="gpt-3.5-turbo"). It currently supports PDF and EPUB file formats for conversion, and can translate text into a variety of languages.
To use this tool, you will need to have Python 3 installed on your system, as well as the following packages:
- pdfminer
- openai
- tqdm
- ebooklib
- bs4
You can install these packages by running the following command:
pip install pdfminer pdfminer.six openai tqdm ebooklib bs4
git clone
git clone https://github.com/jesselau76/pdf-epub-GPT-translator.git
Update to new version
cd pdf-epub-GPT-translator
git pull
To use this tool, you need rename settings.cfg.example to settings.cfg at first.
cd pdf-epub-GPT-translator
mv settings.cfg.example settings.cfg
nano settings.cfg
openai-apikey = sk-xxxxxxx
replace sk-xxxxxxx to your OpenAI api key.
usage:
python3 text_translation.py [-h] [--test] filename
positional arguments:
filename Name of the input file
options:
-h, --help show this help message and exit
--test Only translate the first 3 short texts
Simply run the text_translation.py script with the file you want to translate or convert as an argument. For example, to translate a PDF file named example.pdf, you would run the following command:
python3 text_translation.py example.pdf
or to translate a epub file named example.epub, you would run the following command:
python3 text_translation.py example.epub
or to translate a text file named example.txt, you would run the following command:
python3 text_translation.py example.txt
By default, the script will attempt to translate the text into the language specified in the settings.cfg file under the target-language option. You can also choose to output a bilingual version of the text by setting the bilingual-output option to True.
- The code reads the OpenAI API key, target language, and other options from a settings.cfg file.
- The code converts PDF and EPUB files to text using the pdfminer and ebooklib libraries, respectively.
- The code provides an option to output bilingual text.
- The code provides a progress bar to show the progress of PDF/EPUB to text conversion and translation
- Test function available. Only translate 3 short texts to save your API usage with --test.
The settings.cfg file contains several options that can be used to configure the behavior of the script:
openai-apikey: Your API key for the OpenAI API.target-language: The language you want to translate the text into (e.g.jafor Japanese,zhfor Chinese,文言文or红楼梦风格的半文言文etc.).
bilingual-output: Whether or not to output a bilingual version of the text.langcode: The language code for the output epub file (e.g.jafor Japanese,zhfor Chinese, etc.).
The output of the script will be an EPUB file with the same name as the input file, but with _translated appended to the end. For example, if the input file is example.pdf, the output file will be example_translated.epub and example_translated.txt.
This tool is released under the MIT License.
The purpose of this project is only applicable to books that have entered the public domain and is not intended for use with copyrighted material. We strongly advise users to read the copyright information carefully before using this project and to comply with relevant laws and regulations in order to protect their own and others' rights.
In no event shall the authors or developers be liable for any loss or damage caused by the use of this project. Users assume all risks associated with the use of this project. Users must confirm that they have obtained permission from the original copyright holder or used open source PDF/EPUB files before using this project to avoid potential copyright risks.
If you have any concerns or suggestions about the use of this project, please contact us through the issues section.