hourtrack 1.5.2

Python program that tracks total time spent on projects and saves sessions. It supports multiple projects.

⌛ HourTrack

Contents

• 📖 Description
• 🚀 Quick start
• ✨ Features
• 📦 Installation
• 📲 Usage
• ⚙ Options
• 💻 Development
• 👥 Contributing

📖 Description

💻 Windows, Linux and Mac compatible. 💻

A Python script to track time spent on various projects. This script allows you to start, stop, and monitor time tracking for different projects, as well as output data to files.

It is very lightweight since it doesnt have to be running in the background.

This script is going to help you track:

• Total time spent on different projects
• Work sessions information
• Time spent on each session

🚀 Quick start

pipx install hourtrack
hourtrack start myProject

✨ Features

• Supports multiple projects: Track time for multiple projects.
• Start/Stop tracking: Start and stop tracking time for a project.
• List projects: List all projects being tracked.
• Delete project: Delete a project and all its data.
• Reset project: Reset a project's data.
• Export data: Export data to a .txt file.
• ...

📦 Installation

From PyPI

pipx install hourtrack

pipx is optional but recommended, you can use pip instead.

Optional installation alternative

git clone https://github.com/P-ict0/HourTrack.git
cd HourTrack
pipx install .  # You can also use `pip`

📲 Usage

For help:

hourtrack --help

(Optional) Create a project: Create a project to start tracking time. (This is not necessary, as the project will be created when you start tracking time for it.)

hourtrack create <project>

Start tracking: Start tracking session for a project. If the project does not exist, it will be created.

hourtrack start <project>

Stop tracking: Stop current session for a project, saving the time spent. With option to delete all projects.

hourtrack stop <project|--all>

Reset project: Reset a project's data. With option to reset all projects

hourtrack reset <project|--all>

Edit project: Rename a project.

hourtrack edit <project> --rename <new_name>

Add session with endtime now that lasted certain number of hours.

hourtrack edit <project> --add-session <hours>

Delete session by its ID. (You get the id by hourtrack info <project>)

hourtrack edit <project> --delete-session <id>

Delete project: Delete a project and all its data. With option to delete all projects.

hourtrack delete <project|--all>

List projects: List all/active projects.

hourtrack list <all|active> [--format <smart|full|short|hours>]

Project Info: Show the status of a specific project or show current active session. With option to output to a file.

# Project status
hourtrack info <project> [--format <smart|full|short|hours>] [-o <outputPath>]
# Active session
hourtrack info [--format <smart|full|short|hours>]

⚙ Options

Command	Requirement	Default	Description
hourtrack --help	None	None	For help
hourtrack create <project>	Project name	None	Create a new empty project.
hourtrack start <project>	Project name	None	Start tracking session for a project. If the project does not exist, it will be created.
hourtrack stop <project|--all>	Project name or -a/--all flag	None	Stop current session for a project, saving the time spent. With option to stop all projects
hourtrack reset <project|--all>	Project name or -a/--all flag	None	Reset a project's data. With option to reset all projects
hourtrack edit <project> <--rename <name>|--add-session <hours>|--delete-session <id>>	One of --rename, --add-session, --delete-session	None	Renames a project, adds a session or deletes a session
hourtrack delete <project|--all>	Project name or -a/--all flag	None	Delete a project and all its data. With option to delete all projects
hourtrack list <all|active> [--format <smart|full|short|hours>]	format smart	None	List all/active projects.
hourtrack info [<project>] [--format <smart|full|short|hours>] [-o <outputPath>]	format smart	None	Show the info of a specific project or show current active session if project is not specified. With option to output to a file.

💻 Development

git clone https://github.com/P-ict0/HourTrack.git
cd HourTrack
python -m venv venv
pip install -r requirements.txt
source venv/bin/activate # Windows: .\venv\Scripts\activate.ps1

# Run the script
python src/hourtrack.py --help

👥 Contributing

Contributions are welcome! Please fork the repository and submit a pull request with your suggested changes.