Metadata-Version: 2.1
Name: browsr
Version: 1.2.2
Summary: TUI File Browser App
Project-URL: Documentation, https://github.com/juftin/browsr#readme
Project-URL: Issues, https://github.com/juftin/browsr/issues
Project-URL: Source, https://github.com/juftin/browsr
Author-email: Justin Flannery <justin.flannery@juftin.com>
License-Expression: MIT
License-File: LICENSE.txt
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: <4.0,>=3.8
Requires-Dist: art~=5.7
Requires-Dist: click~=8.1.3
Requires-Dist: fsspec~=2023.1.0
Requires-Dist: pandas~=1.5.2
Requires-Dist: pillow>=9.1.0
Requires-Dist: rich-click~=1.5.2
Requires-Dist: rich-pixels~=2.1.1
Requires-Dist: rich~=13.3.5
Requires-Dist: textual~=0.22.3
Requires-Dist: universal-pathlib~=0.0.21
Provides-Extra: all
Requires-Dist: adlfs~=2023.1.0; extra == 'all'
Requires-Dist: aiohttp~=3.8.3; extra == 'all'
Requires-Dist: gcsfs~=2023.1.0; extra == 'all'
Requires-Dist: pyarrow~=10.0.0; extra == 'all'
Requires-Dist: requests~=2.28.2; extra == 'all'
Requires-Dist: s3fs~=2023.1.0; extra == 'all'
Provides-Extra: parquet
Requires-Dist: pyarrow~=10.0.0; extra == 'parquet'
Provides-Extra: remote
Requires-Dist: adlfs~=2023.1.0; extra == 'remote'
Requires-Dist: aiohttp~=3.8.3; extra == 'remote'
Requires-Dist: gcsfs~=2023.1.0; extra == 'remote'
Requires-Dist: requests~=2.28.2; extra == 'remote'
Requires-Dist: s3fs~=2023.1.0; extra == 'remote'
Description-Content-Type: text/markdown

# browsr

<div align="center">
<a href="https://github.com/juftin/browsr">
  <img src=https://i.imgur.com/QiAXcEm.png
    width="400" alt="browsr">
</a>
</div>

[![browsr Version](https://img.shields.io/pypi/v/browsr?color=blue&label=browsr)](https://github.com/juftin/browsr)
[![PyPI](https://img.shields.io/pypi/pyversions/browsr)](https://pypi.python.org/pypi/browsr/)
[![Testing Status](https://github.com/juftin/browsr/actions/workflows/tests.yaml/badge.svg?branch=main)](https://github.com/juftin/browsr/actions/workflows/tests.yaml?query=branch%3Amain)
[![GitHub License](https://img.shields.io/github/license/juftin/browsr?color=blue&label=License)](https://github.com/juftin/browsr/blob/main/LICENSE)

**`browsr`** is a TUI (text-based user interface) file browser for your terminal.
It's a simple way to browse your files and take a peek at their contents. Plus it
works on local and remote file systems.

---

<body>
<div style="display: grid; grid-template-columns: repeat(2, 1fr); grid-gap: 10px;">
  <img src="https://i.imgur.com/6apkI2Q.png" alt="Image 1">
  <img src="https://i.imgur.com/y7ZLRTX.png" alt="Image 2">
  <img src="https://i.imgur.com/oRBJ0vj.png" alt="Image 3">
  <img src="https://i.imgur.com/HWSjWCY.png" alt="Image 4">
</div>
</body>

## Installation

The below command recommends [pipx](https://pypa.github.io/pipx/) instead of pip. `pipx` installs the package in
an isolated environment and makes it easy to uninstall. If you'd like to use `pip` instead, just replace `pipx`
with `pip` in the below command.

```console
pipx install browsr
```

## Extra Installation

If you're looking to use `browsr` on remote file systems, like AWS S3, you'll need to install the `remote` extra.
If you'd like to browse parquet files, you'll need to install the `parquet` extra. Or, even simpler,
you can install the `all` extra to get all the extras.

```console
pipx install "browsr[all]"
```

## Usage

```console
browsr ~/Downloads/
```

Simply give `browsr` a path to a file/directory and it will open a browser window
with a file browser. You can also give it a URL to a remote file system, like AWS S3.

```console
browsr s3://my-bucket/my-file.parquet
```

## License

`browsr` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.
