An open API service indexing awesome lists of open source software.

https://github.com/ismet55555/bieye

A blazingly fast rust-based bionic reader for blazingly fast reading within a terminal console 🦀
https://github.com/ismet55555/bieye

cli fast reading rust terminal

Last synced: 3 months ago
JSON representation

A blazingly fast rust-based bionic reader for blazingly fast reading within a terminal console 🦀

Awesome Lists containing this project

README

        


portfolio_view

![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/ismet55555/bieye/rust.yml)
![Crates.io](https://img.shields.io/crates/v/bieye)
![Crates.io](https://img.shields.io/crates/l/bieye)


This Rust-based CLI tool reads text and returns it back in bionic reading format
for blazingly fast loading and even faster reading!

Bionic reading is the reading of specially formatted text, allowing for
faster reading. This is possible by strategically highlinting pieces
of text, which tricks the brain of reading without losing content.

**Essentially:** Use this tool to speed up your text reading while using the console


test gif

## Installation

- **Homebrew**

```bash
brew install ismet55555/things/bieye
```

- **Snap Store**

```bash
snap install bieye
```

- **Cargo**

```bash
cargo install bieye
```

- **Compile From Source**

```bash
git clone [email protected]:ismet55555/bieye.git
cd bieye
cargo install --path .
```

## Usage Examples

The following are a few simple usage examples for `bieye`

```bash
# Simple text specification
bieye "Hello there, how is your day going?"

# Piping standard out into bieye
cat README.md | bieye
man git | bieye
echo "HELLO! hello hello elo el ..." | bieye

# Add some output options
cat quest.md | bieye --color --dim
```

## CLI Menu

```txt
$ bieye -h

bieye v0.0.0

This CLI tool reads text and returns it back in bionic reading format
for blazingly fast loading and even faster reading!

Example Usages:
bieye "Keep on reading"
echo "Read faster, learn more" | bieye --dim
man vim | bieye --dim --color

Usage: bieye [OPTIONS] [TEXT]

Arguments:
[TEXT] Capture text from stdin

Options:
-c, --color Color highlighted text
-d, --dim Dim text not highlighted
-h, --help Print help (see more with '--help')
-V, --version Print version
```

## Contribution and Development

Feel free to contribute! Here is a super quick start if you are vaguely familiar with [Rust](https://www.rust-lang.org/tools/install).

```bash
# Setup
git clone [email protected]:ismet55555/bieye.git
cd bieye
git checkout -b my-cool-new-branch
cargo build

# ... work work work ...

# Test run the CLI
cargo run -- --help
echo "Just some testing text" | cargo run --

# Run tests
cargo test

# Other terminal windows
cargo install --locked bacon
bacon --all-features
```