# Install fpp with Homebrew, apk, MacPorts, Nix

CLI program that accepts piped input and presents files for selection. Version 0.9.5 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:fpp
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install fpp
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install fpp
```

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

### Linux

- apk (92%):

```sh
sudo apk add fpp
```

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

- Nix (92%):

```sh
nix profile install nixpkgs#fpp
```

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

## Package facts

- **Package key:** brew:fpp
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/fpp>
- **Version:** 0.9.5
- **Source summary:** CLI program that accepts piped input and presents files for selection
- **Homepage:** <https://facebook.github.io/PathPicker/>
- **Repository:** <https://github.com/facebook/PathPicker>
- **Upstream docs:** <https://facebook.github.io/PathPicker>
- **License:** MIT
- **Source archive:** <https://github.com/facebook/PathPicker/archive/refs/tags/0.9.5.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- fpp (cli)
- fpp (alias)

## Uses from macOS

- python

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

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

Facebook PathPicker is a command-line tool, installed as fpp, that parses piped terminal output for file paths and presents an interactive selector. The official README frames it as a solution to the common shell problem of selecting files from command output.

### Project history

PathPicker was published by Facebook with a GitHub Pages site and repository documentation. The project combines a shell entry point with small Python modules: it parses noisy input with regular expressions, shows a curses selector UI, then emits commands for the shell wrapper to execute.

The GitHub release history starts in 2015, with frequent early releases through 0.6.x and 0.7.x, community bug-fix releases in 2019, and a 2022 release. The official site credits Facebook / Peter Cottle in its metadata.

### Adoption history

The README presents Homebrew as the easiest macOS installation path with brew install fpp, describes Debian packaging steps, links an Arch AUR package, and documents manual installation by symlinking the fpp script into /usr/local/bin. It also notes supported shells including Bash, Zsh, csh, fish, and rc, and links a tmux-fpp add-on.

### How it is used

PathPicker is typically inserted at the end of a pipeline, for example git status | fpp, git grep | fpp, grep -r | fpp, git diff --stat | fpp, find output | fpp, or arc inlines | fpp. Selected files can be opened in $EDITOR or passed into an arbitrary command with the selected paths appended or substituted through the $F token.

### Why package nerds care

PathPicker is a neat Unix-package example because it does not replace git, grep, find, or editors; it adds an interactive file-selection layer to existing pipelines. Its value is the small fpp command and its shell integration, making it memorable among terminal UI tools packaged by Homebrew and Linux distributions.

### Timeline

- 2015: Public GitHub releases began with the 0.5.x series.
- 2015: Version 0.6.0 was published as a larger update.
- 2015: Version 0.7.0 added stability and AllInput mode.
- 2017: Version 0.7.2 was published.
- 2019: Version 0.9.2 switched to Python 3 by default.
- 2022: Version 0.9.5 was published as a later maintenance release.

### Related projects

- The README names tmux-fpp as an add-on and shows PathPicker as a companion to git, Mercurial, grep, find, arc, shell pipelines, and the user's editor.

### Sources

- <https://api.github.com/repos/facebook/PathPicker/releases?per_page=20>
- <https://facebook.github.io/PathPicker/>
- <https://raw.githubusercontent.com/facebook/PathPicker/master/README.md>


## 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:** fpp
- **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

- Nix - fpp: normalized package name match | nixpkgs package indexes: pkgs/by-name/fp/fpp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - fpp - 0.9.5-r0: normalized package name match | Alpine Linux edge package indexes: fpp from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | TUI that lets you pick paths out of its stdin and run arbitrary commands on them | https://facebook.github.io/PathPicker
- apk - fpp-doc - 0.9.5-r0: normalized package name match | Alpine Linux edge package indexes: fpp-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | TUI that lets you pick paths out of its stdin and run arbitrary commands on them (documentation) | https://facebook.github.io/PathPicker
- MacPorts - fpp: normalized package name match | MacPorts ports tree: devel/fpp/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.
- [newt](https://www.automicvault.com/pkg/brew/newt/) - Shares av.db curated category or tags: cli, developer-tools, terminal, terminal-ui.
- [termscp](https://www.automicvault.com/pkg/brew/termscp/) - Shares av.db curated category or tags: cli, developer-tools, terminal, terminal-ui.
- [aha](https://www.automicvault.com/pkg/brew/aha/) - Shares av.db curated category or tags: cli, developer-tools, terminal.
- [amtterm](https://www.automicvault.com/pkg/brew/amtterm/) - Shares av.db curated category or tags: cli, developer-tools, terminal.
- [ansifilter](https://www.automicvault.com/pkg/brew/ansifilter/) - Shares av.db curated category or tags: cli, developer-tools, terminal.
- [ccat](https://www.automicvault.com/pkg/brew/ccat/) - Shares av.db curated category or tags: cli, developer-tools, terminal.
- [claude-squad](https://www.automicvault.com/pkg/brew/claude-squad/) - Shares av.db curated category or tags: cli, developer-tools, terminal.
- [clive](https://www.automicvault.com/pkg/brew/clive/) - Shares av.db curated category or tags: cli, developer-tools, terminal.
- [watchman](https://www.automicvault.com/pkg/brew/watchman/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, file, files.
- [f2](https://www.automicvault.com/pkg/brew/f2/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tool, developer-tools, file.

## Combined YAML source

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