Skip to content

Knee Surgery Recovery Tracker helps track recovery, set reminders, and visualize progress effectively.

Notifications You must be signed in to change notification settings

nexora-w/KneeVitals

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Knee Surgery Recovery Tracker

This project is a Knee Surgery Recovery Tracker application built using Python and ttkbootstrap for the GUI. The application helps users log and monitor their recovery process, set reminders, and visualize progress.


Features

  1. Log Recovery Data:
    • Input and store recovery data: pain level (0-10), therapy details, and mobility range (0-10).
  2. Set Reminders:
    • Schedule reminders with a date, time, and custom message.
  3. View Logs and Reminders:
    • Display recovery logs and reminders in a tabular format.
  4. Visualize Trends:
    • Plot pain and mobility trends using matplotlib.
  5. Export and Import Logs:
    • Export logs to a CSV file or import logs from a CSV file.

Usage Guide

Installation

  1. Clone this repository:

    git clone https://github.com/BJ-dev0706/KneeVitals.git
    cd KneeVitals
  2. Install dependencies:

    pip install ttkbootstrap matplotlib
  3. Run the application:

    python main.py

Create and Use an Executable File (.exe)

Generate the .exe file

  1. Install pyinstaller:

    pip install pyinstaller
  2. Create the .exe file:

    pyinstaller --onefile --noconsole main.py
    • The --onefile flag creates a single executable file.
    • The --noconsole flag suppresses the console window.
  3. Locate the .exe file:

    • The executable will be in the dist folder.

Run the .exe file

  1. Navigate to the dist folder:
    cd dist
  2. Run the .exe file:
    ./main.exe

Distribute the .exe file

  • Share the .exe file from the dist folder to allow others to use the application without installing Python or dependencies.

Input Guide

  • Log Recovery:
    • Pain Level: Numeric (0-10)
    • Mobility Range: Numeric (0-10)
    • Therapy Details: Free text
  • Set Reminder:
    • Date: Select from calendar.
    • Time: Input in HH:MM format.
    • Message: Free text.

Sample Database

A sample database (knee_recovery.db) is included for testing, containing sample recovery logs and reminders.

  • Recovery Logs (recovery_logs table):

    • id: Auto-incrementing ID
    • date: Timestamp of the log
    • pain_level: Numeric value (0-10)
    • therapy_details: Text
    • mobility_range: Numeric value (0-10)
  • Reminders (reminders table):

    • id: Auto-incrementing ID
    • date: Date of the reminder
    • time: Time of the reminder
    • message: Reminder message

Screenshots

1. Main Interface

Main Interface

2. Logs Table

Logs Table

3. Reminders Table

Reminders Table


Contributing

Feel free to contribute to this project by submitting issues or pull requests.


License

This project is licensed under the MIT License.

About

Knee Surgery Recovery Tracker helps track recovery, set reminders, and visualize progress effectively.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages