# Install gyb with Homebrew, Nix, winget CLI for backing up and restoring Gmail messages. Version 1.95 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:gyb ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install gyb ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#gyb ``` Evidence: nixpkgs package indexes: pkgs/by-name/gy/gyb/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ### Windows - winget (92%): ```sh winget install --id GAM-Team.GotYourBack -e ``` Evidence: Windows Package Manager source index: GAM-Team.GotYourBack from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:gyb - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.95 - **Source summary:** CLI for backing up and restoring Gmail messages - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - gyb (cli) - gyb (alias) ## Dependencies - certifi - python@3.14 ## Install behavior - Post-install hook: not defined - Caveats: Default config_folder: $HOMEBREW_PREFIX/etc/gyb - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sequoia, sonoma, tahoe, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.95 - Local data: ok - Upstream repository: https://github.com/GAM-team/got-your-back - Upstream latest detected: v1.95 (current) - info: No package-manager update timestamp was available. ## Project history and usage Got Your Back, usually called GYB, is a command-line backup and restore tool for Gmail and Google Workspace mailboxes. Its historical niche is the gap between consumer Gmail export tools, Google Workspace administration, and scriptable local mail preservation. ### Project history The GYB repository identifies the tool as maintained by Jay Lee and describes it as a command-line program for backing up Gmail messages to a local computer using Gmail's API over HTTPS. GitHub repository metadata records the public GAM-team repository as created in June 2014, and the README preserves the earlier jay0lee project links in its release and wiki references. The project documentation grew around practical setup and recovery tasks rather than a large library API. The wiki walks users through creating a Google Cloud project, granting Gmail access, running estimates, backing up, restoring, using Gmail searches for selective backups, and supporting Google Workspace administrator scenarios. ### Adoption history GYB adoption tracks administrators and power users who need command-line control over Gmail exports and restores. The project offers Windows installers and Mac/Linux shell installation instructions, while the supplied package facts show Homebrew, Nix, and winget packages, giving it reach across the operating systems commonly used by Google Workspace administrators. The wiki's emphasis on Gmail.com, Google Workspace, service accounts, Vault, mbox restore, selective search, and daily incremental backup patterns shows why the tool became useful beyond one-off personal backup: it could be scripted into migration, retention, and audit-adjacent workflows. ### How it is used The core usage is `gyb --email user@example.com --action backup` to download messages to a local folder, followed by restore commands that can restore to the same mailbox or a different mailbox when a backup folder is supplied. The wiki also documents estimates, label operations, mbox and EML restore, quota checks, service-account modes, and Gmail search filters for scoped backups. GYB's command-line design is important because Gmail's web UI and Takeout workflows are not shaped for repeatable administrator automation. GYB gives package-managed environments a small executable that can sit in scripts, scheduled jobs, migration runbooks, and support procedures. ### Why package nerds care GYB is a package-nerd kind of productivity tool: thin, scriptable, API-backed, and valuable precisely because it turns a cloud service workflow into a reproducible local command. It also brings the usual packaging concerns for OAuth-era CLIs, including installers, Python/runtime expectations, local backup folders, and user-provided Google credentials. Its relationship to the GAM ecosystem matters because GAM is a well-known Google Workspace administration CLI. GYB is not just another mail downloader; it is part of a cluster of tools used by admins who prefer shellable workflows for Google services. ### Timeline - 2014: The public GAM-team GitHub repository was created. - 2010s: GYB documentation centered on Gmail API over HTTPS backups, local restore, and Google Groups support. - 2020s: The wiki documented Google Workspace naming, Google Cloud project setup, service-account options, Vault, mbox and EML restore, and selective Gmail-search backups. - 2020s: Package-manager coverage included Homebrew, Nix, and winget according to the supplied package facts. ### Related projects - GYB is related to GAM and the broader GAM-team Google Workspace administration ecosystem. It also overlaps with Google Takeout, Google Vault exports, Gmail API tooling, mbox/EML mail utilities, and administrator migration scripts. ### Sources - - - - - ## 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:** gyb - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - gyb: normalized package name match | nixpkgs package indexes: pkgs/by-name/gy/gyb/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - winget - GAM-Team.GotYourBack: normalized package name match | Windows Package Manager source index: GAM-Team.GotYourBack from https://cdn.winget.microsoft.com/cache/source.msix ## 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. - [Archive and compression packages](https://www.automicvault.com/pkg/archive-compression-tools/) - Matched archive or compression metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [evernote-backup](https://www.automicvault.com/pkg/brew/evernote-backup/) - Shares av.db curated category or tags: backup, cli, productivity. - [gmailctl](https://www.automicvault.com/pkg/brew/gmailctl/) - Shares av.db curated category or tags: cli, email, gmail, productivity. - [grsync](https://www.automicvault.com/pkg/brew/grsync/) - Shares av.db curated category or tags: backup, cli, productivity. - [icloudpd](https://www.automicvault.com/pkg/brew/icloudpd/) - Shares av.db curated category or tags: backup, cli, productivity. - [imap-backup](https://www.automicvault.com/pkg/brew/imap-backup/) - Shares av.db curated category or tags: cli, email, gmail, productivity. - [neverest](https://www.automicvault.com/pkg/brew/neverest/) - Shares av.db curated category or tags: backup, cli, email, productivity. - [pinboard-notes-backup](https://www.automicvault.com/pkg/brew/pinboard-notes-backup/) - Shares av.db curated category or tags: backup, cli, productivity. - [aerc](https://www.automicvault.com/pkg/brew/aerc/) - Shares av.db curated category or tags: cli, email, productivity. - [offlineimap](https://www.automicvault.com/pkg/brew/offlineimap/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, email, productivity, python. ## Combined YAML source View the package source record on GitHub. [combined/gyb.yml](https://github.com/automic-vault/db/blob/main/combined/gyb.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