{"id":31266235,"url":"https://github.com/codinglogan/card-calendar-prompt","last_synced_at":"2025-09-23T15:55:35.212Z","repository":{"id":236645840,"uuid":"608938309","full_name":"codingLogan/card-calendar-prompt","owner":"codingLogan","description":null,"archived":false,"fork":false,"pushed_at":"2023-03-13T14:24:21.000Z","size":10,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-14T03:52:17.387Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/codingLogan.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,"publiccode":null,"codemeta":null}},"created_at":"2023-03-03T02:59:55.000Z","updated_at":"2023-03-09T04:16:26.000Z","dependencies_parsed_at":"2024-04-28T05:00:46.870Z","dependency_job_id":"51ad5c19-ff45-467d-9813-787a12b6110f","html_url":"https://github.com/codingLogan/card-calendar-prompt","commit_stats":null,"previous_names":["codinglogan/card-calendar-prompt"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codingLogan/card-calendar-prompt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingLogan%2Fcard-calendar-prompt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingLogan%2Fcard-calendar-prompt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingLogan%2Fcard-calendar-prompt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingLogan%2Fcard-calendar-prompt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codingLogan","download_url":"https://codeload.github.com/codingLogan/card-calendar-prompt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingLogan%2Fcard-calendar-prompt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276604088,"owners_count":25671758,"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","status":"online","status_checked_at":"2025-09-23T02:00:09.130Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":"2025-09-23T15:55:34.138Z","updated_at":"2025-09-23T15:55:35.206Z","avatar_url":"https://github.com/codingLogan.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Card Calendar Prompt\r\n\r\nThis project adds a simple playing-card based calendar section to your PROMPT. Quarters of the year are represented by _suits_, and the week of the current quarter is represented by Ace (low) up to King.  Because years have 52 or 53 weeks, standard card decks can represent calendar weeks!\r\n\r\nFor example a typical prompt shows a username followed by the current directory. With this plugin you can put a card into your prompt that signifies the week of the year.\r\n\r\nMarch 2nd is 9th week of the first quarter so we get `9♥` returned from the plugin (you can put it anywhere in your prompt!).\r\n\r\n```sh\r\n9♥ \u003cusername\u003e ~/dev/card-calendar-prompt $ _\r\n```\r\n\r\nQuarters of the year are represented as follows, the symbols may change slightly depending on the font you use.\r\n\r\n| Month         | Q#  | Symbol | Weeks |\r\n| ------------- | --- | ------ | ----- |\r\n| Jan, Feb, Mar | Q1  | ♥      | 1-13  |\r\n| Apr, May, Jun | Q2  | ♣      | 14-26 |\r\n| Jul, Aug, Sep | Q3  | ♦      | 27-39 |\r\n| Oct, Nov, Dec | Q4  | ♠      | 40-52 |\r\n| Final days    | Q4  | ♛      | 53    |\r\n\r\nCards numbers are represented in order, with \"Ace\" being the low instead of the high.\r\n\r\n| Week Number of Quarter | Symbol |\r\n| ---------------------- | ------ |\r\n| 1                      | A      |\r\n| 2                      | 2      |\r\n| 3                      | 3      |\r\n| 4                      | 4      |\r\n| 5                      | 5      |\r\n| 6                      | 6      |\r\n| 7                      | 7      |\r\n| 8                      | 8      |\r\n| 9                      | 9      |\r\n| 10                     | 10     |\r\n| 11                     | J      |\r\n| 12                     | Q      |\r\n| 13                     | K      |\r\n\r\n## Info About Cards \u0026 Calendars\r\n\r\nThere are always at least 52 weeks in a year, and there could be 53.\r\n\r\n_The weeks of the year in a Gregorian calendar are numbered from week 1 to week 52 or 53, depending on several varying factors. Most years have 52 weeks, but if the year starts on a Thursday or is a leap year that starts on a Wednesday, that particular year will have 53 numbered weeks._\r\n\r\n- https://www.timeanddate.com/\r\n\r\nSo, armed with this information, it is entirely possible to represent all 52 or 53 weeks of a year with a standard deck of face cards, + a Joker card for the 53rd week scenarios.\r\n\r\nNow you know!\r\n\r\n## Pre-requisites\r\n\r\nUnix `date` command must be available in your shell, and your machine must be able to run `bash` scripts\r\n\r\n## Bash Setup\r\n\r\nAdd the following lines to the end of your `~/.bashrc` file. (feel free to customize the PS1 string to your liking)\r\n\r\n```sh\r\n# Card Calendar plugin\r\nsource ~/dev/card-calendar-prompt/prompt.sh\r\nPS1=\"\\$(get_calendar_card) $PS1\"\r\n```\r\n\r\nThe source line should be the path to where you saved the plugin, and the PS1 line is just an example of prepending the card to the prompt.\r\n\r\n## ZSH Setup\r\n\r\nAdd the following lines to the end of your `~/.zshrc` file. (feel free to customize the PROMPT string to your liking)\r\n\r\n```\r\n# Card Calendar plugin\r\nsource ~/dev/card-calendar-prompt/prompt.sh\r\nPROMPT=\"\\$(get_calendar_card) $PROMPT\"\r\n```\r\n\r\n## Supported Shells\r\n\r\nZShell, Bash Shell\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodinglogan%2Fcard-calendar-prompt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodinglogan%2Fcard-calendar-prompt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodinglogan%2Fcard-calendar-prompt/lists"}