Metadata-Version: 2.1
Name: browsr
Version: 1.4.0
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
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: pymupdf~=1.22.3
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=docs/_static/browsr.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.

<details open></summary></summary>

<body>
<div style="display: grid; grid-template-columns: repeat(2, 1fr); grid-gap: 10px;">
  <img src="docs/_static/screenshot_utils.png" alt="Image 1">
  <img src="docs/_static/screenshot_datatable.png" alt="Image 2">
  <img src="docs/_static/screenshot_mona_lisa.png" alt="Image 3">
  <img src="docs/_static/screenshot_markdown.png" alt="Image 4">
</div>
</body>

</details>

## 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.

```shell
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.

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

## Usage

```shell
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.

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

## License

**`browsr`** is distributed under the terms of the [MIT license](LICENSE).
