<p align="center">
<img src="https://github.com/TheRustyPickle/Rex/assets/35862475/04575a15-53f7-497f-b2e7-88a7a66d1136" width=400>
</p>
<div align="center"><h1>Rex</h1></div>
<div align="center">
<a href="https://wakatime.com/@RustyPickle"><img src="https://wakatime.com/badge/github/TheRustyPickle/Rex.svg" alt="wakatime"></a>
<a href="https://crates.io/crates/rex-tui">
<img src="https://img.shields.io/crates/v/rex-tui.svg?style=flat-square&logo=rust&color=orange"/></a>
<a href="https://github.com/TheRustyPickle/Rex/releases">
<img src="https://img.shields.io/github/v/release/TheRustyPickle/Rex?style=flat-square&logo=github&color=orange"/></a>
<a href="https://crates.io/crates/rex-tui">
<img src="https://img.shields.io/crates/d/rex-tui?style=flat-square"/></a>
</div>
Rex is a terminal user interface app for managing incomes, expenses, and transactions. Built with Rust and Ratatui with a simple interface that's easy to use.
<h2>Key Features</h2>
* Easily view, add, edit, and delete transactions.
* Navigate through transactions and instantly observe balance changes after each transaction.
* Chart for visualizing balance changes over a specific month, year, or all transactions.
* Access a summary with key insights and information on income, expense, and percentage distribution.
* Built using SQLite database and keeps everything local.
* Find transactions quickly using partial or specific information.
* Organize transactions with custom tags for easy filtering.
* Works fully offline.
<h2>Installation</h2>
**1. Run from Source Code:**
* Clone the repository
`
git clone https://github.com/TheRustyPickle/Rex
`
* Run with Cargo
`
cargo run --release
`
**2. Run the Latest Release:**
* Download the latest executable from [Release](https://github.com/TheRustyPickle/Rex/releases/latest).
* Open terminal/CMD and start the program by the command `./rex` or `rex` depending on the OS at the correct directory.
or
* Double-click the executable which will try to open a terminal/CMD by itself.
**3. Install from Cargo:**
* Install with `cargo install rex-tui`
* Run with the command `rex`
**4. Install using a package manager:**
* On NetBSD a package is available from the [official repositories](https://pkgsrc.se/finance/rex). To install it simply run:
```sh
pkgin install rex
```
<h2>App Data Location</h2>
See [here](https://docs.rs/dirs/latest/dirs/fn.data_local_dir.html) to learn about the initial directory where Rex data gets saved which is determined based on the OS.
<h2>Feedback & Bug Reports</h2>
For any feedback, improvement suggestions, or bugs please [open an issue](https://github.com/TheRustyPickle/Rex/issues/new)