tsi_birr

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 12 Open GitHub ↗

tsiBirr is an intelligent, real-time spending guard and dynamic audio warning system designed to protect users from impulse spending, excessive bank transfers, and low-balance financial stress.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# tsiBirr 🛡️💸
> **Intelligent Financial Guard & Audio Warning Notification Engine for Mobile Bank Transfers**

[![Flutter](https://img.shields.io/badge/Flutter-%2302569B.svg?style=flat&logo=Flutter&logoColor=white)](https://flutter.dev)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Clean Architecture](https://img.shields.io/badge/Architecture-Clean-success.svg)](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)

**tsiBirr** is an intelligent, real-time spending guard and dynamic audio warning system designed to protect users from impulse spending, excessive bank transfers, and low-balance financial stress.

---

## 🌟 Key Features

- 📱 **Real-Time Bank SMS Parsing**: Supports major Ethiopian & regional financial services including **Telebirr**, **Commercial Bank of Ethiopia (CBE)**, **Awash Bank**, **Bank of Abyssinia (BOA)**, **M-PESA**, **Dashen**, **COOPay**, and **EBIRR**.
- 📊 **Pure Spending Ratio Engine**: Automatically evaluates spending severity based on the ratio of transferred funds to remaining account balance:
  - 🔵 **Deposit Received**: Incoming credited transfer.
  - 🟢 **Minor Spend**: Spending ratio $< 15\%$ of total funds.
  - 🟡 **Moderate Spend**: Spending ratio $15\% - 30\%$ of total funds.
  - 🟠 **Heavy Spend**: Spending ratio $30\% - 50\%$ of total funds.
  - 🔴 **Danger / Low Balance Alert**: Spending ratio $\ge 50\%$ or remaining balance $< 1,000\text{ ETB}$.
- 🎧 **20 Authentic Amharic Audio Warnings**: Built-in Amharic voice clips & sound effects tailored to each severity tier.
- 🔒 **Random & Locked Sound Modes**: Pick a locked sound per tier or let tsiBirr select audio clips randomly.
- 🛑 **Ringtone-Style Volume Key Muting**: Mute playing audio warnings instantly by pressing any physical hardware volume button (**Volume Up**, **Volume Down**, or **Mute**), just like muting an incoming phone call!
- 🌙 **Light & Dark Theme**: Toggle between Obsidian Dark Mode (`#090A0F`) and Clean Light Mode (`#F8FAFC`).

---

## 🏗️ Architecture

tsiBirr is built following **Clean Architecture** principles:

```
lib/
├── core/
│   ├── theme/          # Color tokens, obsidian & light ThemeData
│   └── utils/          # Currency & timestamp formatters
├── features/
│   ├── notifications/  # SoundManagerService & NotificationService
│   └── sms_parser/
│       ├── domain/     # Pure entities (ParsedSMS, SpendingTier, SoundItem)
│       ├── data/       # Bank SMS parsing engine & SMS listener datasource
│       └── presentation/# Controllers, Home page & Bottom sheet widgets
└── main.dart           # App entrypoint & dependency injection
```

---

## ☕ Support & Buy Me a Coffee

If **tsiBirr** helps you manage expenses and save money, consider supporting the developer!

- **Developer**: Dawit Beyene
- **☕ GurshaPlus (Buy Me a Coffee)**: [https://www.gurshaplus.com/ragoose](https://www.gurshaplus.com/ragoose)
- **🐙 GitHub Repository**: [https://github.com/daveragos/tsi_birr](https://github.com/daveragos/tsi_birr)

---

## 📄 License

This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.

tsi_birr

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README