# Install xplr with Homebrew, apk, MacPorts, Nix, pacman, zypper Hackable, minimal, fast TUI file explorer. Version 1.1.0 via Homebrew; verified 2026-06-22. ## Install ```sh sudo av install brew:xplr ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install xplr ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install xplr ``` Evidence: MacPorts ports tree: sysutils/xplr/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add xplr ``` Evidence: Alpine Linux edge package indexes: xplr from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Nix (92%): ```sh nix profile install nixpkgs#xplr ``` Evidence: nixpkgs package indexes: pkgs/by-name/xp/xplr/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S xplr ``` Evidence: Arch Linux sync databases: xplr from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install xplr ``` Evidence: openSUSE Tumbleweed package metadata: xplr from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:xplr - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.1.0 - **Source summary:** Hackable, minimal, fast TUI file explorer - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-22T14:06:42-07:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - xplr (cli) - xplr (alias) ## Dependencies - luajit ## Build dependencies - pkgconf - rust ## 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: 1.1.0 - Package-manager updated: 2026-06-22 - Local data: ok - Upstream repository: https://github.com/sayanarijit/xplr - Upstream latest detected: v1.1.0 (current) ## Project history and usage xplr is a Rust terminal file explorer built around hackability rather than replacing the shell. Its own documentation frames it as a keyboard-controlled, real-time interface that orchestrates existing file-system tools. ### Project history The project appeared in the early 2020s as a TUI file explorer in the same cultural space as nnn, fzf, ranger-like panes, and Neovim-style keyboard workflows. Its README says xplr is not meant to replace standard shell commands or GUI file managers, but to integrate them through a scriptable terminal interface. A key turning point was the v0.10 era in May 2021, when maintainer Sayanarijit announced that xplr had moved away from YAML and embraced embedded LuaJIT, explicitly citing Neovim as an inspiration. The stated reasons were portability, safer customization than shell snippets, richer scriptability, speed, and a plugin community model. The official upgrade guide marks v1.0.0 as the first stable release and says xplr v1 could be considered feature complete, with no immediate plan for v2. Subsequent development has focused on maintenance, performance, and incremental ergonomic features rather than repeatedly reshaping the tool. ### Adoption history xplr adoption is strongest among terminal-heavy users who want a visual navigator without leaving shell composition behind. The README points to Homebrew, crates.io, documentation, hacks, plugins, integrations, reviews, and Repology packaging, showing a project whose ecosystem is as much about configuration and plugins as the core binary. The official docs list many plugins and integrations: dual-pane and tri-pane layouts, fzf integration, clipboard support, terminal integration, tree view, disk-usage tools, drag-and-drop helpers, and a plugin manager. That is the real adoption story: users extend xplr into their terminal workflow rather than treating it as a fixed file manager. ### How it is used Users launch xplr inside a directory, navigate with modal key bindings, select paths, and either perform built-in file operations or hand paths to external commands. It can print selected paths or the current directory on quit, which makes it useful inside shell aliases and editor workflows. Configuration lives in Lua, usually at ~/.config/xplr/init.lua. The documented model exposes modes, messages, key bindings, layouts, hooks, and Lua function calls, so practical use often becomes a small personal TUI environment rather than a stock file browser. ### Why package nerds care xplr is a good example of the post-2010s terminal renaissance: Rust implementation, TUI ergonomics, Lua customization, Neovim influence, fzf-style searching, and package-manager distribution all in one small binary. For package catalogs, it sits between classic file managers and programmable launchers. Its significance is not mass desktop adoption; it is the way it packages a hackable terminal workflow that expects to collaborate with other command-line tools. ### Timeline - 2021-04-15: An early public tag, v0.4.4, is visible in repository history. - 2021-05-23: The maintainer announced the v0.10 move from YAML to embedded LuaJIT. - 2022-10-28: v0.20.0 entered the long 0.20/0.21 maturation period. - 2025-03-21: v1.0.0 was published as the first stable, feature-complete v1 release. - 2025-12-08: v1.1.0 shipped with no breaking changes and performance improvements for large directories. ### Related projects - nnn and fzf: terminal-navigation influences and related tools mentioned by the xplr community. - Neovim: the explicit model for embedding Lua to grow a customization and plugin ecosystem. - ranger-style pane file managers: a neighboring workflow represented by xplr plugins such as tri-pane.xplr. ### Sources - - - - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.config/xplr/init.lua, /etc/xplr/init.lua ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** xplr - **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 - xplr: normalized package name match | nixpkgs package indexes: pkgs/by-name/xp/xplr/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - xplr - 1.1.0-r0: normalized package name match | Alpine Linux edge package indexes: xplr from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Hackable, minimal, fast TUI file explorer | https://xplr.dev - apk - xplr-doc - 1.1.0-r0: normalized package name match | Alpine Linux edge package indexes: xplr-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Hackable, minimal, fast TUI file explorer (documentation) | https://xplr.dev - pacman - xplr - 1.0.1-1: normalized package name match | Arch Linux sync databases: xplr from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A hackable, minimal, fast TUI file explorer | https://github.com/sayanarijit/xplr - zypper - xplr - 1.0.1-1.3: normalized package name match | openSUSE Tumbleweed package metadata: xplr from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | TUI file explorer | https://github.com/sayanarijit/xplr - MacPorts - xplr: normalized package name match | MacPorts ports tree: sysutils/xplr/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [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. - [Productivity CLI packages](https://www.automicvault.com/pkg/productivity-cli-packages/) - Matched curated productivity category metadata from av.db. - [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider. - [luajit](https://www.automicvault.com/pkg/brew/luajit/) - Runtime dependency declared by Homebrew. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [lf](https://www.automicvault.com/pkg/brew/lf/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [midnight-commander](https://www.automicvault.com/pkg/brew/midnight-commander/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [projectable](https://www.automicvault.com/pkg/brew/projectable/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [superfile](https://www.automicvault.com/pkg/brew/superfile/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [yazi](https://www.automicvault.com/pkg/brew/yazi/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [ctpv](https://www.automicvault.com/pkg/brew/ctpv/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [far2l-tty](https://www.automicvault.com/pkg/brew/far2l-tty/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [fdclone](https://www.automicvault.com/pkg/brew/fdclone/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. ## Combined YAML source View the package source record on GitHub. [combined/xplr.yml](https://github.com/automic-vault/db/blob/main/combined/xplr.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - 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