This is the readme file for project 'GraGle Planter'.

Something...

一开始脑抽写了英文文档，现在“翻译”一遍

由于我没有发布工程的经验所以这个文档比较难看，而且部分代码是“陈年代码”，所以它也会显得有点丑。而且可能还有bug，我会慢慢修。

计算token的那部分是我很久之前在百度查到的一篇博客里的，但是很抱歉我不记得这篇博客链接了。我猜测这部分代码来自于https://github.com/cocoa520/Google_TK。

I have little experience of releasing a project so the readme file maybe ugly, QWQ. Since some of the code was written years ago, it also seems ugly. It may also contain many bugs, but I will try to fix them.

The part calculating token comes from a blog in baidu. However, since the original code was finished years ago, I can't find the original article or the original writer right now. I'm sorry for that, but I guess the original code might comes from "https://github.com/cocoa520/Google_TK".

What is GraGle Planter

GraGle Planter是用来给你的文本“生草”的工具。

为什么选用谷歌翻译？谷歌娘总之就是非常可爱。

这个项目来自于多年前我做鬼畜的工具，工具原本可以把一个句子翻译成其他语言，然后收集对应语言的tts（Text To Speech）语音。

由于这种方式鬼畜越来越流行，所以我又把工具拿出来增加了一些功能，比如可以分句、还可以在几种语言之间反复横跳——自定义你的生草风格！

GraGle Planter is a tool to make your text grassy("生草").

Why Google? Fly me to the moon!

This is a program originally written to produce 'Autotune Remix' years ago, which originally can automatically translate a sentence into many languages and collect corresponding tts.

Given that it is more and more popular to produce 'Autotune Remix', I add some functions to the program and now it can Get the tts in different languages with several additional functions(see help).

How to use

InputFile

InputFile在下文指代输入文件名

The text you want to plant grass (on)

OutputFile(s)

OutputFile(s)在下文指代输出文件。程序会在InputFile_output文件夹内生成x.txt和x.mp3，x是句子的顺序，如果需要分句（-c被指定），那么就会有1.txt、2.txt...以及对应的mp3，0.txt为合并的文本，最后如果需要合并且正确配置了ffmpeg（-m被指定），那么就会有0.mp3是合并且统一响度的音频。

The Grass-Planter will first create InputFile_output if it does not exist yet

The it will cut the passage into sentences if you choose '-c' and plant grass in order. If the output language support tts, you will get x.mp3(tts result) and x.txt(translated text), otherwise x.txt only. x represents the order of the sentence.

重要请注意生草机不会重新生成一个已存在的txt文件，如果它检测到x.txt已经存在，它就会跳过这一句话，所以如果上次运行没运行完就退出，建议检查最后一句的.mp3和.txt是否完整，最好删掉最后一句的.mp3和.txt以防止漏句子

Important:Please note that the Grass-Planter will not recreate txts, which means if x.txt exists, the Grass-Planter will not plant grass again. So you stopped the Grass-Planter forcely last time, I recommend you check the integrity of the lastest txt file in case of incomplete output file

如果直接用python源代码运行的话，PyExecJS是需要提前用Pip安装的 如果还需要合并音频，那么还需要准备pydub(pip)和ffmpeg(apt)

If you use the python source code, PyExecJS is required. pydub and ffmpeg are only required when -m is on

Use python ggp.py -h or ggp.exe to get help text or read text below(Assuming ggp.py or ggp.exe is the Grass-Planter and you want to plant grass for InputFile)

命令行运行：python ggp.py -h或不带-h获取英文帮助文本
命令行格式
    python ggp.py InputFile [-c [separator]] [-i language] [-o language] [-t times | -l languages]
命令行选项
    -h -? 或者不带参数
        显示帮助文本
    -c [seperator]
        用seperator（默认是中文句号）把文本分割开来，每一句话（如果不带-c就是整篇文章）不能超过5000字，中文字符算一个字
        e.g. 
            python ggp.py InputFile -c      # Use '。' 
            python ggp.py InputFile -c '.'  # Use '.'
            python ggp.py InputFile -c '$'  # Use '$'
    -i language
        指定输入语言，默认情况下是自动选择，如果某个文本效果不好可以试试指定语言
        请按照下表使用语言代码，例如en ja zh-CN auto
    -o language
        指定输出语言，默认是中文，如果输出语言不在tts支持范围之内则不会输出tts语音
        可以使用ran表示随机语言，随机语言在-o中保证在tts支持范围
    -t times
        指定生草次数。生草机内部通过“生草链”来完成反复横跳的翻译，比如auto -> en -> zh-CN，生草次数指除了输入输出语言之外中间还有多少语言，这些语言会被随机选择，如果-c被指定，则每一句的中间语言是随机的（一般不同），否则全文采用同种随机语言。
    -l languages
        指定生草链的中间语言，用英文逗号不带空格分隔这些语言，允许使用ran
        如果-t被指定且次数大于零，-l会被忽略
        e.g.
            "python ggp.py InputFile -l en,ja,ran" will iterate like:
                auto -> en -> ha -> (random) -> zh-CN
        语言代码见下方