trans-epub 0.0.23

Translate EPUB with CLI
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

# trans-epub

[![Crates.io](https://img.shields.io/crates/v/trans-epub.svg)](https://crates.io/crates/trans-epub)
[![Docs.rs](https://docs.rs/trans-epub/badge.svg)](https://docs.rs/trans-epub)
[![CI](https://github.com/tomiyan/trans-epub/workflows/CI/badge.svg)](https://github.com/tomiyan/trans-epub/actions)
[![Rust GitHub Template](https://img.shields.io/badge/Rust%20GitHub-Template-blue)](https://rust-github.github.io/)

This is a CLI tool to translate EPUB using OpenAI / Gemini API.

## CAUTION

- If a translated book is available, we strongly recommend that you purchase it.
- This is only a tool to assist in reading books that have not been translated.
- Although the API is called in parallel, the translation takes a long time because of the ratelimit.
- Also, although the translation is done in units of 20 lines, if the number of lines does not match the original text and the translated text, the API is called again for each line, which is more expensive than simply translating the text.


![Translate sample](./docs/images/translate_sample.png)

## Installation

### Cargo

* Install the rust toolchain in order to have cargo installed by following
  [this](https://www.rust-lang.org/tools/install) guide.
* run `cargo install trans-epub`

## Execution

Install

```bash
curl -OL https://github.com/tomiyan/trans-epub/releases/download/0.0.17/trans-epub-0.0.17-macos-arm64.tar.gz
tar xvzf trans-epub-0.0.17-macos-arm64.tar.gz
```

Use Open AI help

```bash
./trans-epub open-ai --help
Use OpenAI API

Usage: trans-epub open-ai [OPTIONS] --input <INPUT> --output <OUTPUT> --language <LANGUAGE> --api-key <API_KEY>

Options:
  -i, --input <INPUT>        input file path
  -o, --output <OUTPUT>      output file path
  -l, --language <LANGUAGE>  translate language
  -m, --model <MODEL>        OpenAI model ex(gpt-4o-mini, gpt-4o, gpt-4-turbo, gpt-3.5-turbo-1106) [default: gpt-4o-mini]
  -a, --api-key <API_KEY>    OpenAI API Key [env: API_KEY]
      --lines <LINES>        Number of lines of translation [default: 20]
      --requests <REQUESTS>  Number of concurrent requests [default: 5]
  -h, --help                 Print help
```

Use Open AI translate

```bash
export API_KEY=sk-....
./trans-epub open-ai -i ./origin.epub -o ./translated.epub -l Japanese
```

Wait a few minutes.

Use Gemini help

```bash
./trans-epub gemini --help
Use Gemini API

Usage: trans-epub gemini [OPTIONS] --input <INPUT> --output <OUTPUT> --language <LANGUAGE> --api-key <API_KEY>

Options:
  -i, --input <INPUT>        input file path
  -o, --output <OUTPUT>      output file path
  -l, --language <LANGUAGE>  translate language
  -m, --model <MODEL>        Gemini model ex(gemini-1.5-flash) [default: "gemini-2.0-flash-lite]
  -a, --api-key <API_KEY>    Gemini API Key [env: API_KEY]
      --lines <LINES>        Number of lines of translation [default: 100]
      --requests <REQUESTS>  Number of concurrent requests [default: 1]
  -h, --help                 Print help
```

Use Gemini translate

```bash
export API_KEY=AI....
./trans-epub gemini -i ./origin.epub -o ./translated.epub -l Japanese
```

Wait a few minutes.

## License

Licensed under either of

 * Apache License, Version 2.0
   ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
 * MIT license
   ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

## Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.

See [CONTRIBUTING.md](CONTRIBUTING.md).

## Thanks

Inspired by [epub-translator](https://github.com/sharplab/epub-translator)