{"id":16559653,"url":"https://github.com/psub/hackaru-timeular","last_synced_at":"2025-10-28T21:30:24.470Z","repository":{"id":57679128,"uuid":"488700395","full_name":"pSub/hackaru-timeular","owner":"pSub","description":"Track your time with the Timeular cube and Hackaru","archived":false,"fork":false,"pushed_at":"2024-11-20T15:17:18.000Z","size":34,"stargazers_count":8,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-01T18:12:35.418Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pSub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":["pSub"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2022-05-04T18:23:35.000Z","updated_at":"2024-11-20T15:17:22.000Z","dependencies_parsed_at":"2022-08-28T08:20:37.276Z","dependency_job_id":null,"html_url":"https://github.com/pSub/hackaru-timeular","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pSub%2Fhackaru-timeular","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pSub%2Fhackaru-timeular/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pSub%2Fhackaru-timeular/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pSub%2Fhackaru-timeular/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pSub","download_url":"https://codeload.github.com/pSub/hackaru-timeular/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238720363,"owners_count":19519336,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-11T20:26:40.785Z","updated_at":"2025-10-28T21:30:24.183Z","avatar_url":"https://github.com/pSub.png","language":"Python","funding_links":["https://github.com/sponsors/pSub"],"categories":[],"sub_categories":[],"readme":"# hackaru-timeular\nTrack your time with the Timeular cube and Hackaru\n\n**Notice**: This project is no longer actively developed as the development of Hackaru was stopped in November 2022. I still use it until I have a different setup. However, do not count on security\nor other updates for `hackaru-timeular`. I will archive this repository as soon I switch to a different setup.\n\n## Motivation\n\nTimeular (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/.\n\nI 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.\n\n## Installation\n\n`hackaru-timeular` is available via PiPy and can be installed as simple as `pip install hackaru-timeular`.\n\n## Configuration\n\n`hackaru-timeular` is configured in the configuration file `$XDG_CONFIG_HOME/hackaru-timeular/config.yml`.\n\nThe following example shows how to configure `hackaru-timeular` to connect to your Timeular cube and a Hackaru instance.\n\n```\n# The bluetooth address of your Timeular cube\naddress: 00:11:22:33:FF:EE\n\n# The API URL of the Hackaru instance\nendpoint: \"https://api.hackaru.app\"\n\n# The Email address connected to you Hackaru account\nemail: your-email@example.com\n\n# A list of tasks resembling the tasks in your Hackaru instance\ntasks:\n  task-1:\n    id: 3 # The Hackaru project id\n    description: Describe what you do\n  daily:\n    id: 4\n    description: Daily \n  coding:\n    id: 5\n    description: Coding\n\n# The mapping of Timeular cube sides to Hackaru tasks\nmapping:\n  1: task-1\n  2: daily\n  3: coding\n```\n\nThe 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`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpsub%2Fhackaru-timeular","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpsub%2Fhackaru-timeular","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpsub%2Fhackaru-timeular/lists"}