https://github.com/akshayjith4/billmates
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!
https://github.com/akshayjith4/billmates
cost-splitting data-storage expense-tracking user-interface web-hosting
Last synced: 8 months ago
JSON representation
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!
- Host: GitHub
- URL: https://github.com/akshayjith4/billmates
- Owner: akshayjith4
- Created: 2024-07-19T09:07:37.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-20T04:30:10.000Z (about 1 year ago)
- Last Synced: 2025-01-11T00:23:11.032Z (9 months ago)
- Topics: cost-splitting, data-storage, expense-tracking, user-interface, web-hosting
- Language: Python
- Homepage: http://akshayjith.pythonanywhere.com/
- Size: 30.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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**:
```bash
git clone https://github.com/akshayjith4/billmates.git
cd billmates
```
2. **Create a Virtual Environment**:
```bash
python -m venv venv
source venv/bin/activate # On Windows, use `venv\Scripts\activate`
```
3. **Install Dependencies**:
```bash
pip install -r requirements.txt
```
4. **Run the Application**:
```bash
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](http://Akshayjith.pythonanywhere.com). 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!