{"id":13680362,"url":"https://github.com/bard/org-dashboard","last_synced_at":"2026-01-27T01:05:41.139Z","repository":{"id":33661318,"uuid":"37313867","full_name":"bard/org-dashboard","owner":"bard","description":"Visual summary of progress in projects and tasks for Emacs Org Mode","archived":false,"fork":false,"pushed_at":"2019-02-11T21:22:21.000Z","size":18,"stargazers_count":109,"open_issues_count":3,"forks_count":12,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-10-26T08:51:50.892Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Emacs Lisp","has_issues":false,"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/bard.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}},"created_at":"2015-06-12T09:33:42.000Z","updated_at":"2025-08-25T05:15:31.000Z","dependencies_parsed_at":"2022-09-08T15:21:44.119Z","dependency_job_id":null,"html_url":"https://github.com/bard/org-dashboard","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bard/org-dashboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bard%2Forg-dashboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bard%2Forg-dashboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bard%2Forg-dashboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bard%2Forg-dashboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bard","download_url":"https://codeload.github.com/bard/org-dashboard/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bard%2Forg-dashboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28794597,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T21:49:50.245Z","status":"ssl_error","status_checked_at":"2026-01-26T21:48:29.455Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-02T13:01:16.308Z","updated_at":"2026-01-27T01:05:41.118Z","avatar_url":"https://github.com/bard.png","language":"Emacs Lisp","funding_links":[],"categories":["Emacs Lisp"],"sub_categories":[],"readme":"# org-dashboard - Visually summarize progress in org files\n\nOrg Dashboard provides a visual summary of progress on projects and\ntasks.\n\nFor example, if an org file (known by `org-dashboard-files`) contains\nthe following:\n\n    * Project: Better Health\n    :PROPERTIES:\n    :CATEGORY: health\n    :END:\n\n    ** Milestones\n    *** [66%] run 10 km/week\n    **** TODO learn proper warmup\n    **** DONE look for a jogging partner\n    **** DONE run 10 minutes on monday\n    \n    * Project: Super Widget\n    :PROPERTIES:\n    :CATEGORY: widget\n    :END:\n\n    ** Milestones\n    *** [1/6] release 0.1\n    **** DONE git import\n    **** TODO create github project\n    **** TODO add readme\n    **** TODO publish\n\nThen \u003ckbd\u003eM-x org-dashboard-display\u003c/kbd\u003e generates the following report and\ndisplays it in a new buffer:\n\n    health                run 10 km/week [||||||||||||||||||||||           ]  66%\n    widget                   0.1 release [||||||                           ]  18%\n\nA dynamic block form is also supported. Writing the following in an\norg file and then running `org-dblock-update`, or placing the\ncursor on the first line of the block and then typing \u003ckbd\u003eC-c C-c\u003c/kbd\u003e,\nwill insert the same report shown above into the block:\n\n    #+BEGIN: block-dashboard\n    #+END:\n\n## Configuration\n\nYou can customize the following variables:\n\n- `org-dashboard-files`: list of files to search for progress entries; defaults to `org-agenda-files`\n- `org-dashboard-show-category`: whether to show or not the project category\n- `org-dashboard-filter`: a function that decides whether an entry should be displayed or not\n\nFor example, to avoid displaying entries that are finished\n(progress = 100), not started (progress = 0), or are tagged with\n\"archive\", use the following:\n\n       (defun my/org-dashboard-filter (entry)\n         (and (\u003e (plist-get entry :progress-percent) 0)\n              (\u003c (plist-get entry :progress-percent) 100)\n              (not (member \"archive\" (plist-get entry :tags)))))\n\n       (setq org-dashboard-filter 'my/org-dashboard-filter)\n\n## Notes\n\nLabels link back to the trees where they were found. \n\nThe color of the progress bar is (naively, for now) chosen based on\nthe progress value, from dark red to bright green.\n\nIf not set per-tree through a property or per-file through a\nkeyword, the category defaults to the file name without extension.\nTo set category on a per-file basis, you can add the following at\nthe bottom of the org file:\n\n   #+CATEGORY: xyz\n\n## Related work\n\nThis module was inspired by Zach Peter's [A Dashboard for your\nLife](http://thehelpfulhacker.net/2014/07/19/a-dashboard-for-your-life-a-minimal-goal-tracker-using-org-mode-go-and-git/).\n\n## Contributions\n\n- one feature or fix per pull request\n- provide an example of the problem it addresses\n- please adhere to the existing code style\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbard%2Forg-dashboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbard%2Forg-dashboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbard%2Forg-dashboard/lists"}