{"id":13740754,"url":"https://github.com/croxarens/tmux-timetrap","last_synced_at":"2025-05-08T20:32:33.784Z","repository":{"id":205181159,"uuid":"713586382","full_name":"croxarens/tmux-timetrap","owner":"croxarens","description":"A tmux wrapper for timetrap","archived":false,"fork":false,"pushed_at":"2023-12-29T07:20:21.000Z","size":6,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-08-04T04:07:00.595Z","etag":null,"topics":["time-management","time-management-tools","timetracker","timetrap","timetrap-command","tmux-plugins"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/croxarens.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}},"created_at":"2023-11-02T20:30:21.000Z","updated_at":"2024-01-23T00:40:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"8c198076-da6a-4a01-b6fd-6d088c9420bf","html_url":"https://github.com/croxarens/tmux-timetrap","commit_stats":null,"previous_names":["croxarens/tmux-timetrap"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/croxarens%2Ftmux-timetrap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/croxarens%2Ftmux-timetrap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/croxarens%2Ftmux-timetrap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/croxarens%2Ftmux-timetrap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/croxarens","download_url":"https://codeload.github.com/croxarens/tmux-timetrap/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224765553,"owners_count":17366135,"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":["time-management","time-management-tools","timetracker","timetrap","timetrap-command","tmux-plugins"],"created_at":"2024-08-03T04:00:51.897Z","updated_at":"2024-11-15T10:31:03.718Z","avatar_url":"https://github.com/croxarens.png","language":"Shell","funding_links":[],"categories":["Plugins"],"sub_categories":[],"readme":"# Timetrap Wrapper For TMUX\nA wrapper for [**timetrap**](https://github.com/samg/timetrap) from TMUX.\n\n![demo](https://raw.githubusercontent.com/croxarens/public-assets/master/tmux-timetrap/demo.gif)\n\n\n## Features\n- Display in the status line the current tracked sheet and entry\n- Start tracking time from a past or new entrty in an existing or new sheet\n- Stop tracking time\n\n## Plugin Installation\nYou need to have installed:\n- [Tmux](https://github.com/tmux/tmux/wiki/Installing)\n- [Tmux Plugin Manager (**TPM**)](https://github.com/tmux-plugins/tpm#installing-plugins)\n- [**Timetrap**](https://github.com/samg/timetrap#getting-started)\n- [fzf](https://github.com/junegunn/fzf#installation)\n\nIf all the above are successfully running in your system, you need to add the following line into your `.tmux.conf` file.\n\n`set -g @plugin 'croxarens/tmux-timetrap'`\n\nThan, using TPM, you can install the new plugin hitting `prefix` + `I`, and TPM will do the rest.\n\n\n## Status Bar Installation\n![demo-status-bar](https://raw.githubusercontent.com/croxarens/public-assets/master/tmux-timetrap/demo-status-bar.png)\nTo have the current tracked entries in the TMUX status bar, you need to add the following line into your `.tmux.conf` file.\n\n`set -g status-right \"#($HOME/.tmux/plugins/tmux-timetrap/scripts/status-bar.sh)\"`\n\nThe referesh rate is 15 seconds by default in TMUX, so if you want refresh it more ofter so what when you start/stop a new tracking it quickly reflects on the status bar, you may add the following line into your `.tmux.conf` file:\n\n`set -g status-interval 3     # update the status bar every 3 seconds`\n\n\n## Key bindings\n\n- `prefix` + `A` -\u003e To start tracking an existing entity or a new entity.\n- `prefix` + `S` -\u003e To stop tracking\n\n**Please keep in mind**: When starting a new tracking, if the entry you want is not in the menu you can create a new one by typing the name of the sheet (even if new) folloing with a dot (.) and the name of entry `{sheet name}.{entity name}`.\n\nSo, typing `companyX.bug-fixing` will start tracking a new entry named '**bug-fixing**' in the '**companyX**' sheet.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcroxarens%2Ftmux-timetrap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcroxarens%2Ftmux-timetrap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcroxarens%2Ftmux-timetrap/lists"}