Skip to content

rshu/SmartSplit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SmartSplit

SmartSplit is a desktop app for splitting shared expenses among friends. It tracks groups, events, and expenses, and calculates who owes or should receive money so the total cost is split evenly.

Features

  • Manage multiple groups and members
  • Create events per group
  • Record expenses per event
  • View settlement totals per event

Setup

  1. Create a MySQL database (default: smartsplit).
  2. Copy config.example.json to config.json and update credentials, or set environment variables:
    • SMARTSPLIT_DB_HOST
    • SMARTSPLIT_DB_PORT
    • SMARTSPLIT_DB_USER
    • SMARTSPLIT_DB_PASSWORD
    • SMARTSPLIT_DB_NAME
  3. Install dependencies:
    python -m pip install -r requirements.txt
  4. Run the app:
    python src/main.py

The schema is created automatically on startup. If you want to inspect it, see sql/schema.sql.

Testing

Run the unit tests with:

python -m unittest discover -s tests

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages