# Install translate-shell with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper

Command-line translator using Google Translate and more. Version 0.9.7.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:translate-shell
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install translate-shell
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install translate-shell
```

  Evidence: MacPorts ports tree: textproc/translate-shell/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add translate-shell
```

  Evidence: Alpine Linux edge package indexes: translate-shell from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install translate-shell
```

  Evidence: Debian stable package indexes: translate-shell from https://deb.debian.org/debian/dists/stable/contrib/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install translate-shell
```

  Evidence: Fedora Rawhide package metadata: translate-shell from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#translate-shell
```

  Evidence: nixpkgs package indexes: pkgs/by-name/tr/translate-shell/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S translate-shell
```

  Evidence: Arch Linux sync databases: translate-shell from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install translate-shell
```

  Evidence: openSUSE Tumbleweed package metadata: translate-shell from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:translate-shell
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/translate-shell>
- **Version:** 0.9.7.1
- **Source summary:** Command-line translator using Google Translate and more
- **Homepage:** <https://www.soimort.org/translate-shell>
- **Repository:** <https://github.com/soimort/translate-shell>
- **Upstream docs:** <https://www.soimort.org/translate-shell>
- **License:** Unlicense
- **Source archive:** <https://github.com/soimort/translate-shell/archive/refs/tags/v0.9.7.1.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- trans (cli)
- trans (alias)

## Dependencies

- fribidi
- gawk
- rlwrap

## Install behavior

- Post-install hook: not defined
- Caveats: By default, text-to-speech functionality is provided by macOS's builtin `say' command. This functionality may be improved in certain cases by installing one of mplayer, mpv, or mpg123, all of which are available through `brew install'.
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.9.7.1
- Local data: ok
- Upstream repository: https://github.com/soimort/translate-shell
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

Translate Shell is a POSIX-oriented command-line translator, distributed as the `trans` command, that queries online translation engines from a terminal. It began under the name Google Translate CLI and later broadened into a multi-engine tool.

### Project history

The official README identifies Translate Shell as formerly Google Translate CLI and describes Google Translate as the default engine, with Bing Translator, Yandex.Translate, and Apertium also supported. The tool is implemented around GNU Awk plus a shell wrapper, which made it unusually portable for a network-facing terminal utility.

The project documents multiple installation styles: a self-contained downloadable executable, package-manager installation, Zsh Antigen integration, Git builds, and Docker. Official release metadata shows the 0.9.6 line active through the late 2010s and the 0.9.7 line released in 2022 and 2023.

### Adoption history

Translate Shell became a package-manager staple because it solved a common terminal-user problem without requiring a browser or GUI. Its README says it works on GNU/Linux, macOS, BSD, Android through Termux, and Windows through WSL, Cygwin, or MSYS2, and the input facts show packaging across Homebrew, Debian, Ubuntu, Fedora, Arch, Alpine, MacPorts, Nix, and openSUSE.

The tool's adoption also reflects shell culture: it can translate command arguments, standard input, multi-line text, or interactive shell input, and optional dependencies such as rlwrap, paging tools, text-to-speech programs, and spell checkers improve the terminal experience without becoming mandatory.

### How it is used

Users call `trans` with source and target language expressions, such as `:fr`, `en:zh`, or multiple target languages joined with plus signs. It supports verbose output, brief mode, dictionary mode, language identification, interactive shell mode, standard input, and optional display handling for bidirectional scripts.

### Why package nerds care

For package nerds, Translate Shell is the classic example of turning a web translation service into a Unix filter. It is small enough to install everywhere, scriptable enough for dotfiles and editor hooks, and packaged widely enough that the same `trans` muscle memory works across Linux distributions and macOS.

Its Awk implementation and self-contained executable also make it a useful case study in packaging network-dependent command-line tools: the binary-like script is easy to distribute, while optional dependencies and upstream web-service changes are where maintainers feel the operational cost.

### Timeline

- Early project: The README states that Translate Shell was formerly Google Translate CLI.
- 2017-2020: Official GitHub releases show the 0.9.6 series continuing through several maintenance releases.
- 2022: Official GitHub releases list version 0.9.7.
- 2023: The official man page and GitHub releases list version 0.9.7.1.

### Related projects

