Skip to main content

Lightweight curses-based time tracking tool.

Project description


Lightweight curses-based time tracking tool.


Table of contents

  1. Table of contents
  2. Features
  3. Installation
  4. Configuration
  5. Usage


  • start and stop tasks
  • add new tasks
  • edit or remove existing tasks
  • list tasks
  • sum up run times
  • show summary
  • export tasks to CSV or JSON


  • curses-based user interface
  • standard library only


To install Eichhörnchen using pip run the following command:

pip install eichhoernchen


The default location of the configuration file is ~/.config/eichhoernchen.ini. An alternate configuration file can be specified using the -c, --config argument.

Minimal configuration

The configuration file is an INI file and has to contain at least the following section:

dbname = eichhoernchen.db
path = /home/user/.local/share

The dbname specifies the name of the SQLite3 database, and path its path.


To define aliases for the commands, add the aliases section to define one or more aliases per command:

list = ["ls"]
remove = ["rm", "rem"]


usage: eichhoernchen [-h] [-c CONFIG] [--version]

Lightweight curses-based time tracking tool.

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG, --config CONFIG
                        use this configuration file
  --version             show program's version number and exit

When inside the program use the help or ? commands to list available commands or help command to show the command's help message.

Use Control+D to close windows and abort operations. Control+C will exit the program.

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

eichhoernchen-2.2.tar.gz (17.8 kB view hashes)

Uploaded Source

Built Distribution

eichhoernchen-2.2-py3-none-any.whl (37.2 kB view hashes)

Uploaded Python 3

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