https://github.com/TheRustyPickle/Rex

A Rust based TUI for keeping track of incomes and expenses
https://github.com/TheRustyPickle/Rex

ratatui rusqlite rust sqlite terminal terminal-based terminal-ui tui tui-rs

Last synced: 3 months ago
JSON representation

A Rust based TUI for keeping track of incomes and expenses

• Host: GitHub
• URL: https://github.com/TheRustyPickle/Rex
• Owner: TheRustyPickle
• License: mit
• Created: 2022-05-18T23:43:54.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-03-15T11:39:30.000Z (3 months ago)
• Last Synced: 2024-03-15T12:54:42.591Z (3 months ago)
• Topics: ratatui, rusqlite, rust, sqlite, terminal, terminal-based, terminal-ui, tui, tui-rs
• Language: Rust
• Homepage:
• Size: 2.11 MB
• Stars: 20
• Watchers: 1
• Forks: 2
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-ratatui - Rex - A TUI for managing Incomes and Expenses. (💻 Apps / 🚀 Productivity and Utilities)

README

        


  



Rex



















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.


![Rex](https://github.com/TheRustyPickle/Rex/assets/35862475/78fa9d86-5f7c-4c37-be35-437ecc8c4f92)

Key Features


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

Installation


**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

```

App Data Location


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.

Feedback & Bug Reports


For any feedback, improvement suggestions, or bugs please [open an issue](https://github.com/TheRustyPickle/Rex/issues/new)