Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/kruserr/rustic-reader

A minimalistic ebook reader
https://github.com/kruserr/rustic-reader

cli cli-utility pdf pdf-reader terminal terminal-utility unix utility

Last synced: 1 day ago
JSON representation

A minimalistic ebook reader

Awesome Lists containing this project

README

        





# RusticReader
A minimalistic ebook reader

## Overview
The goal of this project is to build an ebook reader that has a minimal set of features, that make ebook reading enjoyable on a desktop computer.
Furthermore we are building a seamless experience for reading ebooks, both on a desktop computer and a tablet or ereader with a browser.

## Features
- CLI client
- Converts regular or scanned PDF or EPUB to plain text
- Justifies the plain text to specified column width
- Horizontally centers the text
- Minimalistic less like interactive reader with vim like bindings
- Saves progress
- Written in pure Rust
- Cross platform
- Each component in the CLI client is exposed as a UNIX style utility

## Quick start guide
### Install the CLI client
```sh
cargo install --locked rustic-reader
rustic-reader document.pdf
```

for scanned document support
```sh
sudo apt install ocrmypdf tesseract-ocr-eng
```

then use the `--ocr=true` flag
```sh
rustic-reader --ocr=true document.pdf
```

For further install instructions read the [Getting started page](docs/pages/getting-started.md)

## Documentation
Visit the [Documentation](docs/README.md)

## Roadmap
- [x] Plain text format support
- [x] PDF format support
- [x] EPUB format support
- [x] Convert scanned documents and images to plain text with ocrmypdf
- [x] Auto saving progress
- [ ] Offline PWA web client
- [ ] Server to sync progress
- [ ] Integrated command line
- [ ] Text highlighting
- [ ] Extend server to sync books and highlights
- [ ] Support more ebook and document formats
- [ ] CLI client image to ascii art converter
- [ ] Natural sounding ai voice model for text to speech narration