Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oumarousandasouley/imc-bmi-calculator
This is a simple BMI (Body Mass Index) calculator built with KivyMD framework.
https://github.com/oumarousandasouley/imc-bmi-calculator
kivy kivymd python
Last synced: 2 days ago
JSON representation
This is a simple BMI (Body Mass Index) calculator built with KivyMD framework.
- Host: GitHub
- URL: https://github.com/oumarousandasouley/imc-bmi-calculator
- Owner: OumarouSandaSouley
- Created: 2024-06-26T07:43:32.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-07-15T12:52:06.000Z (2 months ago)
- Last Synced: 2024-09-25T20:04:43.117Z (2 days ago)
- Topics: kivy, kivymd, python
- Language: kvlang
- Homepage:
- Size: 246 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# IMC (BMI) Calculator using KivyMD
This is a simple BMI (Body Mass Index) calculator built with KivyMD framework. It allows users to input their height and weight and calculates their BMI based on the input values.
## Features
- Calculate BMI based on height and weight input.
- Display BMI category (Underweight, Normal weight, Overweight, Obesity) based on calculated BMI.
- Simple and intuitive user interface designed with KivyMD.
## Screenshots
## Prerequisites
- Python 3.7+
- Kivy 2.0.0 or later
- KivyMD 0.104.1 or later
## Installation
1. Clone the repository:
```bash
git clone https://github.com/OumarouSandaSouley/-imc-calculator.git
```
2. Navigate into the directory:
```bash
cd imc-bmi-calculator
```
3. Install the dependencies:
```bash
pip install -r requirements.txt
```
## Usage
1. Run the application:
```bash
python main.py
```
2. Enter your height (in meters) and weight (in kilograms) in the respective fields.
3. Click on the "Calculate BMI" button to see your BMI and BMI category.
4. Optionally, you can reset the inputs using the "Reset" button.
## Contributing
Contributions are welcome! Please follow these steps:
1. Fork the repository.
2. Create a new branch (`git checkout -b feature/new-feature`).
3. Make your changes.
4. Commit your changes (`git commit -am 'Add new feature'`).
5. Push to the branch (`git push origin feature/new-feature`).
6. Create a new Pull Request.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- Inspired by the need for a simple BMI calculator.
- Built with KivyMD to provide a modern and responsive UI.
---
Adjust the URLs and details based on your specific repository and project setup. This README.md provides a clear overview of the project, its features, how to install and use it, and guidelines for contributing. Adjust sections as needed to fit additional details or specific instructions for your project.