period-tracker 0.1.0

No project description provided

Period Tracker

period-tracker is a lightweight, easy-to-use Python application to track menstrual cycles, analyse cycle statistics, and visualise your data.

Features

• Record period start dates and durations
• Analyse cycle statistics (average length, standard deviation, min, max)
• Data persistence using JSON files
• Visualize cycle length with matplotlib
• Secure your data using GPG asymmetric encryption.

Screenshots

Here’s a few screenshots of the Period Tracker app in action:

Installation

Prerequisites

• Python 3.7 or higher
• pip + pipx installed (recommended for isolated installs)
• git
• gpg (GNU Privacy Guard) must be installed and accessible in your system path.

From PyPi (recommended)

You can install period-tracker with pipx from the PyPi repo.

pipx install period-tracker

From source

Clone the repository and install:

git clone https://codeberg.org/kingorgg/period_tracker.git
cd period_tracker
pipx install .

Usage

After installation, launch the tracker using the command:

period-tracker

(OPTIONAL) create a shortcut

Copy the following content (replace USERNAME with your actual username) to a new file at:

$HOME/.local/share/applications/period-tracker.desktop

[Desktop Entry]
Name=Period Tracker
GenericName=Period Tracker
Exec=/home/USERNAME/.local/bin/period-tracker
Terminal=false
Type=Application
Categories=Other;

Uninstallation

To uninstall the package installed via pipx:

pipx uninstall period-tracker

Data Encryption

Period Tracker uses GPG asymmetric encryption to protect your data.

How it works

The app encrypts your data file (data.json) using your GPG public key. Only your corresponding private key can decrypt it.

Requirements

Make sure you have a GPG key pair generated (using gpg --gen-key). When you first load the period-tracker, you'll be prompted to enter your email address or key ID/fingerprint.

You can check what keys you have by running:

gpg --list-keys

Data Storage

Data is stored locally and encrypted with gpg in:

$HOME/.period-tracker/data.json.gpg # Linux

C:\Users\USERNAME\AppData\Local\period-tracker\data.json.gpg # Windows

Config

Your config file is located in:

$HOME/.config/period-tracker/config.json # Linux

C:\Users\USERNAME\AppData\period-tracker\config.json # Windows

Development

For development, install optional dependencies:

pip install .[dev]

Run tests with:

pytest tests/

License

This project is licensed under the MIT License.