# Install fzy with Homebrew, apk, apt, MacPorts, Nix, pacman, zypper

Fast, simple fuzzy text selector with an advanced scoring algorithm. Version 1.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:fzy
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install fzy
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install fzy
```

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

### Linux

- apk (92%):

```sh
sudo apk add fzy
```

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

- Debian apt (92%):

```sh
sudo apt install fzy
```

  Evidence: Debian stable package indexes: fzy from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#fzy
```

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

- pacman (92%):

```sh
sudo pacman -S fzy
```

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

- zypper (92%):

```sh
sudo zypper install fzy
```

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

## Package facts

- **Package key:** brew:fzy
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/fzy>
- **Version:** 1.1
- **Source summary:** Fast, simple fuzzy text selector with an advanced scoring algorithm
- **Homepage:** <https://github.com/jhawthorn/fzy>
- **Repository:** <https://github.com/jhawthorn/fzy>
- **Upstream docs:** <https://github.com/jhawthorn/fzy#readme>
- **License:** MIT
- **Source archive:** <https://github.com/jhawthorn/fzy/archive/refs/tags/1.1.tar.gz>
- **Generated:** 2026-07-09T07:20:21+00:00

## Executables

- fzy (cli)
- fzy (alias)

## 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-09
- Package-manager version: 1.1
- Local data: ok
- Upstream repository: https://github.com/jhawthorn/fzy
- Upstream latest detected: 1.1 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

fzy is a small fuzzy text selector for the terminal, written in C, with an emphasis on speed, simplicity, and scoring quality. Its README presents it as both a command-line selector and an editor-plugin building block.

### Project history

The repository was created in July 2014, and GitHub Releases show early 0.x releases in October 2014. The README positions fzy against fzf, pick, selecta, ctrlp, and similar tools, arguing that its scoring favors consecutive letters and word starts rather than merely short matches.

The 1.0 release was published in 2018, and the fzy 1.1 man page is dated July 2025. The man page describes the stable core interface: read newline-separated items from stdin, show a terminal menu, narrow with fuzzy matching, and print the selected item to stdout.

### Adoption history

The upstream README documents installation through Homebrew, MacPorts, Arch Linux/MSYS2 pacman, FreeBSD pkg, Gentoo Portage, Ubuntu/Debian apt, pkgsrc, openSUSE zypper, and source builds. That breadth reflects fzy's role as a compact Unix-style filter that distribution maintainers can package easily.

### How it is used

fzy is normally used as a filter in shell pipelines, for example `ls | fzy`, `vi $(find -type f | fzy)`, choosing a directory to `cd` into, selecting a process to kill, or selecting a Git branch. The README also gives Vim integration examples that pipe file lists through fzy and then open the selected file.

### Why package nerds care

fzy is significant as the minimal C member of the fuzzy-finder family: it exposes the classic stdin-to-stdout Unix interface, has a documented scoring algorithm, avoids a large runtime, and is small enough to be carried by many Unix package systems.

### Timeline

- 2014: GitHub repository created.
- 2014: Releases 0.1 and 0.2 published.
- 2018: Release 1.0 published.
- 2025: Release v1.1 published and man page dated for fzy 1.1.

### Related projects

- The README compares fzy with fzf, pick, selecta, and ctrlp, and lists fzy.js as a JavaScript port. Its Vim usage examples place it in the same editor-workflow space as older fuzzy file selectors.

### Sources

- <https://api.github.com/repos/jhawthorn/fzy>
- <https://github.com/jhawthorn/fzy>
- <https://github.com/jhawthorn/fzy/releases>
- <https://raw.githubusercontent.com/jhawthorn/fzy/master/README.md>
- <https://raw.githubusercontent.com/jhawthorn/fzy/master/fzy.1>


## 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:** fzy
- **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 - fzy - 1.0-1: normalized package name match | Debian stable package indexes: fzy from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | fast, simple fuzzy text selector | https://github.com/jhawthorn/fzy
- Nix - fzy: normalized package name match | nixpkgs package indexes: pkgs/by-name/fz/fzy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - fzy - 1.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: fzy from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | fast, simple fuzzy text selector | https://github.com/jhawthorn/fzy
- apk - fzy - 1.1-r1: normalized package name match | Alpine Linux edge package indexes: fzy from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A better fuzzy finder | https://github.com/jhawthorn/fzy
- apk - fzy-doc - 1.1-r1: normalized package name match | Alpine Linux edge package indexes: fzy-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A better fuzzy finder (documentation) | https://github.com/jhawthorn/fzy
- pacman - fzy - 1.1-1: normalized package name match | Arch Linux sync databases: fzy from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A better fuzzy finder | https://github.com/jhawthorn/fzy
- zypper - fzy - 1.1-1.3: normalized package name match | openSUSE Tumbleweed package metadata: fzy from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | A fuzzy text selector | https://github.com/jhawthorn/fzy
- MacPorts - fzy: normalized package name match | MacPorts ports tree: devel/fzy/Portfile from https://api.github.com/repos/macports/macports-ports/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.
- [fzf](https://www.automicvault.com/pkg/brew/fzf/) - Shares av.db curated category or tags: cli, developer-tools, fuzzy-finder, search, terminal.
- [ddgr](https://www.automicvault.com/pkg/brew/ddgr/) - Shares av.db curated category or tags: cli, developer-tools, search, terminal.
- [fuzzy-find](https://www.automicvault.com/pkg/brew/fuzzy-find/) - Shares av.db curated category or tags: c, cli, developer-tools, fuzzy-finder, search.
- [sk](https://www.automicvault.com/pkg/brew/sk/) - Shares av.db curated category or tags: cli, developer-tools, fuzzy-finder, search, terminal.
- [teip](https://www.automicvault.com/pkg/brew/teip/) - Shares av.db curated category or tags: cli, developer-tools, terminal, unix.
- [cgvg](https://www.automicvault.com/pkg/brew/cgvg/) - Shares av.db curated category or tags: cli, developer-tools, search, vim.
- [chalk-cli](https://www.automicvault.com/pkg/brew/chalk-cli/) - Shares av.db curated category or tags: cli, developer-tools, terminal.
- [chars](https://www.automicvault.com/pkg/brew/chars/) - Shares av.db curated category or tags: cli, developer-tools, terminal.
- [selecta](https://www.automicvault.com/pkg/brew/selecta/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, finder, fuzzy.

## Combined YAML source

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