Skip to content

BillMates is a user-friendly app designed to simplify managing shared expenses among flatmates. Easily track bills, automatically split costs, and ensure everyone knows what they owe. Features include bill tracking, expense splitting, payment reminders, and expense history. Contributions are welcome!

Notifications You must be signed in to change notification settings

akshayjith4/BillMates

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BillMates

BillMates is a user-friendly app designed to simplify managing shared expenses among flatmates. Keep track of bills, split costs fairly, and ensure everyone knows what they owe.

Features

  • Bill Tracking: Easily add and track shared expenses.
  • Expense Splitting: Automatically calculate each flatmate's share of the expenses.
  • Payment Reminders: Get notifications for upcoming payments and reminders for due bills.
  • Expense History: View past expenses and payment history for transparency.
  • User-Friendly Interface: Simple and intuitive design for easy navigation.

Installation

To install and run the BillMates app locally, follow these steps:

Prerequisites

  • Python 3.6+
  • pip (Python package installer)

Steps

  1. Clone the Repository:

    git clone https://github.com/akshayjith4/billmates.git
    cd billmates
  2. Create a Virtual Environment:

    python -m venv venv
    source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
  3. Install Dependencies:

    pip install -r requirements.txt
  4. Run the Application:

    python app.py

Usage

  • Sign Up/Log In: Create a new account or log in with your existing credentials.
  • Add Flatmates: Add your flatmates to the app.
  • Add Expenses: Enter details of shared expenses, such as rent, utilities, and groceries.
  • Split Costs: The app automatically calculates and splits costs among the flatmates.
  • View Balances: Check each flatmate's balance to see who owes what.
  • Settle Up: Record payments when flatmates settle their balances.

Online Access

BillMates is also available online at BillMates. The site will be available for only 3 months because, let's face it, domains are expensive and this is a passion project.

We welcome contributions!

About

BillMates is a user-friendly app designed to simplify managing shared expenses among flatmates. Easily track bills, automatically split costs, and ensure everyone knows what they owe. Features include bill tracking, expense splitting, payment reminders, and expense history. Contributions are welcome!

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published