https://github.com/sheepla/strans
π A command line translate tool with interactive mode inspired by translate-shell
https://github.com/sheepla/strans
cli go-cli lingva lingva-translate repl translate translate-cli translate-shell
Last synced: 10 months ago
JSON representation
π A command line translate tool with interactive mode inspired by translate-shell
- Host: GitHub
- URL: https://github.com/sheepla/strans
- Owner: sheepla
- License: mit
- Created: 2022-12-29T11:52:22.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2023-08-05T13:17:17.000Z (over 2 years ago)
- Last Synced: 2025-04-06T00:51:10.451Z (11 months ago)
- Topics: cli, go-cli, lingva, lingva-translate, repl, translate, translate-cli, translate-shell
- Language: Go
- Homepage:
- Size: 65.4 KB
- Stars: 33
- Watchers: 1
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/sheepla/strans/actions/workflows/ci.yml)
[](https://github.com/sheepla/strans/actions/workflows/release.yml)
# strans
A command line translate tool written in Go with GNU Readline-like interactive mode (`--repl`) inspired by [translate-shell](https://github.com/soimort/translate-shell)
[](https://github.com/sheepla/strans/releases/latest)
## Features
- **Non-interactive mode**: A mode that can be used in the same way as a general command line tool
- **Interactive mode**: [GNU Readline](https://en.wikipedia.org/wiki/GNU_Readline)-like line editing mode for instant translation
- **Read translated text aloud**: The option to read the translated text aloud after performing the translation
## Usage
### Specifying languages for translations source and targets
To specify the translation source/target language, specify values for the arguments of the `-s`, `--source` and `-t`, `--target` options, or set values in the environment variable `STRANS_SOURCE_LANG`, `STRANS_TARGET_LANG`.
If you specify `?` as the `--source` or `--target` option's value, a fzf-like menu will be displayed, allowing you to interactively select the language.
To check the list of languages, run the command with `-S`, `--list-source` or `-T`, `--list-target` options.
### Non-interactive mode
If you specify text as a non-option argument, that text will be translated. Multiple arguments are allowed, and arguments are joined by spaces.
```
strans [OPTIONS] TEXT...
# e.g.
strans -s en -t ja "Hello, World" # => "γγγ«γ‘γ―δΈη"
```
A non-option argument of `-` will read text from standard input and translate it.
You can also output the translated text as speech.
```
strans [OPTIONS] -
# e.g.
echo "Hello, World" | strans -s en -t ja - # => "γγγ«γ‘γ―δΈη"
strans -s en -t ja < README.md # => The contents of the README.md will translated.
```
### Interactive mode
To use interactive mode, run the command with the `-r`, `--repl` flag.
Enter your text and it will be translated instantly.
You can use GNU Readline-like line editing, scroll back (`Ctrl-N`, `Ctrl-P`) and incremental search (`Ctrl-R`) the execution history.
Empty inputs (just typing `Enter`) are ignored and no translation is performed.
Typing `Ctrl-D` exits interactive mode and returns you to the shell you were running from.
The history is kept in the file `strans_history.txt` in the OS temporary directory
and can be recalled when executing the command again.
```
[you@your-computer]$ strans --repl -s ja -t en
[ja -> en]
> γγγ«γ‘γ―δΈη
hello world
[ja -> en]
> bye
[you@your-computer]$
```
### Read text as speech (beta)
Running the command with the `--audio` flag, after executing the translation, read the translated text aloud and you can check the pronunciation.
This feature is available in both interactive and non-interactive mode.
### Options
Specify the source language name (e.g. `en`, `ja`, etc.) for `--source` option, and specify the target language name for `--target` option.
To change the instance, specify the hostname of the instance in the `--instance` option.
```
NAME:
strans - a command line translate tool with GNU Readline like interactive mode
USAGE:
strans [OPTIONS] TEXT...
echo TEXT... | strans [OPTIONS] -
strans [OPTIONS] - < FILE
VERSION:
unknown-unknown
COMMANDS:
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--source value, -s value, --from value Source language to translate; specifying the value '?' will shows a selectable menu [$STRANS_SOURCE_LANG]
--target value, -t value, --to value Target language to translate; specifying the value '?' will shows a selectable menu [$STRANS_TARGET_LANG]
--instance value, -i value Instance host name of Lingva Translate [$STRANS_INSTANCE]
--repl, -r Start interactive mode (default: false)
--audio, -a Read translated text aloud (default: false)
--list-source, -S Show a list of source languages (default: false)
--list-target, -T Show a list of target languages (default: false)
--help, -h show help (default: false)
--version, -v print the version (default: false)
```
Various options can specify default values not only from command line arguments,
but also by setting environment variables.
```sh
STRANS_TARGET_LANG="ja" strans "Hello, World" # => "γγγ«γ‘γ―δΈη"
export STRANS_SOURCE_LANG="en"
export STRANS_TARGET_LANG="ja"
strans "Hello, World" # => γγγ«γ‘γ―δΈη
```
This tool is a program that calls Lingva Translate's public API.
See the Lingva Translate [README.md](https://github.com/thedaviddelta/lingva-translate/blob/main/README.md) for details.
## Installation
```sh
go install github.com/sheepla/strans@latest
```
## Roadmap
- [ ] Distribute pre-built binaries on GitHub release page
- [ ] Print more translate info (definitions, similar words, examples, pronunciation, etc.)
## Thanks
- [lingva-translate](https://github.com/thedaviddelta/lingva-translate)
- [translate-shell](https://github.com/soimort/translate-shell)