Automatic Time Tracking Software

It is an automatic time tracking software. You will be able to know where and how you spend your time. It runs in the background on your computer, and phone to track in real-time the time that you spent in each application or website.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

• Table of Contents
• About The Project
  • Built With
• Getting Started
  • Installation
• Usage
  • Linux
• Roadmap
• Contributing
• License
• Contact

About The Project

This is the client app for desktops. It's runs on Linux, Windows and MacOs. There will be two more parts, a backend, and a client app for smartphones.

Built With

• Python 3.6

Getting Started

To get a local copy up and running follow these simple steps.

Installation

1. Clone the repo

git clone https://github.com/asperduti/automatic-time-tracking-desktop-client.git

Usage

To start to track the time that you spend at your computer just run the app:

python3 run.py

And when you finish the program, you will get a resume like this one:

Resume:

Activity        Time Spent
________        __________
time_tracking : bash    0:00:01.026519
time_tracking : python3 0:00:08.180052
time_tracking   0:00:11.213815

The best idea is start the tracker at login time, the steps to achive this depend of the platform.

Linux

This is as simple as create a new Desktop Entry(a file with extension .desktop) inside of ~/.config/autostart with the following conten:

[Desktop Entry]
Name=TimeTracking
GenericName=Time Tracking Desktop App
Comment=Run the Time Tracking app in background
Exec=/path/to/my/script.sh
Terminal=false
Type=Application
X-GNOME-Autostart-enabled=true

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Your Name - @arielsperduti

Project Link: https://github.com/asperduti/automatic-time-tracking-desktop-client