Weeknote
pendingby mori-shio
Manage weekly reports with tasks, memos, and calendar sync.
Weeknote Plugin for Obsidian
Efficiently manage your weekly reports with this Obsidian plugin.
It provides an integrated tool for managing tasks, notes, and Google Calendar events in a weekly format.
If you find this plugin useful, please consider supporting me on Ko-fi.
✨ Features
📅 Weeknote View
- Calendar Navigation: Browse through weeks easily.
- Daily Tabs: Switch between days with a Chrome-like tab interface.
- Layout Selection: Choose from 2-panel, 3-panel, 3-panel horizontal, or T-panel layouts.
📋 Task Management
- Checklists: Track the completion status of your tasks.
- Hierarchical Support: Manage subtasks with indentation.
- Keyboard Navigation: Select with arrow keys, reorder or change indentation with Shift + arrow keys.
- Quick Deletion: Delete tasks with Shift + Delete.
📝 Quick Memo
- Timstamped Memos: Automatically record the time for each entry.
- Rich Links: Automatically converts URLs into Markdown links with titles.
- GitHub Integration: Displays GitHub Issue/PR links as rich tags.
📆 Google Calendar Integration
- ICS URL Support: Sync with your Google Calendar via secret ICS URL.
- Auto Schedule: Automatically display events for the selected day.
- Event Filters: Exclude specific events using regular expressions.
🔗 GitHub Integration
- Personal Access Token Auth: Load your private/public GitHub Issues and PRs.
- Rich Tag Display: Visual tags for Issues and PRs for better readability.
- Auto Link Conversion: Paste a GitHub URL to automatically fetch its title.
📥 Installation
Manual Installation
- Download
main.js,manifest.json, andstyles.cssfrom the latest release. - Create a
weeknotefolder in your Obsidian plugins directory:- macOS:
~/Library/Application Support/Obsidian/Vault/.obsidian/plugins/weeknote/ - Windows:
%APPDATA%\Obsidian\Vault\.obsidian\plugins\weeknote\
- macOS:
- Copy the downloaded files into that folder.
- Restart Obsidian and enable "Weeknote" under Settings → Community plugins.
⚙️ Settings
Week Settings
- Week Start Day: Choose Monday or Sunday as the start of your week.
Path Settings
- Save Folder: Specify the path where weeknote files will be saved.
- Filename Format: Customize the filename using Moment.js tokens.
Calendar Integration
- Google Calendar ICS URL: Set your calendar's secret address.
- Exclude Patterns: Filter out specific events using regex.
GitHub Integration
- Personal Access Token: Set your GitHub PAT.
- API Cache Duration: Set how long to cache API responses.
Memo Settings
- Timestamp Format: Customize using Moment.js tokens.
- Placeholder: Hint text for the memo input field.
- Post Button Label: Customize the text on the post button.
- Auto-link URLs: Automatically convert pasted URLs to Markdown links.
🖥️ Keyboard Shortcuts
Task Operations
| Key | Action |
|---|---|
↑ / ↓ | Select task |
Shift + ↑/↓ | Reorder task |
Shift + ←/→ | Change indentation level |
Enter | Enter edit mode |
Shift + Delete | Delete task |
Escape | Deselect |
Memo Operations
| Key | Action |
|---|---|
Enter | Post memo / Save edit |
Shift + Tab | Move to card selection |
Tab | Navigate between cards |
Delete | Delete selected memo |
Escape | Deselect |
🔧 Development
Build
npm install
npm run build
Dev Mode
npm run dev
📄 License
MIT License
🤝 Contributions
Issues and Pull Requests are welcome!
For plugin developers
Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.