https://github.com/zemmsoares/polybar-notion
📝 Notion todo / task manager display module for Polybar
https://github.com/zemmsoares/polybar-notion
notion notion-api notion-integrations notion-widgets polybar polybar-config polybar-module polybar-scripts
Last synced: about 1 month ago
JSON representation
📝 Notion todo / task manager display module for Polybar
- Host: GitHub
- URL: https://github.com/zemmsoares/polybar-notion
- Owner: zemmsoares
- Created: 2023-03-31T18:27:15.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-04-05T19:14:15.000Z (about 2 years ago)
- Last Synced: 2025-03-15T00:51:11.276Z (about 2 months ago)
- Topics: notion, notion-api, notion-integrations, notion-widgets, polybar, polybar-config, polybar-module, polybar-scripts
- Language: Python
- Homepage:
- Size: 3.91 KB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# polybar-notion
I've tried various methods to track my to-dos, but they were either too complex or inconvenient. By using this module with Notion, I can easily view my to-dos in the status bar. The way I have it set up, the module displays overdue tasks, tasks for today, and tasks without a due date. When a task's due date arrives, it moves into the today's tasks section, and incomplete tasks move into the overdue section. It's also convenient because I can manage my tasks on either my PC or mobile app, and the updates will be reflected in the status bar.
## Installation
1. Create a to-do list on Notion by going to "Templates" and selecting "To-do list". [Reference Image](https://user-images.githubusercontent.com/38134965/230175312-c043727e-b9c1-46d0-af93-2d8fdaf6343c.png)
2. Obtain an API key from Notion by following the instructions at https://developers.notion.com/docs/create-a-notion-integration.
3. Obtain the database ID by copying the link to your to-do list in Notion. The database ID is the string of characters between "https://www.notion.so/" and "?v=" in the link.
4. In your Notion integration settings, go to "Add Connections" and select the integration you created in step 2. [Reference Image](https://user-images.githubusercontent.com/38134965/230175322-4e1f56bd-fa40-4770-acdb-1a69b3e141f8.png)
5. Create a config.json file in the same directory as main.py with the following contents, replacing the values with your own API key and database ID:
```
{
"NOTION_API_KEY": "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"NOTION_DATABASE_ID": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
```
6. Edit main.py and change the path to your own config.json.
## Module
```
[module/notion]
type = custom/script
interval = 10.0
exec = python -u ~/.config/polybar/custom-modules/notion/main.py
tail = true
click-left = xdg-open https://notion.so/
```