DEV Community

Cover image for Simple interactive command line time tracker
Tom Schwarz
Tom Schwarz

Posted on

Simple interactive command line time tracker

This tool allows you to track your time for all your projects or needs. You can manage your projects and export it for your needs.

I build this project for fun and i hope someone can need it.
I appreciate every help i can get. :)

📄 Table of Contents

📟 Installation

Follow the steps below for installing:

$ git clone https://github.com/thomasschwarz96/ts-timetracker.git  
$ cd ts-timetracker  
$ cmake .  
$ make  
$ sudo make install

📋 Usage

$ ts-timetracker

That's it. Now the interactive command line starts and you can start to track your times on your projects or for your needs.

To Exit, just type 'exit' or press Ctrl + c.

Here are all commands you can use:

COMMAND DESCRIPTION
help Show's the help menu
touch <name> Create's a new project with entered name
rm <name> Delete's entered project
ls <item> List selected items (use 'projects', 'config' or 'times')
use <n> Set project to track time on, a number from 'list' command
start Start's timetracking
stop Stop's timetracking
save <comment> Save new timetrack on selected project with entered comment
export <p> Export selected project to given path (selected project by 'use' command)

🔧 Configuration

Default path of the config file: ~/.config/ts-timetracker/

Name of the config file: ts-timetracker.conf

The config file will be generated automatically while installation.

Possible config values:

OPTION POSSIBLE VALUES / EXAMPLES DESCRIPTION
timeFormat %d.%m.%Y %T format is used for displaying time
projectsPath .config/ts-timetracker/projects/ path is used for creating, saving and deleting projects
storage filesystem indicates which model should used
view terminal indicates which view should used

📜 License

MIT-License

📎 Github

For more informations check out the repository

Top comments (0)