- Translate Shell is related to online translation engines such as Google Translate, Bing Translator, Yandex.Translate, and Apertium. In packaging terms it also sits near terminal dictionary, text-to-speech, and shell productivity tools.

### Sources

- <https://api.github.com/repos/soimort/translate-shell/releases>
- <https://github.com/soimort/translate-shell#readme>
- <https://www.soimort.org/translate-shell>
- <https://www.soimort.org/translate-shell/trans.1.html>
- source_facts.package-manager


## Security Notes

generalized runtime or code generation signal.

- **Geiger risk:** yellow / medium
- generalized runtime or code generation signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.translate-shell/init.trans, $XDG_CONFIG_HOME/translate-shell/init.trans
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** translate-shell
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - translate-shell - 0.9.7.1-2: normalized package name match | Debian stable package indexes: translate-shell from https://deb.debian.org/debian/dists/stable/contrib/binary-amd64/Packages.xz | Command-line translator using Google Translate, etc. | https://github.com/soimort/translate-shell
- Nix - translate-shell: normalized package name match | nixpkgs package indexes: pkgs/by-name/tr/translate-shell/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - translate-shell - 0.9.7.1-2: normalized package name match | Ubuntu 24.04 LTS package indexes: translate-shell from https://archive.ubuntu.com/ubuntu/dists/noble/multiverse/binary-amd64/Packages.gz | Command-line translator using Google Translate, etc. | https://github.com/soimort/translate-shell
- apk - translate-shell - 0.9.7.1-r2: normalized package name match | Alpine Linux edge package indexes: translate-shell from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Command-line online translator | https://www.soimort.org/translate-shell/
- apk - translate-shell-doc - 0.9.7.1-r2: normalized package name match | Alpine Linux edge package indexes: translate-shell-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Command-line online translator (documentation) | https://www.soimort.org/translate-shell/
- dnf - translate-shell - 0.9.7.1-8.fc44: normalized package name match | Fedora Rawhide package metadata: translate-shell from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | A command-line online translator | https://github.com/soimort/translate-shell
- pacman - translate-shell - 0.9.7.1-2: normalized package name match | Arch Linux sync databases: translate-shell from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A command-line interface and interactive shell for Google Translate | https://www.soimort.org/translate-shell/
- zypper - translate-shell - 0.9.7.1-1.6: normalized package name match | openSUSE Tumbleweed package metadata: translate-shell from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Command line translator using various online services as backends | https://www.soimort.org/translate-shell
- MacPorts - translate-shell: normalized package name match | MacPorts ports tree: textproc/translate-shell/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Productivity CLI packages](https://www.automicvault.com/pkg/productivity-cli-packages/) - Matched curated productivity category metadata from av.db.
- [fribidi](https://www.automicvault.com/pkg/brew/fribidi/) - Runtime dependency declared by Homebrew.
- [gawk](https://www.automicvault.com/pkg/brew/gawk/) - Runtime dependency declared by Homebrew.
- [rlwrap](https://www.automicvault.com/pkg/brew/rlwrap/) - Runtime dependency declared by Homebrew.
- [fanyi](https://www.automicvault.com/pkg/brew/fanyi/) - Shares av.db curated category or tags: cli, productivity, translation.
- [gtranslator](https://www.automicvault.com/pkg/brew/gtranslator/) - Shares av.db curated category or tags: cli, productivity, translation.
- [abook](https://www.automicvault.com/pkg/brew/abook/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [aerc](https://www.automicvault.com/pkg/brew/aerc/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [alot](https://www.automicvault.com/pkg/brew/alot/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [alpine](https://www.automicvault.com/pkg/brew/alpine/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [amp](https://www.automicvault.com/pkg/brew/amp/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [bagels](https://www.automicvault.com/pkg/brew/bagels/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [bartib](https://www.automicvault.com/pkg/brew/bartib/) - Local package facts share a topical domain. Shared terms: cli, command-line, line, productivity, terminal.
- [clac](https://www.automicvault.com/pkg/brew/clac/) - Local package facts share a topical domain. Shared terms: cli, command-line, line, productivity, terminal.

## Combined YAML source

View the package source record on GitHub. [combined/translate-shell.yml](https://github.com/automic-vault/db/blob/main/combined/translate-shell.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
