Skip to main content

PyTM - an Open Source Python Time Management Tool for Mankind

Project description

PyTM - Logo

PУΓM - A CLI time tracker for projects with invoice generation

image1 Documentation Status Supported Python Versions List of Contributors Download Stats Documentation Status image2


Project time management, billing, and invoice generation.


PyTM - Preview


PyTM - Screenshot PyTM - Invoice

Installing PyTM

  • First download and install pyenv. Use the command:

    curl | bash
  • Next, install Python 3.12 using the command:

    pyenv install 3.12.0

    Alternatively, you can skip pyenv installation and download python 3.12 or above from the official website and setup a virtualenv as well.

  • Next, install PyTM from PyPI using pip:

    python -m pip install python-pytm

Check the version by typing the following in your terminal.:

pytm --version

Basic commands

To see the available commands type:

pytm --help


Configure project, user and invoice info:

pytm config project PROJECT_NAME
pytm config user
pytm config invoice

Generate Invoice:

pytm invoice auto PROJECT_NAME
pytm invoice manual

Check version:

pytm --version
pytm -v

Check summary of all the projects:

pytm summary

For a list of all the available commands try:

pytm --help

Running the tests

  • Clone this repository

  • Install dependencies:

    pip install -r requirements.txt
  • run the tests:




The full documentation is at


0.0.1 (2018-10-23)

  • First release on PyPI.

0.0.2 (2018-11-09)

  • Second release on PyPI.

  • Created Skeleton of the command line Interface.

0.0.3 (2023-10-18)

  • Implemented data store in home directory.

  • Made project commands functional.

0.0.4 (2023-10-28)

  • Implemented state.

  • Improved project commands.

0.0.5 (2023-10-30)

  • Made task commands functional.

  • Improved project summary.

  • Project summary now shows total duration of the project.

0.0.6 (2023-10-31)

  • bug fix

  • readme and doc update

  • Improved Command line interface outputs.

0.0.7 (2023-11-01)

  • Added show sub command for project.

  • Added json sub command for project.

  • refactored project and task commands output messages.

  • fixed bugs in project sub commands.

0.0.8 (2023-11-01)

  • Added config sub command.

  • added command to save default user information.

  • refactored project and task commands.

  • fixed bugs.

  • added config command to configure project meta data such as title, billable? etc.

0.0.9 (2023-11-02)

  • Added config invoice command for configuring default invoice texts and logo.

  • Added invoice sub command.

  • Added invoice manual command to generate manual invoice using prompts.

  • Added invoice auto <Project> command to generate invoice from existing projects.

  • invoice manual and auto command generates HTML invoices using Tailwind CSS and opens it in a Browser.

0.0.10 (2023-11-03)

  • open invoices using python’s standard library.

  • code refactor

  • bug fix

0.0.11 (2023-11-03)

  • Major bug fix.

0.0.12 (2023-11-04)

  • Bug fix.

0.0.13 (2023-11-07)

  • Made the init command optional.

0.0.14 (2023-11-07)

  • config invoice command bug fix.

  • copy logo instead of moving it permanently when configuring invoice.

  • fixed f strings quote issue.

  • made init command hidden.

  • improved doc strings and help texts.

0.0.15 (2023-11-08)

  • added new command rename for renaming existing projects.

  • added new command rename for renaming existing tasks.

  • updated show command to show active task and project when available.

  • Simplified project start command.

  • New projects can be started without project name.

  • Project started without a name will now have a default name which can be renamed later.

  • Simplified task start command.

  • New tasks can be started without task name.

  • Task started without a name will have a default name which can be renamed later at ease.

  • Bug fix

0.0.16 (2023-11-11)

  • added new command summary.

  • fixed bug and refactored invoice handler.

  • added tests for project handler.

  • added tests for task handler.

  • added tests for invoice handler.

  • updated make command to update README coverage percentage while testing.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-pytm-0.0.16.tar.gz (17.2 kB view hashes)

Uploaded source

Built Distribution

python_pytm-0.0.16-py2.py3-none-any.whl (16.2 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page