# Install brename with Homebrew, scoop

Cross-platform command-line tool for safe batch renaming via regular expressions. Version 2.14.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:brename
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install brename
```

  Evidence: local Homebrew formula metadata

### Windows

- Scoop (92%):

```sh
scoop install main/brename
```

  Evidence: Scoop official bucket manifest trees: bucket/brename.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:brename
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/brename>
- **Version:** 2.14.0
- **Source summary:** Cross-platform command-line tool for safe batch renaming via regular expressions
- **Homepage:** <https://github.com/shenwei356/brename>
- **Repository:** <https://github.com/shenwei356/brename>
- **Upstream docs:** <https://github.com/shenwei356/brename#readme>
- **License:** MIT
- **Source archive:** <https://github.com/shenwei356/brename/archive/refs/tags/v2.14.0.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- brename (cli)
- brename (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: 2.14.0
- Local data: ok
- Upstream repository: https://github.com/shenwei356/brename
- Upstream latest detected: v2.14.0 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

brename is a Go command-line batch-renaming tool focused on safe regular-expression based file and directory renames. Its distinguishing features are dry runs, conflict detection, cross-platform path safety, filters, recursive operation, and undo support.

### Project history

The GitHub repository was created in September 2013. The README presents brename as a practical cross-platform tool for safely batch renaming files and directories via regular expression.

The project evolved around safety checks that plain mv or rename commands do not provide, such as detecting existing targets, newly overwritten paths, empty target paths, and Windows-problematic path endings.

### Adoption history

The official README lists prebuilt release binaries for Linux, macOS, and Windows, plus installation through Conda, Homebrew, Arch AUR, Scoop, and source builds. The input package facts also record Homebrew and Scoop packaging.

Its adoption is niche but practical: users who need repeatable bulk renames get a single static-style CLI rather than shelling together find, sed, mv, and platform-specific rename variants.

### How it is used

The README documents pattern replacement with -p and -r, dry-run mode, include and exclude filters, recursive operation, directory renaming, key-value replacement files, ascending-number replacements, extension preservation, listing matches, and undoing the last successful operation.

Cross-platform safety is a major usage theme. The README calls out case-insensitive filesystems such as FAT and NTFS and documents flags for case-insensitive or case-sensitive path handling.

### Why package nerds care

brename is not a foundational package, but it is a useful example of a modern single-purpose Go CLI that packages well across Homebrew, Scoop, Conda, and downloadable release archives.

For package maintainers, it sits in the long family of rename tools while emphasizing safety and portability rather than just exposing a regular-expression substitution primitive.

### Timeline

- 2013-09: The brename GitHub repository was created.
- 2025: Official repository metadata showed activity into August 2025.
- 2025: The README documented brename 2.14.0 release binaries for Linux, macOS, and Windows.

### Related projects

- Traditional Unix mv and rename commands are the simpler tools brename's safety checks are meant to improve upon.
- Go is the implementation language and source-build toolchain named by the README.
- Scoop and Homebrew are package-manager channels documented by the README and input facts.

### Sources

- <https://api.github.com/repos/shenwei356/brename>
- <https://github.com/shenwei356/brename#readme>
- <https://github.com/shenwei356/brename/releases>
- source_facts.package-manager


## 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:** brename
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Scoop - main/brename: normalized package name match | Scoop official bucket manifest trees: bucket/brename.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## 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.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [nomino](https://www.automicvault.com/pkg/brew/nomino/) - Shares av.db curated category or tags: batch-rename, cli, developer-tools, file-management.
- [f2](https://www.automicvault.com/pkg/brew/f2/) - Shares av.db curated category or tags: batch-rename, cli, developer-tools, file-management.
- [fclones](https://www.automicvault.com/pkg/brew/fclones/) - Shares av.db curated category or tags: cli, developer-tools, file-management.
- [chsrc](https://www.automicvault.com/pkg/brew/chsrc/) - Shares av.db curated category or tags: cli, cross-platform, developer-tools.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Shares av.db curated category or tags: cli, cross-platform, developer-tools.
- [energy](https://www.automicvault.com/pkg/brew/energy/) - Shares av.db curated category or tags: cli, cross-platform, developer-tools.
- [flatbuffers](https://www.automicvault.com/pkg/brew/flatbuffers/) - Shares av.db curated category or tags: cli, cross-platform, developer-tools.
- [fltk](https://www.automicvault.com/pkg/brew/fltk/) - Shares av.db curated category or tags: cli, cross-platform, developer-tools.

## Combined YAML source

View the package source record on GitHub. [combined/brename.yml](https://github.com/automic-vault/db/blob/main/combined/brename.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
