a pleasantfile explorer in your terminal supportingall filesystems

browsr 🗂️ is a pleasantfile explorer in your terminal. It's a command lineTUI(text-based user interface) application that empowers you to browse the contents of localand remote filesystems with your keyboard or mouse.

You can quickly navigate through directories and peek at files whether they're hostedlocally,inGitHub, overSSH, inAWS S3,Google Cloud Storage, orAzure Blob Storage. View code fileswith syntax highlighting, format JSON files, render images, convert data files to navigabledatatables, and more.

Installation#

It's recommended to usepipx instead of pip.pipx installs the package inan isolated environment and makes it available everywhere. If you'd like to usepip instead, just replacepipxwithpip in the below command.

pipxinstallbrowsr

Extra Installation#

If you're looking to usebrowsr on remote file systems, like GitHub or AWS S3, you'll need to install theremote extra.If you'd like to browse parquet / feather files, you'll need to install thedata extra. Or, even simpler,you can install theall extra to get all the extras.

pipxinstall"browsr[all]"

Usage#

Simply givebrowsr a path to a local or remote file / directory.Check out the Documentation for more informationabout the file systems supported.

Local#

browsr~/Downloads/

GitHub#

browsr github://juftin:browsr

export GITHUB_TOKEN="ghp_1234567890"browsr github://juftin:browsr-private@main

Cloud#

browsrs3://my-bucket

**Currently AWS S3, Google Cloud Storage, and Azure Blob Storage are supported.

SSH / SFTP#

browsrssh://[email protected]:22