# Install gauth with Homebrew, apk

Google Authenticator in your terminal. Version 1.5.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:gauth
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install gauth
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add gauth
```

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

## Package facts

- **Package key:** brew:gauth
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/gauth>
- **Version:** 1.5.0
- **Source summary:** Google Authenticator in your terminal
- **Homepage:** <https://github.com/pcarrier/gauth>
- **Repository:** <https://github.com/pcarrier/gauth>
- **Upstream docs:** <https://github.com/pcarrier/gauth#readme>
- **License:** ISC
- **Source archive:** <https://github.com/pcarrier/gauth/archive/refs/tags/v1.5.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- gauth (cli)
- gauth (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.5.0
- Local data: ok
- Upstream repository: https://github.com/pcarrier/gauth
- Upstream latest detected: v1.5.0 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

gauth is a small command-line authenticator for time-based one-time passwords. Its README frames the project as a terminal replacement for Google Authenticator.

### Project history

The official GitHub repository was created in 2013 and is maintained as a Go command-line tool. The README documents installation through Homebrew or `go install`, a plain text account file, optional OpenSSL-based encryption, and compatibility reports for common services.

### Adoption history

Official adoption evidence is modest and mostly visible through packaging and repository activity. The tool is packaged by Homebrew and Alpine, and the README invites users to report additional service compatibility results.

### How it is used

Users store one secret per line in `~/.config/gauth.csv` using `name:secret` entries or otpauth URLs, restrict file permissions, and run `gauth` to display previous, current, and next codes. The CLI also supports printing a single key, bare output for scripting, adding and removing keys, and retrieving an account secret.

### Why package nerds care

gauth matters to package-manager users as a deliberately small security CLI: one binary plus a user-managed local secrets file. It represents the Unix preference for inspectable text configuration and shell-friendly output in a domain often dominated by mobile apps.

### Timeline

- 2013: The official GitHub repository was created.
- 2010s: The README documented use with Homebrew, Go installation, and multiple online services.
- 2020s: The project remains available as a packaged Go TOTP CLI.

### Related projects

- The README points users who need to interpret QR codes toward gauthQR. The project is conceptually related to Google Authenticator-compatible TOTP tools and the otpauth URI format.

### Sources

- <https://github.com/pcarrier/gauth>
- <https://github.com/pcarrier/gauth#readme>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** gauth
- **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

- apk - gauth - 1.5.0-r14: normalized package name match | Alpine Linux edge package indexes: gauth from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Replacement for Google Authenticator | https://github.com/pcarrier/gauth


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [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.
- [Security and crypto packages](https://www.automicvault.com/pkg/security-crypto-tools/) - Matched security, identity, cryptography, password, signing, or certificate metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [cotp](https://www.automicvault.com/pkg/brew/cotp/) - Shares av.db curated category or tags: authentication, cli, security, totp, two-factor-authentication.
- [google-authenticator-libpam](https://www.automicvault.com/pkg/brew/google-authenticator-libpam/) - Shares av.db curated category or tags: authentication, cli, security, totp, two-factor-authentication.
- [rsc_2fa](https://www.automicvault.com/pkg/brew/rsc-2fa/) - Shares av.db curated category or tags: authentication, cli, security, totp, two-factor-authentication.
- [duo_unix](https://www.automicvault.com/pkg/brew/duo-unix/) - Shares av.db curated category or tags: authentication, cli, security, two-factor-authentication.
- [oath-toolkit](https://www.automicvault.com/pkg/brew/oath-toolkit/) - Shares av.db curated category or tags: authentication, cli, security, totp.
- [steamguard-cli](https://www.automicvault.com/pkg/brew/steamguard-cli/) - Shares av.db curated category or tags: authentication, cli, security, totp.
- [totp-cli](https://www.automicvault.com/pkg/brew/totp-cli/) - Shares av.db curated category or tags: authentication, cli, security, totp.
- [cyrus-sasl](https://www.automicvault.com/pkg/brew/cyrus-sasl/) - Shares av.db curated category or tags: authentication, cli, security.

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- 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
