Home

Awesome

got

GO GHCR AUR Go Report Card

Table of Contents

Demo - Usage - Features - Testing

go-translation (shortly got), a simple translator and text-to-speech app built on top of simplytranslate and lingvatranslate APIs. The interface is made with the awesome bubbletea tui library.

:warning: simplytranslate is currently down. I still kept it as a valid backend in the hope of a future comeback, by default got uses now lingvatranslate

Screenshots here

Disclaimer: this is my absolute first project in golang, so bugs and clunky code are expected…

The project is still a work-in-progress, breaking changes and heavy refactoring may happen

<a id="orgab62fc1"></a>

Demo

https://user-images.githubusercontent.com/58485208/166154625-7c5556bd-74aa-4425-a046-160ba793b792.mp4

<a id="orgfa2aa9c"></a>

Usage

With the go tool:

go install github.com/fedeztk/got/cmd/got@latest

Or from source:

# clone the repo
git clone https://github.com/fedeztk/got.git
# install manually 
make install

In both cases make sure that you have the go bin directory in your path:

export PATH="$HOME/go/bin:$PATH"

If you are an Arch user there is also an AUR package available:

paru -S go-translation-git
got            # use last used engine, default is google
got -e reverso # change engine to reverso
got -o -s en -t it "Hello World"          # use default (google)
got -o -e libre -s en -t it "Hello World" # use libre-translate

For more information check the help (got -h) <a id="org26baa6c"></a>

Features

<a id="org2744438"></a>

Testing

Development is done through docker, build the container with:

make docker-build

Check that the build went fine:

docker images | grep got

Test it with:

make docker-run

Pre-built Docker image available here