Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Install

Get it running in a minute

The command is xy. Run xy to open the current directory, or xy some/directory.

Ready-made binary

Download the archive for your system from the Releases page: Linux x86_64 or ARM64 (static, runs on any distribution) or Windows x86_64. Then put xy on your PATH:

tar xzf xy-*-x86_64-unknown-linux-musl.tar.gz
install -m 755 xy-*-x86_64-unknown-linux-musl/xy ~/.local/bin/

Each archive has a .sha256 next to it, to check with sha256sum -c.

Package (.deb or .rpm)

The releases from 0.5.0 on also have packages for Debian, Ubuntu, Fedora, RHEL, openSUSE and their derivatives, x86_64 or ARM64. They also install the menu entry, the icons and the man page:

sudo apt install ./xylem-fm_*_amd64.deb
sudo dnf install ./xylem-fm-*.x86_64.rpm

They come from the Releases page, not from a repository: to update, install the next one the same way.

With Cargo

Needs Rust, via rustup, and a C compiler. On crates.io Xylem is called xylem-fm:

cargo install xylem-fm

Or the latest code, straight from GitHub:

cargo install --git https://github.com/andrelnfernandes/xylem

There are also a menu entry and a man page (xy --man), and a shell function to end up in the directory you were in when you quit with Alt+Q.