Repository files navigation

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.

Screenshots

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.

pipx install browsr

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.

pipx install"browsr[all]"

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

browsr~/Downloads/

browsr github://juftin:browsr

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

browsr s3://my-bucket

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

browsr ssh://username@example.com:22

browsr is distributed under the terms of theMIT license.