Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Auox (Aurum Oxydatum) 💰

A terminal-based banking application (currently) for SpareBank1, written in Rust.

Demo

Features

  • 💳 Account Management - View all your accounts, including credit cards
  • 📊 Transaction History - Browse your transaction history with color-coded amounts
  • 💸 Transfers - Move money between accounts.
  • 🎨 Modern TUI - Okay looking terminal interface with animations and effects
  • Fast & Lightweight - Built with Rust for speed and efficiency (or because I really like Rust, realisticly it makes no difference here 🤷‍♂️)

Prerequisites

  • Rust (install from rustup.rs)
  • SpareBank 1 banking account
  • SpareBank 1 API credentials (client ID and secret)

Installation

# Clone the repository
git clone https://github.com/sverrejb/auox.git
cd auox

# Build the project
cargo build --release

# Run the application
cargo run --release

# Install binary
cargo install --path .

API access:

To use with SpareBank 1's APIs you need to create a client on their developer portal at: https://developer.sparebank1.no/#/

Configuration

On first run, Auox will create a config file at:

  • macOS: ~/Library/Application Support/auox/config.toml
  • Linux: ~/.config/auox/config.toml
  • Windows: %APPDATA%\auox\config.toml

Edit the config file and add your SpareBank 1 API credentials:

client_id = "your-client-id"
client_secret = "your-client-secret"

# Your financial institution ID
# Examples: fid-smn (SpareBank 1 Midt-Norge), fid-snn (SpareBank 1 SR-Bank), etc.
financial_institution = "fid-smn"

Usage

First Launch

  1. Run cargo run or auox if you installed the binary.
  2. Your browser will open for OAuth authentication
  3. Log in to SpareBank 1 and authorize the application
  4. The app will save your tokens and start automatically

Built with:

  • ratatui - Terminal UI framework
  • crossterm - Terminal manipulation
  • tachyonfx - Visual effects and animations
  • reqwest - HTTP client
  • serde - Serialization framework
  • tui-input - Text input widgets

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details.

Disclaimer

This is an unofficial application and is not affiliated with or endorsed by SpareBank1. Use at your own risk.

About

Aurum Oxydatum - The terminal banking application for Sparebank 1 customers.

Resources

Stars

24 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages