{"id":16165911,"url":"https://github.com/zemmsoares/polybar-notion","last_synced_at":"2025-05-08T02:20:23.759Z","repository":{"id":168236598,"uuid":"621945234","full_name":"zemmsoares/polybar-notion","owner":"zemmsoares","description":"📝 Notion todo / task manager display module for Polybar ","archived":false,"fork":false,"pushed_at":"2023-04-05T19:14:15.000Z","size":4,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-31T16:26:28.641Z","etag":null,"topics":["notion","notion-api","notion-integrations","notion-widgets","polybar","polybar-config","polybar-module","polybar-scripts"],"latest_commit_sha":null,"homepage":"","language":"Python","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/zemmsoares.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-31T18:27:15.000Z","updated_at":"2023-11-08T16:21:04.000Z","dependencies_parsed_at":"2023-06-08T09:30:30.719Z","dependency_job_id":null,"html_url":"https://github.com/zemmsoares/polybar-notion","commit_stats":null,"previous_names":["zemmsoares/polybar-notion"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zemmsoares%2Fpolybar-notion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zemmsoares%2Fpolybar-notion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zemmsoares%2Fpolybar-notion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zemmsoares%2Fpolybar-notion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zemmsoares","download_url":"https://codeload.github.com/zemmsoares/polybar-notion/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252984631,"owners_count":21835825,"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":["notion","notion-api","notion-integrations","notion-widgets","polybar","polybar-config","polybar-module","polybar-scripts"],"created_at":"2024-10-10T02:52:14.204Z","updated_at":"2025-05-08T02:20:23.724Z","avatar_url":"https://github.com/zemmsoares.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# polybar-notion\n\n![polybar-notion](https://user-images.githubusercontent.com/38134965/230176803-1378caa4-b06d-4d70-aa1b-fafc54b03c0e.png)\n\nI'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.\n\n## Installation\n\n1. 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)\n\n2. Obtain an API key from Notion by following the instructions at https://developers.notion.com/docs/create-a-notion-integration.\n\n3. 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.\n\n4. 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)\n\n5. 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:\n\n```\n{\n  \"NOTION_API_KEY\": \"secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\n  \"NOTION_DATABASE_ID\": \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n}\n```\n\n6. Edit main.py and change the path to your own config.json.\n\n## Module\n\n```\n[module/notion]\ntype = custom/script\ninterval = 10.0\n\nexec = python -u ~/.config/polybar/custom-modules/notion/main.py\ntail = true\n\nclick-left = xdg-open https://notion.so/\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzemmsoares%2Fpolybar-notion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzemmsoares%2Fpolybar-notion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzemmsoares%2Fpolybar-notion/lists"}