Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/juftin/browsr
🗂️ a pleasant file explorer in your terminal supporting all filesystems
https://github.com/juftin/browsr
file-explorer python s3 textual tui
Last synced: about 2 months ago
JSON representation
🗂️ a pleasant file explorer in your terminal supporting all filesystems
- Host: GitHub
- URL: https://github.com/juftin/browsr
- Owner: juftin
- License: mit
- Created: 2023-05-03T05:26:39.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-11T01:43:34.000Z (2 months ago)
- Last Synced: 2024-04-12T07:19:55.810Z (2 months ago)
- Topics: file-explorer, python, s3, textual, tui
- Language: Python
- Homepage: http://juftin.com/browsr/
- Size: 13.7 MB
- Stars: 195
- Watchers: 4
- Forks: 10
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE
Lists
- cli-apps - browsr - A pleasant file explorer that can browse the contents of local and remote filesystems with your keyboard or mouse; remotes include GitHub, over SSH, in AWS S3, Google Cloud Storage, or Azure Blob Storage. (<a name="file-explorer"></a>File explorer and tree visualization)
- awesome-cli-apps - browsr - A pleasant file explorer that can browse the contents of local and remote filesystems with your keyboard or mouse; remotes include GitHub, over SSH, in AWS S3, Google Cloud Storage, or Azure Blob Storage. (<a name="file-explorer"></a>File explorer and tree visualization)
README
a pleasant file explorer in your terminal supporting all filesystems
**`browsr`** 🗂️ is a pleasant **file explorer** in your terminal. It's a command line **TUI**
(text-based user interface) application that empowers you to browse the contents of local
and remote filesystems with your keyboard or mouse.
You can quickly navigate through directories and peek at files whether they're hosted **locally**,
in **GitHub**, over **SSH**, in **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.
Screenshots
Screen Recording
https://user-images.githubusercontent.com/49741340/238535232-459847af-a15c-4d9b-91ac-fab9958bc74f.mp4
## Installation
It's recommended to use [pipx](https://pypa.github.io/pipx/) instead of pip. `pipx` installs the package in
an isolated environment and makes it available everywhere. If you'd like to use `pip` instead, just replace `pipx`
with `pip` in the below command.
```shell
pipx install browsr
```
### Extra Installation
If you're looking to use **`browsr`** on remote file systems, like GitHub or AWS S3, you'll need to install the `remote` extra.
If you'd like to browse parquet / feather files, you'll need to install the `data` extra. Or, even simpler,
you can install the `all` extra to get all the extras.
```shell
pipx install "browsr[all]"
```
## Usage
Simply give **`browsr`** a path to a local or remote file / directory.
[Check out the Documentation](https://juftin.com/browsr/) for more information
about the file systems supported.
### Local
```shell
browsr ~/Downloads/
```
### GitHub
```
browsr github://juftin:browsr
```
```
export GITHUB_TOKEN="ghp_1234567890"
browsr github://juftin:browsr-private@main
```
### Cloud
```shell
browsr s3://my-bucket
```
\*\* _Currently AWS S3, Google Cloud Storage, and Azure Blob Storage / Data Lake are supported._
### SSH / SFTP
```shell
browsr ssh://[email protected]:22
```
## License
**`browsr`** is distributed under the terms of the [MIT license](LICENSE).