{"id":20191493,"url":"https://github.com/jarhill0/tracktimebot","last_synced_at":"2025-08-27T03:19:30.844Z","repository":{"id":90535730,"uuid":"119914115","full_name":"jarhill0/TrackTimeBot","owner":"jarhill0","description":"A Telegram bot to help you track your time.","archived":false,"fork":false,"pushed_at":"2018-06-13T06:12:16.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-13T18:52:51.057Z","etag":null,"topics":["telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/TrackTimeBot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jarhill0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-02T01:17:20.000Z","updated_at":"2018-06-13T06:12:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"3b446e48-0c08-44f6-b67a-b6d681b80740","html_url":"https://github.com/jarhill0/TrackTimeBot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarhill0%2FTrackTimeBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarhill0%2FTrackTimeBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarhill0%2FTrackTimeBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jarhill0%2FTrackTimeBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jarhill0","download_url":"https://codeload.github.com/jarhill0/TrackTimeBot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241629736,"owners_count":19993707,"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":["telegram","telegram-bot"],"created_at":"2024-11-14T03:49:19.551Z","updated_at":"2025-03-03T07:41:19.395Z","avatar_url":"https://github.com/jarhill0.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TrackTimeBot\n\nA Telegram bot to help you track your time.\n\n## Installation:\n\nThe bot depends on a telegram wrapper of mine which is currently pre-alpha. Install the wrapper and the bot\nlike so:\n\n```commandline\npython3 -m pip install git+https://github.com/jarhill0/pawt.git\ngit clone https://github.com/jarhill0/TrackTimeBot.git\n```\n\n## Configuration:\n\n```commandline\ncd TrackTimeBot\ntouch secrets.py\n```\n\nUse an editor of your choice to add the following line to `secrets.py`, with your token substituted for the\nplaceholder:\n\n```python\nTOKEN = '123456789:QwErTyUiOpAsDfGhJkLzXcVbNm'\n```\n\nConfigure the bot with `crontab` (or Task Scheduler if you're on Windows, but then you're on your own). The\nfollowing will work if the bot is in `/home/user/TrackTimeBot`. Modify it appropriately if the bot is in a \ndifferent directory. An absolute path is recommended. \n\n```text\n00 * * * * python3 /home/user/TrackTimeBot/main.py hourly\n55 0 * * * python3 /home/user/TrackTimeBot/main.py daily\n```\n\n## Bot Usage\n\n[Try it out!](https://t.me/TrackTimeBot)\n\nTo interact with the bot:\n\n- /subscribe will subscribe you to bot messages\n- /unsubscribe will unsubscribe you.\n- /help and /start will bring up appropriate messages\n\nEvery hour, on the hour, the bot will message you to ask what you did the previous hour. Reply to its hour \nmessage (e.g. \"3 pm\") at any point during the day, and it will log that activity. Activities can be \nanything you can put in a plain text message (not an image caption, or a caption of anything else), such as\n\"3\" or \"programming\" or \"going to the beach.\"\n\nEvery day at 12:55 am (00:55), the bot will send a comma-separated list of your past 24 hours, assuming you\nresponded with at least one activity in that period.\n\nThe bot currently only supports running on one time zone, since it's largely a project for myself. My \ninstance runs on Pacific Time, but if you set up your own instance, it will run on whatever time zone your \nsystem is configured for.\n\n## Privacy\n\nNone to speak of. As you can see from reading the source code, data is stored as plain JSON on disk. Anyone\nwith access to the server can read your activities. Don't share anything you wouldn't want the server admin\n(me, for my instance) reading.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjarhill0%2Ftracktimebot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjarhill0%2Ftracktimebot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjarhill0%2Ftracktimebot/lists"}