{"id":15394307,"url":"https://github.com/xyproto/kitchencalendar","last_synced_at":"2025-04-15T23:53:37.219Z","repository":{"id":65829305,"uuid":"600394179","full_name":"xyproto/kitchencalendar","owner":"xyproto","description":":calendar: Generate per-week calendars that are meant to be printed out and hung up in the kitchen area","archived":false,"fork":false,"pushed_at":"2024-05-22T19:37:54.000Z","size":874,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-05-22T19:44:50.902Z","etag":null,"topics":["calendar","kitchen","management","pdf"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xyproto.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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":["xyproto"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2023-02-11T11:03:56.000Z","updated_at":"2024-06-21T02:04:34.372Z","dependencies_parsed_at":"2023-02-20T20:46:27.211Z","dependency_job_id":"ca4d9dd8-3576-4713-b136-16aec81c6d4c","html_url":"https://github.com/xyproto/kitchencalendar","commit_stats":{"total_commits":78,"total_committers":2,"mean_commits":39.0,"dds":"0.17948717948717952","last_synced_commit":"b1eabab80a6d5d15cf7f12fc3791be904546b21d"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xyproto%2Fkitchencalendar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xyproto%2Fkitchencalendar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xyproto%2Fkitchencalendar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xyproto%2Fkitchencalendar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xyproto","download_url":"https://codeload.github.com/xyproto/kitchencalendar/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249173061,"owners_count":21224481,"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","kitchen","management","pdf"],"created_at":"2024-10-01T15:23:09.388Z","updated_at":"2025-04-15T23:53:37.204Z","avatar_url":"https://github.com/xyproto.png","language":"Go","funding_links":["https://github.com/sponsors/xyproto"],"categories":[],"sub_categories":[],"readme":"# Kitchen Calendar\n\n![Build](https://github.com/xyproto/kitchencalendar/workflows/Build/badge.svg) [![Go Report Card](https://goreportcard.com/badge/github.com/xyproto/kitchencalendar)](https://goreportcard.com/report/github.com/xyproto/kitchencalendar) [![License](https://img.shields.io/badge/license-BSD-green.svg?style=flat)](https://raw.githubusercontent.com/xyproto/kitchencalendar/main/LICENSE)\n\nKitchen Calendar is a utility written in Go that can generate PDF files.\n\nEach generated PDF document is a calendar for two specific weeks, for example week 7 and 8.\n\nThis type of calendar can work great for a family of 4, a couple of co-workers or people that live together and need to find a good way to collaborate.\n\n**By printing out and hanging up the calendars on the kitchen cupboard doors, there are no excuses for not having a good overview of what is happening in the weeks ahead, nor for what has been done or completed.**\n\n**Known bug**: The week number on the calendar is wrong for 2025, since week 1 of 2025 starts at the end of 2024, and I didn't think of that. To be fixed soon.\n\nI recommend printing out at least 6 pages, which covers 12 weeks, and hang them all up. It does occupy quite a bit of \"visual space\" in the kitchen, but it's immensely handy and practical.\n\nThe reason why I wrote this utility is because we use it in my family, and it works better for us than Google Calendar or other apps or web pages. The information is readily available without anyone having to \"do anything\" to see it, and one can easily add entries while making tea or coffee.\n\nIn addition to this, \"red dates\" (holidays / flag flying dates) are written in bold text in the calendar. The functionality for detecting \"red days\" comes from the [kal](https://github.com/xyproto/kal) package (this feature needs more testing).\n\nCurrently, only US and Norwegian calendars can be generated, but pull requests for supporting other locales are welcome!\n\nThe line art images comes from the excellent [ln](https://github.com/fogleman/ln) package.\n\n### Example calendar (English, for the US)\n\n![US kitchen calendar](img/us_kitchen_calendar.png)\n\nNote that the 4th of July is in bold.\n\n### Example calendar (Norwegian)\n\n![Norwegian kitchen calendar](img/no_kitchen_calendar.png)\n\nNote that the 17th of May is in bold.\n\n### Installation\n\nGo 1.17 or later is needed for `go install` to work as expected.\n\nInstall the US kitchen calendar generator:\n\n    go install -tags en_US github.com/xyproto/kitchencalendar@latest\n\nInstall the Norwegian kitchen calendar generator:\n\n    go install -tags nb_NO github.com/xyproto/kitchencalendar@latest\n\n### Usage\n\nThe utility takes a list of comma separated names that will be used in the weekly overviews.\n\nFor creating a `calendar_w8_2023.pdf` file:\n\n    kitchencalendar -names Bob,Alice,Mallory,Judy -year 2023 -week 8\n\nFor generating calendars for week 7 to 17 (with 2 weeks on each PDF), for this year\n\n    for x in $(seq 7 2 17); do kitchencalendar -names Bob,Alice,Mallory,Judy -week $x; done\n\n### General info\n\n* Version: 1.0.5\n* License: BSD-3\n* Author: Alexander F. Rødseth\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxyproto%2Fkitchencalendar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxyproto%2Fkitchencalendar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxyproto%2Fkitchencalendar/lists"}