{"id":13625987,"url":"https://github.com/liamcain/obsidian-periodic-notes","last_synced_at":"2025-05-16T03:07:25.067Z","repository":{"id":37383648,"uuid":"335861818","full_name":"liamcain/obsidian-periodic-notes","owner":"liamcain","description":"Create/manage your daily, weekly, and monthly notes in Obsidian","archived":false,"fork":false,"pushed_at":"2024-08-23T22:56:22.000Z","size":84372,"stargazers_count":1096,"open_issues_count":151,"forks_count":83,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-04-08T14:03:44.137Z","etag":null,"topics":["obsidian-md","obsidian-plugin"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/liamcain.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":["liamcain"],"custom":["https://paypal.me/hiliam","https://buymeacoffee.com/liamcain"]}},"created_at":"2021-02-04T06:33:57.000Z","updated_at":"2025-04-07T08:27:29.000Z","dependencies_parsed_at":"2024-08-23T23:57:41.605Z","dependency_job_id":null,"html_url":"https://github.com/liamcain/obsidian-periodic-notes","commit_stats":{"total_commits":92,"total_committers":9,"mean_commits":"10.222222222222221","dds":0.08695652173913049,"last_synced_commit":"a8aa7e4e368ac344282b17e381b9101af12af0d1"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liamcain%2Fobsidian-periodic-notes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liamcain%2Fobsidian-periodic-notes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liamcain%2Fobsidian-periodic-notes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liamcain%2Fobsidian-periodic-notes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/liamcain","download_url":"https://codeload.github.com/liamcain/obsidian-periodic-notes/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254459088,"owners_count":22074605,"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":["obsidian-md","obsidian-plugin"],"created_at":"2024-08-01T21:02:07.230Z","updated_at":"2025-05-16T03:07:20.058Z","avatar_url":"https://github.com/liamcain.png","language":"TypeScript","funding_links":["https://github.com/sponsors/liamcain","https://paypal.me/hiliam","https://buymeacoffee.com/liamcain"],"categories":["TypeScript","🔌 Recommended Plugins"],"sub_categories":[],"readme":"# Periodic Notes ⌚\n\nThe Periodic Notes plugin expands on the idea of daily notes and introduces weekly and monthly notes.\n\n## Weekly Notes\n\n### Commands\n\n#### Open Weekly Note\n\nOpens the weekly note for the current week. If one doesn't exist, it will create one automatically for you.\n\n#### Next Weekly Note\n\nNavigates to the next weekly note chronologically. Skips over weeks with no weekly note file.\n\n\u003e **Note:** This command is only available if the active focused note is a weekly note.\n\n#### Previous Weekly Note\n\nNavigates to the previous weekly note chronologically. Skips over weeks with no weekly note file.\n\n\u003e **Note:** This command is only available if the active focused note is a weekly note.\n\n### Calendar Plugin Integration\n\nIf you have \"Week numbers\" enabled from the Calendar plugin, the calendar will automatically use your weekly note settings to create a seamless experience.\n\n#### Weekly Notes are moving\n\nIf you currently use the Calendar plugin, you might be thinking \"doesn't the Calendar plugin already do this?\" To which the answer is: **yes**. This plugin provides the same functionality as the Calendar plugin's weekly notes. However, [weekly notes are moving away from the Calendar plugin to this one](https://github.com/liamcain/obsidian-calendar-plugin#weekly-notes-have-a-new-home).\n\n#### Migrating\n\nIf you currently use weekly notes with the Calendar plugin, your settings will automatically be migrated over and the calendar plugin still function the same way it did before.\n\nYou can create a Daily Note either by clicking on the calendar icon in the left panel, or with the Command palette. You can also set a hotkey in Keyboard shortcuts.\n\n### Weekly Settings\n\n| Setting  | Description                                                                                                                                                                                          |\n| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Folder   | The folder that your weekly notes go into. It can be the same or different from your daily notes. By default they are placed in your vault root.                                                     |\n| Template | Configure a template for weekly notes. Weekly notes have slightly different template tags than daily notes. See here for the list of supported [weekly note template tags](#weekly-template-tags).          |\n| Format   | The date format for the weekly note filename. Defaults to `gggg-[W]ww`. If you use `DD` in the week format, this will refer to first day of the week (Sunday or Monday, depending on your settings). |\n\n### Weekly Template Tags\n\n| Tag                                                                                    | Description                                                                                                                                                                                                  |\n| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `title`                                                                                | Works the same as the daily note `{{title}}`. It will insert the title of the note                                                                                                                           |\n| `date`, `time`                                                                         | Works the same as the daily note `{{date}}` and `{{time}}`. It will insert the date and time of the first day of the week. Useful for creating a heading (e.g. `# {{date:gggg [Week] ww}}`).                 |\n| `sunday`, `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`, `sunday` | Because weekly tags refer to main days, you can refer to individual days like this `{{sunday:YYYY-MM-DD}}` to automatically insert the date for that particular day. Note, you must specify the date format! |\n\n## Monthly Notes\n\n### Commands\n\n#### Open Monthly Note\n\nOpens the monthly note for the current week. If one doesn't exist, it will create one automatically for you.\n\n#### Next Monthly Note\n\nNavigates to the next monthly note chronologically. Skips over weeks with no monthly note file.\n\n\u003e **Note:** This command is only available if the active focused note is a monthly note.\n\n#### Previous Monthly Note\n\nNavigates to the previous monthly note chronologically. Skips over weeks with no monthly note file.\n\n\u003e **Note:** This command is only available if the active focused note is a monthly note.\n\n### Calendar Plugin Integration\n\nComing soon! I just have to figure out a good place to show it in the UI.\n\n### Monthly Settings\n\n| Setting  | Description                                                                                                                                                                                        |\n| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Folder   | The folder that your monthly notes go into. It can be the same or different from your daily notes. By default they are placed in your vault root.                                                  |\n| Template | Configure a template for monthly notes. Monthly notes have slightly different template tags than daily notes. See here for the list of supported [monthly note template tags](#monthly-template-tags).     |\n| Format   | The date format for the monthly note filename. Defaults to `YYYY-MM`. If you use `DD` in the week format, this will refer to first day of the week (Sunday or Monday, depending on your settings). |\n\n### Monthly Template Tags\n\n| Tag            | Description                                                                                                                                                                            |\n| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `title`        | Works the same as the daily note `{{title}}`. It will insert the title of the note                                                                                                     |\n| `date`, `time` | Works the same as the daily note `{{date}}` and `{{time}}`. It will insert the date and time of the first day of the week. Useful for creating a heading (e.g. `# {{date:MMM YYYY}}`). |\n\n---\n\n## FAQ\n\n### How do I use a variable in the folder path?\n\nIf you want new daily notes to show up in the folder `Journal/2021/` for example, you can include the folder in the \"Format\" field. For example:\n\u003cimg width=\"500\" alt=\"image\" src=\"https://user-images.githubusercontent.com/693981/111852801-c1cd8e00-88ee-11eb-9542-b7d840239037.png\"\u003e\n\n### Why the weekly note title is wrong with the week number?\n\nDepending on your locale and operating system you are using, you may have been adopting either ISO week (first week of the year is started on the first Thursday) or Week of Year (first week of the year is started on the first day). Obsidian Periodic Notes uses Week of Year by default (ww), but you can change to ISO week by using (WW) instead. For more details, please refer to [MomentJS documentation](https://momentjs.com/docs/#/displaying/format/).\n\n---\n\n## Sponsors 🙏\n\nA big thank you to everyone that has sponsored this project.\n\n- [Carlo Zottman](https://github.com/czottmann), creator of [Actions for Obsidian](https://actions.work/actions-for-obsidian)\n- [Brian Grohe](https://github.com/paxnovem)\n- [Ben Hong](https://github.com/bencodezen)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliamcain%2Fobsidian-periodic-notes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliamcain%2Fobsidian-periodic-notes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliamcain%2Fobsidian-periodic-notes/lists"}