Command Line Interface#

browsr#

browsr 🗂️ a pleasant file explorer in your terminal

Navigate through directories and peek at files whether they're hosted locally,over SSH, in GitHub, AWS S3, Google Cloud Storage, or Azure Blob Storage.View code files with syntax highlighting, format JSON files, render images,convert data files to navigable datatables, and more.

Installation#

It's recommended to installbrowsr viapipxwithall optional dependencies, this enablesbrowsr to accessremote cloud storage buckets and open parquet files.

pipxinstall"browsr[all]"

Usage Examples#

Local#

Browse your current working directory#

browsr

Browse a local directory#

browsr/path/to/directory

Cloud Storage#

Browse an S3 bucket#

browsrs3://bucket-name

Browse a GCS bucket#

browsrgs://bucket-name

Browse Azure Services#

browsradl://bucket-namebrowsraz://bucket-name

Pass Extra Arguments to Cloud Storage#

Some cloud storage providers require extra arguments to be passed to thefilesystem. For example, to browse an anonymous S3 bucket, you need to passtheanon=True argument to the filesystem. This can be done with the-k/--kwargsargument.

browsrs3://anonymous-bucket-kanon=True

GitHub#

Browse a GitHub repository#

browsrgithub://juftin:browsr

Browse a GitHub Repository Branch#

browsrgithub://juftin:browsr@main

Browse a Private GitHub Repository#

exportGITHUB_TOKEN="ghp_1234567890"browsrgithub://juftin:browsr-private@main

Browse a GitHub Repository Subdirectory#

browsrgithub://juftin:browsr@main/tests

Browse a GitHub URL#

browsrhttps://github.com/juftin/browsr

Browse a Filesystem over SSH#

browsr ssh://user@host:22

Browse a SFTP Server#

browsr sftp://user@host:22/path/to/directory

Key Bindings#

• Q - Quit the application
• F - Toggle the file tree sidebar
• T - Toggle the rich theme for code formatting
• N - Toggle line numbers for code formatting
• D - Toggle dark mode for the application
• . - Parent Directory - go up one directory
• R - Reload the current directory
• C - Copy the current file or directory path to the clipboard
• X - Download the file from cloud storage

Usage:

browsr [OPTIONS] PATH

Options: