{"id":17760526,"url":"https://github.com/fuco1/org-clock-budget","last_synced_at":"2026-01-08T09:47:27.900Z","repository":{"id":150147628,"uuid":"44836379","full_name":"Fuco1/org-clock-budget","owner":"Fuco1","description":"Budget your time with org!","archived":false,"fork":false,"pushed_at":"2021-01-07T22:28:38.000Z","size":153,"stargazers_count":77,"open_issues_count":8,"forks_count":5,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-02-07T07:46:31.797Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Emacs Lisp","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/Fuco1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["Fuco1"],"patreon":"matusgoljer","custom":"https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=A5PMGVKCQBT88"}},"created_at":"2015-10-23T20:18:48.000Z","updated_at":"2024-09-17T20:43:26.000Z","dependencies_parsed_at":"2023-04-09T12:15:15.427Z","dependency_job_id":null,"html_url":"https://github.com/Fuco1/org-clock-budget","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/Fuco1%2Forg-clock-budget","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fuco1%2Forg-clock-budget/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fuco1%2Forg-clock-budget/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fuco1%2Forg-clock-budget/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Fuco1","download_url":"https://codeload.github.com/Fuco1/org-clock-budget/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246644095,"owners_count":20810687,"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-26T19:03:25.821Z","updated_at":"2026-01-08T09:47:27.872Z","avatar_url":"https://github.com/Fuco1.png","language":"Emacs Lisp","readme":"# org-clock-budget\n\nBudget your time with `org-mode`!\n\n# Usage\n\n## Adding budgets\n\nYou can specify the intervals you want to use by customizing\n`org-clock-budget-intervals`.\n\nCurrently four intervals are built-in, week, month, quarter (3-month\nperiods starting January 1st) and year. To add a budget on a task, add\na property (`C-c C-x p`) called either `BUDGET_WEEK`, `BUDGET_MONTH`,\n`BUDGET_QUARTER`, or `BUDGET_YEAR`.\n\nIn addition, users can also define their own intervals by adding a\nname and a function calculating the `(FROM . TO)` interval for your\nname to `org-clock-budget-intervals`.\n\nThe properties can hold two types of values, either a number which is\nthen interpreted as number of minutes or a `HH:MM` string which is\nparsed in the obvious way.\n\nThe budgets are repeating, which means each next interval will get the\nsame budget as the previous.  You can remove the property to remove\nthe budget.\n\nYou can specify how many hours per day you want to have available for\nbudgeting (i.e. _budgetable_).  This is configured with\n`org-clock-budget-daily-budgetable-hours`.  By default it's 12 hours,\nassuming the 8 hour work day with 4 hours of leisure activities.  The\nnumber of hours per budget-interval is calculated based on the number\nof days in said interval, that is 7 for a week, 28-31 for months and\nso on.\n\n## Running reports\n\nRun `M-x org-clock-budget-report`.  You can click on the names to jump\nto the task.  Hitting `s` on a column will sort, hitting `s` again\nwill resort in opposite direction.  Hitting `g` reloads the report.\n\nThis is how the report looks:\n\n![Report](./static/screen1.png)\n\nFor every enabled interval you will get three columns, first the\nbudget, then the real clocked time and last a percentage of used up\nbudget.  When you go over 100% it means you are overspending.  The\ngroups are (horizontally) ordered the same way as\n`org-clock-budget-intervals`.\n\nThe report also includes a row describing how many hours from the\ninterval are already budgeted and how many can still be assigned to an\nactivity:\n\n```\n| Task                | Y budget | Y clocked | Y C/G | M budget | M clocked | M C/G | W budget | W clocked | W C/G |\n|---------------------+----------+-----------+-------+----------+-----------+-------+----------+-----------+-------|\n    ...\n    ...\n| Budgeted/Clocked    |  3502:00 |   1468:06 | 41.9% |   122:00 |     50:05 | 41.1% |    75:20 |      0:00 |  0.0% |\n|---------------------+----------+-----------+-------+----------+-----------+-------+----------+-----------+-------|\n| Budgetable hours    |  4392:00 |    890:00 | 79.7% |   372:00 |    250:00 | 32.8% |    84:00 |      8:40 | 89.7% |\n\nlegend for the last row: ^Total budgetable hours\n                                      ^Remaining hours to budget\n                                               ^ Ratio of how many hours are budgeted against the total\n```\n\nThe colors can be customized using `org-clock-budget-ratio-faces` and\n`org-clock-budgeted-ratio-faces`.\n\n# F.A.Q.\n\n## How does this differ from Effort estimates?\n\nEffort is an estimate of how long a task will take you to complete.\nYou might get overdue or finish sooner, and that's fine because\nestimates are guesswork.  However, time/clock budget is a fixed\nquantity you can't go overdue with.  A person working 40-hour week has\nonly about 40 hours of free time (5h for 5 work days and 2x10 for\nweekend), and that's it.\n\nTo *plan* your tasks you use effort estimates, to schedule them within\nweeks or months you use *budget* (sometimes called *capacity* or\n*goal*).\n\nFor example, you can have a task which might have 30 hour estimate,\nand you wish to work on it for 3 weeks.  Therefore, you'd budget 10\nhours weekly to work on this task and no more, allocating the rest of\nthe time to other tasks.  If your estimate was too little, you will\nsimply extend the period for another week of 10 hours.  If it was too\nmuch, you can re-budget the surplus time on other tasks.\n\n## Why should I want to budget my time?\n\nResource allocation is the basis of effectivity.  With a purposeful\nbudget you won't get overwhelmed about thinking what to do when.  Once\nyou use up all your hours it means you need to work on something else.\nThis way you can spread your work on different tasks to avoid burnout.\nCoupled with basic scheduling this can lead to surprising amount of\n\"administration\" time saved.\n\n## When should I budget my time?\n\nA \"recommended\" work-flow is to have a weekly (or by-weekly) recurring\ntask called \"Plan for next week\" (fortnight/month...) where you\nconsolidate your tasks and refine your budgets, review stale tasks\netc.  This can take anywhere from 10 to 60 minutes depending on your\nlevel of sophistication.  Hitting the sweet-spot of not wasting more\ntime than necessary while freeing you from all the cognitive burden\nduring the week might take some practice and discipline.\n","funding_links":["https://github.com/sponsors/Fuco1","https://patreon.com/matusgoljer","https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=A5PMGVKCQBT88"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuco1%2Forg-clock-budget","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffuco1%2Forg-clock-budget","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuco1%2Forg-clock-budget/lists"}