{"id":13836637,"url":"https://github.com/ml729/calfw-blocks","last_synced_at":"2025-07-10T15:33:17.708Z","repository":{"id":100783424,"uuid":"529791301","full_name":"ml729/calfw-blocks","owner":"ml729","description":"Visual enhancements for the Emacs Calendar Framework (calfw)","archived":false,"fork":false,"pushed_at":"2023-10-05T18:14:43.000Z","size":1042,"stargazers_count":36,"open_issues_count":4,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-02-17T07:35:06.819Z","etag":null,"topics":["calendar","emacs"],"latest_commit_sha":null,"homepage":"","language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ml729.png","metadata":{"files":{"readme":"README.org","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2022-08-28T07:19:58.000Z","updated_at":"2024-05-30T01:27:12.110Z","dependencies_parsed_at":"2024-01-13T17:04:38.105Z","dependency_job_id":"2da2af94-568c-4969-8a55-a5ea66c3fc13","html_url":"https://github.com/ml729/calfw-blocks","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/ml729%2Fcalfw-blocks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ml729%2Fcalfw-blocks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ml729%2Fcalfw-blocks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ml729%2Fcalfw-blocks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ml729","download_url":"https://codeload.github.com/ml729/calfw-blocks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225647580,"owners_count":17502107,"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":["calendar","emacs"],"created_at":"2024-08-04T15:00:51.530Z","updated_at":"2024-11-20T23:31:25.006Z","avatar_url":"https://github.com/ml729.png","language":"Emacs Lisp","funding_links":[],"categories":["Emacs Lisp"],"sub_categories":[],"readme":"* calfw-blocks.el\n\nVisual time blocks and more for the [[https://github.com/kiwanami/emacs-calfw][Emacs Calendar Framework (calfw)]].\n\n* Screenshot\nWeekly block view:\n[[screenshot.png]]\n\nTransposed two week view:\n[[screenshot-transpose.png]]\n\n* Installation\n** Manual Installation\nClone this git repo (e.g. to `~/.emacs.d/site-lisp/')\n#+begin_src\ncd ~/.emacs.d\nmkdir site-lisp\ncd site-lisp\ngit clone https://github.com/ml729/calfw-blocks\n#+end_src\n\nAnd add its path to `'load-path':\n#+begin_src emacs lisp\n(add-to-list 'load-path \"~/.emacs.d/site-lisp/calfw-blocks\")\n#+end_src\n\nMake sure this package is loaded after calfw.\n\n* Usage\nThis package comes with the following ~calfw~ views that display time blocks:\n#+begin_src\n'block-day\n'block-week\n'block-2-day\n'block-3-day\n'block-4-day\n'block-5-day\n#+end_src\nThe ~block-week~ view always starts on Sunday.\nThe ~block-day~ and ~block-\u003cn\u003e-day~ views always start on the current day. The top right button labelled ~Week~ uses ~block-week~.\n\nThe package also includes two-column transposed versions of the original calfw views (credit to @novoid for the [[https://github.com/kiwanami/emacs-calfw/issues/22][design]]), where days of the week are displayed vertically rather than horizontally:\n#+begin_src\n'transpose-8-day\n'transpose-10-day\n'transpose-12-day\n'transpose-14-day\n'transpose-two-weeks\n#+end_src\nThe ~transpose-\u003cn\u003e-day~ views always start on the current day, and ~transpose-two-weeks~ always starts on the most recent Sunday. The top right buttons labelled ~W^T~ and ~2W^T~ use ~transpose-8-day~ and ~transpose-14-day~, respectively.\n\nYou can use these to define functions that directly open calfw with these views.\nExamples:\n#+begin_src emacs lisp\n;; Calendar showing org-agenda entries\n(defun my-open-calendar-agenda ()\n  (interactive)\n  (cfw:open-calendar-buffer\n   :contents-sources\n   (list\n    (cfw:org-create-source \"medium purple\"))\n   :view 'block-week))\n\n;; Calendar showing org entries from files\n(defun my-open-calendar-files ()\n  (interactive)\n  (cfw:open-calendar-buffer\n   :contents-sources\n   (list\n    (cfw:org-create-file-source \"Todos\" \"~/stuff/todos.org\" \"green\")\n    (cfw:org-create-file-source \"Events\" \"~/stuff/events.org\" \"blue\"))\n   :view 'block-3-day))\n#+end_src\n\n* Customization\nNotable customization options:\n- ~calfw-blocks-earliest-visible-time~: what time of day the calendar starts at.\n- ~calfw-blocks-show-time-grid~: shows a time grid if non-nil.\n- ~calfw-blocks-default-event-length~: the length in hours of events with a start time but no end time; used to determine the size of the rendered block.\n- ~calfw-blocks-lines-per-hour~: how many lines each hour gets.\n- ~calfw-blocks-min-block-width~: the smallest width a block can be in characters (includes divider character). If there are too many concurrent events, some events are hidden so that all blocks are at least `calfw-blocks-min-block-width' characters wide.\n\n* Known Issues\nDoes not currently handle multiday events with times on both the start and end dates, such as:\n#+begin_example\nSCHEDULED: \u003c2023-07-06 Thu 19:00\u003e--\u003c2023-07-07 Fri 5:00\u003e\n#+end_example\n\n\n\n* License\nGNU General Public License v3.0 (GPLv3)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fml729%2Fcalfw-blocks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fml729%2Fcalfw-blocks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fml729%2Fcalfw-blocks/lists"}