hackaru-timeular 0.2.0

Track your time with the Timeular cube and Hackaru

hackaru-timeular

Track your time with the Timeular cube and Hackaru

Motivation

Timeular (https://timeular.com/) offers a hardware and a software component that helps you to keep track of your time. The great thing is, that you can use the hardware without their software. I really like the idea of the hardware cube. It simply is physically present right besides you. When using the Timeular cube, it is rare that I forget to start or stop the timer for a task. If you want to learn more about the tracker, visit https://timeular.com/tracker/.

I have not looked into the time tracking software from Timeular as I already have a Hackaru which works really well for me. This led to the creation of hackaru-timeular, a small Python program that connects a Timeular cube to Hackaru.

Installation

hackaru-timeular is available via PiPy and can be installed as simple as pip install hackaru-timeular.

Configuration

hackaru-timeular is configured in the configuration file $XDG_CONFIG_HOME/hackaru-timeular/config.yml.

The following example shows how to configure hackaru-timeular to connect to your Timeular cube and a Hackaru instance.

# The bluetooth address of your Timeular cube
address: 00:11:22:33:FF:EE

# The API URL of the Hackaru instance
endpoint: "https://api.hackaru.app"

# The Email address connected to you Hackaru account
email: [e-mail]

# A list of tasks resembling the tasks in your Hackaru instance
tasks:
  task-1:
    id: 3 # The Hackaru project id
    description: Describe what you do
  daily:
    id: 4
    description: Daily 
  coding:
    id: 5
    description: Coding

# The mapping of Timeular cube sides to Hackaru tasks
mapping:
  1: task-1
  2: daily
  3: coding

The first time you start hackaru-timeular you have to enter your password to login. The login information (cookie) is stored at $XDG_CONFIG_HOME/hackaru-timeular/cookies.txt.