{"id":13572453,"url":"https://github.com/trimailov/timeflow","last_synced_at":"2026-01-10T22:47:14.849Z","repository":{"id":62584794,"uuid":"42891170","full_name":"trimailov/timeflow","owner":"trimailov","description":"Simple cli time tracker inspired by gtimelog","archived":false,"fork":false,"pushed_at":"2018-07-28T09:35:09.000Z","size":419,"stargazers_count":17,"open_issues_count":1,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-10T16:15:58.273Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/trimailov.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-09-21T20:13:01.000Z","updated_at":"2024-02-26T10:46:55.000Z","dependencies_parsed_at":"2022-11-03T22:00:51.731Z","dependency_job_id":null,"html_url":"https://github.com/trimailov/timeflow","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trimailov%2Ftimeflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trimailov%2Ftimeflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trimailov%2Ftimeflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trimailov%2Ftimeflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trimailov","download_url":"https://codeload.github.com/trimailov/timeflow/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247160159,"owners_count":20893778,"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-08-01T14:01:23.528Z","updated_at":"2026-01-10T22:47:14.799Z","avatar_url":"https://github.com/trimailov.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"timeflow\n========\nsimple CLI time logger, inspired by `gtimelog \u003chttps://github.com/gtimelog/gtimelog\u003e`_\n\n.. image:: img/description.png\n\nDescription\n-----------\n``timeflow`` is a simple CLI time logger, used for logging your activities and\nfeaturing simple statistics and reporting capabilities\n\n``timeflow`` can be called using either ``tf`` or ``timeflow`` commands\n\nInstall\n-------\n\n``pip3 install timeflow``\n\nWritten in ``python3``. Best user experience with ``python3``.\n\nTutorial\n-----------------\n::\n\n    to start working (message content is not important)\n    \u003e\u003e\u003e tf log \"Arrived.\"\n\n    to save a timestamp and your log message,\n    when finished doing a task write\n    \u003e\u003e\u003e tf log \"Timeflow: create README.rst\"\n\n    here 'Timeflow' is a 'project' you were working on and 'create README.rst'\n    is a log of what you were exactly doing this time. Both project and log\n    must be separated by a colon and space (``: ``).\n\n    some tasks are not (payable) work, mark them with two asterisks (**)\n    \u003e\u003e\u003e tf log \"Slack: chatting in the office ** \"\n\n    you can have 'projects' without any explanations\n    \u003e\u003e\u003e tf log \"Lunch ** \"\n    \u003e\u003e\u003e tf log \"Daily Scrum\"\n\n    if you made a mistake, or missed to log of your activities\n    you can edit like this\n    \u003e\u003e\u003e tf edit\n\n    this way timeflow will try to run your editor set in $EDITOR\n    or you can try\n    \u003e\u003e\u003e tf edit -e vim\n\n    to open log file in vim\n\n    to check how much you've worked today\n    \u003e\u003e\u003e tf stats\n\n    or to make a report\n    \u003e\u003e\u003e tf stats --report\n\n    you can pass date ranges for stats command, e.g.\n    \u003e\u003e\u003e tf stats --from 2015-01-01 --to 2015-01-31\n    \u003e\u003e\u003e tf stats --from 2015-01-01 --to 2015-01-31 --report\n\nCommands \u0026 options\n------------------\n``log``\n    ``log LOG_TEXT`` - create new log entry to timeflow's log file.\n\n``edit``\n    opens timeflow's log file, by default trying to open an editor used in ``$EDITOR`` environment variable.\n\n    ``-e EDITOR`` - passes editor to be used in opening log file.\n\n``stats``\n    shows today's work and slack time.\n\n    ``-y, --yesterday`` - shows yesterday's work and slack time.\n\n    ``-d DATE, --day DATE`` - shows arbitrary day's work and slack time.\n\n    ``--week WEEK_NUMBER`` - shows arbitrary week's work and slack time.\n\n    ``--this-week`` - shows this week's work and slack time.\n\n    ``--last-week`` - shows last week's work and slack time.\n\n    ``--month MONTH_NUMBER`` - shows arbitrary month's work and slack time.\n\n    ``--this-month`` - shows this month's work and slack time.\n\n    ``--last-month`` - shows last month's work and slack time.\n\n    ``-f DATE, --from DATE`` - shows work and slack time, from DATE until today, if ``--to`` option is not used.\n\n    ``-t DATE, --to DATE`` - shows work and slack time, up to DATE. Must be used with ``--from`` option.\n\n    ``--report`` - shows report for today, or some other time range if specified using available options.\n\n    ``--report-as-gtimelog`` - same as ``--report``, but the output is like in `gtimelog \u003chttps://github.com/gtimelog/gtimelog\u003e`_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrimailov%2Ftimeflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrimailov%2Ftimeflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrimailov%2Ftimeflow/lists"}