https://github.com/brand07/car-tracker
Program that allows you to track miles driven, money spent on gas, and your fuel efficiency.
https://github.com/brand07/car-tracker
Last synced: 8 months ago
JSON representation
Program that allows you to track miles driven, money spent on gas, and your fuel efficiency.
- Host: GitHub
- URL: https://github.com/brand07/car-tracker
- Owner: Brand07
- Created: 2025-02-18T13:20:15.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-02-18T21:22:46.000Z (8 months ago)
- Last Synced: 2025-02-18T22:27:26.911Z (8 months ago)
- Language: Python
- Size: 22.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MPG Tracker (Work In Progress)
Car Tracker is a Python application that allows users to track their vehicle's fuel fill-ups, odometer readings, and fuel costs. The application uses a graphical user interface (GUI) built with `tkinter` and `customtkinter`, and stores data in Excel files using the `pandas` library.
## Features
- Add new fill-up records for different vehicles.
- Validate odometer readings to ensure they are greater than the previous readings.
- Store fill-up data in Excel files.
- Display total fill-ups.
## Requirements
- Python 3.13 or higher
- `pandas`
- `openpyxl`
- `tkinter`
- `customtkinter`
## Installation
1. Clone the repository:
```sh
git clone https://github.com/Brand07/Car-Tracker.git
cd Car-Tracker
```
2. Create a virtual environment and activate it:
```sh
python -m venv .venv
.venv\Scripts\activate # On Windows
```
3. Install the required packages:
```sh
pip install -r requirements.txt
```
## Usage
1. Ensure you have a `Resources` folder in the project directory. If not, it will be created automatically when you run the application.
2. Run the application:
```sh
python main.py
```
3. Use the GUI to add new fill-up records. The application will validate the odometer readings and store the data in Excel files located in the `Resources` folder.
## Project Structure
- `main.py`: Entry point of the application.
- `gui.py`: Contains the GUI logic and event handlers.
- `Resources/`: Directory where Excel files for each vehicle are stored.
## Contributing
1. Fork the repository.
2. Create a new branch (`git checkout -b feature-branch`).
3. Commit your changes (`git commit -am 'Add new feature'`).
4. Push to the branch (`git push origin feature-branch`).
5. Create a new Pull Request.
## License
This project is licensed under the MIT License. See the `LICENSE` file for more details.