# Install goodls with Homebrew CLI tool to download shared files and folders from Google Drive. Version 3.4.0 via Homebrew; verified 2026-06-01. ## Install ```sh sudo av install brew:goodls ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install goodls ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:goodls - **Package manager:** Homebrew - **Package manager page:** - **Version:** 3.4.0 - **Source summary:** CLI tool to download shared files and folders from Google Drive - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-01T07:56:29Z - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - goodls (cli) - goodls (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 3.4.0 - Package-manager updated: 2026-06-01 - Local data: ok - Upstream repository: https://github.com/tanaikech/goodls - Upstream latest detected: v3.4.0 (current) ## Project history and usage goodls is a Go CLI for downloading shared Google Drive files and folders. It is a niche but practical package: it turns a browser-heavy, sometimes fragile Google Drive download workflow into a repeatable command-line operation. ### Project history The repository was created on January 10, 2018, the same date the README's update history records v1.0.0 as the initial release. Early changes added stdin URL lists, large-file chunk saving, progress display, and folder downloads that preserve structure when an API key is supplied. The project continued to track Google Drive behavior changes. The update history records multiple fixes for changed large-file download specifications, a migration to newer Google Drive API client methods, and later work on concurrency, conflict handling, JSON output, proxy and retry behavior, Colab URL handling, and an MCP server mode. ### Adoption history goodls is distributed as a Homebrew formula and through GitHub release binaries. The README also documents building from source with go install, which keeps it available to Go users even when package-manager coverage is thin. Its adoption surface is narrower than general-purpose sync tools because it focuses on shared-file and shared-folder downloads rather than full Google Drive synchronization. That specificity is also the reason it is useful in scripts, CI jobs, data pulls, and agent workflows where OAuth setup would be heavy. ### How it is used Typical usage is `goodls -u URL` for public shared files without authentication. Entire shared folders require a Google Cloud API key, which can be passed on the command line or through GOODLS_APIKEY, and downloads can preserve folder structure. The README documents resumable large-file chunks, MIME filtering, output directory selection, conflict strategies, skip-on-error behavior, concurrency control, JSON output, proxy and retry options, and an MCP stdio server exposing a download tool. ### Why package nerds care goodls matters to package nerds as a highly specific web-service CLI: it packages the messy operational knowledge of Google Drive download URLs, warning pages, API-key folder listing, resumable chunks, and headless output into a single executable. The 2026 MCP mode also makes it an example of a traditional CLI being repurposed as an agent-callable tool while retaining normal shell usage. ### Timeline - 2018-01-10: Initial release recorded in README update history. - 2018: stdin URL lists, large-file chunk saving, progress display, folder downloads, API-key support, and Google Docs conversion were added across the 1.0 and 1.1 series. - 2022: v2.0.0 migrated to updated Google Drive API client methods. - 2023: v2.0.5 changed API-key large-file download handling after Drive behavior changes. - 2026-05: v3.2.0 introduced concurrency and multi-progress UI. - 2026-06: v3.3.x and v3.4.0 added conflict handling, MCP server support, proxy and retry options, JSON output, and Colab URL support. ### Related projects - Google Drive and the Google Drive API are the service surfaces goodls automates. - go-getfilelist appears in the README update history as a related library dependency used for Drive file listing. - rclone and gdown are adjacent tools in the broader command-line cloud-file download space, though goodls is narrower and Drive-share focused. ### Sources - - - - - ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** goodls - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [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. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [cloudpan189-go](https://www.automicvault.com/pkg/brew/cloudpan189-go/) - Shares av.db curated category or tags: cli, file-transfer, productivity. - [gdrive](https://www.automicvault.com/pkg/brew/gdrive/) - Shares av.db curated category or tags: cli, google-drive, productivity. - [googleworkspace-cli](https://www.automicvault.com/pkg/brew/googleworkspace-cli/) - Shares av.db curated category or tags: cli, google-drive, productivity. - [mcp-google-sheets](https://www.automicvault.com/pkg/brew/mcp-google-sheets/) - Shares av.db curated category or tags: cli, google-drive, productivity. - [megacmd](https://www.automicvault.com/pkg/brew/megacmd/) - Shares av.db curated category or tags: cli, file-transfer, productivity. - [megatools](https://www.automicvault.com/pkg/brew/megatools/) - Shares av.db curated category or tags: cli, file-transfer, productivity. - [a2ps](https://www.automicvault.com/pkg/brew/a2ps/) - Shares av.db curated category or tags: cli, productivity. - [abook](https://www.automicvault.com/pkg/brew/abook/) - Shares av.db curated category or tags: cli, productivity. ## Combined YAML source View the package source record on GitHub. [combined/goodls.yml](https://github.com/automic-vault/db/blob/main/combined/goodls.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 - cross-ecosystem install command graph