{"id":19030315,"url":"https://github.com/chmouel/nextmeeting","last_synced_at":"2025-06-21T09:06:11.741Z","repository":{"id":66897145,"uuid":"589941880","full_name":"chmouel/nextmeeting","owner":"chmouel","description":" nextmeeting - Show your google calendar next meeting in your waybar or polybar","archived":false,"fork":false,"pushed_at":"2025-04-18T16:37:38.000Z","size":100,"stargazers_count":37,"open_issues_count":1,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-21T09:05:54.846Z","etag":null,"topics":["polybar-scripts","swaywm","waybar-scripts"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chmouel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"zenodo":null}},"created_at":"2023-01-17T09:56:56.000Z","updated_at":"2025-05-29T02:46:30.000Z","dependencies_parsed_at":"2024-03-25T09:59:15.950Z","dependency_job_id":"d4811402-75c2-4a76-bc8a-1591dbf178cb","html_url":"https://github.com/chmouel/nextmeeting","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/chmouel/nextmeeting","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Fnextmeeting","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Fnextmeeting/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Fnextmeeting/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Fnextmeeting/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chmouel","download_url":"https://codeload.github.com/chmouel/nextmeeting/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Fnextmeeting/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261095311,"owners_count":23108784,"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":["polybar-scripts","swaywm","waybar-scripts"],"created_at":"2024-11-08T21:17:29.995Z","updated_at":"2025-06-21T09:06:06.722Z","avatar_url":"https://github.com/chmouel.png","language":"Python","funding_links":[],"categories":["others"],"sub_categories":[],"readme":"# nextmeeting - Show your calendar next meeting in your waybar or polybar\n\n## What is it?\n\nnextmeeting is a simple CLI leveraging gcalcli to show the next meetings.\n\nIt has a few features compared to just gcalcli :\n\n- bar integration (i.e: [waybar](https://github.com/Alexays/Waybar)/[polybar](https://github.com/polybar/polybar) and probably others)\n- smart date in English (not just the date, tomorrow or others)\n- show the time to go for current meeting\n- change colors if there is 5 minutes to go to the meeting\n- hyperlink in default view to click on terminal\n- notification via notify-send 5 minutes before meeting\n- title ellipsis\n- Exclude next day meetings.\n\n## Screenshot\n\n![192647099-ccfa2002-0db3-4738-a54b-176a03474483](https://user-images.githubusercontent.com/98980/212869786-1acd56e2-2e8a-4255-98c3-ebbb45b28d6e.png)\n\n## Installation\n\nUse `pip` with:\n\n`pip install -U nextmeeting`\n\nor Checkout the source of this repo by [using uv](https://docs.astral.sh/uv/getting-started/installation/):\n\n`uv run nextmeeting`\n\nIf you don't want to use `uv` you can install the dependences packages from PyPi\nor from your operating system package manager if available:\n\n- \u003chttps://pypi.org/project/python-dateutil/\u003e\n- \u003chttps://pypi.org/project/gcalcli/\u003e\n\nAnd the you can run the nextmeeting script:\n\n`python3 ./nextmeeting/cli.py`\n\nalternatively you can even just copy the `./nextmeeting/cli.py` script to your path and run\nit to make it more convenient.\n\n### [AUR](https://aur.archlinux.org/packages/nextmeeting)\n\n```shell\nyay -S nextmeeting\n```\n\n## How to use it?\n\nYou need to install [gcalcli](https://github.com/insanum/gcalcli) and [setup\nthe google Oauth integration](https://github.com/insanum/gcalcli?tab=readme-ov-file#initial-setup) with google calendar.\n\nBy default you can start `nextmeeting` and it will show the list of meetings you\nhave with \"human date\".\n\nThere is a few options to customize things, see `nextmeeting --help` for more options.\n\n### Waybar\n\nA more interesting use of `nextmeeting` is the integration with waybar, to output nicely on your desktop,\nfor example my configuration look like this:\n\n```json\n    \"custom/agenda\": {\n        \"format\": \"{}\",\n        \"exec\": \"nextmeeting --max-title-length 30 --waybar\",\n        \"on-click\": \"nextmeeting --open-meet-url\",\n        \"on-click-right\": \"kitty -- /bin/bash -c \\\"batz;echo;cal -3;echo;nextmeeting;read;\\\";\",\n        \"interval\": 59,\n        \"return-type\": \"json\",\n        \"tooltip\": \"true\"\n    },\n```\n\nThis will show how long i have until the next meeting. If I click on the item\nit will open the meet URL attached to the event. If I hit via a right click it will launch a\n`kitty` terminal to show the time zones with\n[batz](https://github.com/chmouel/batzconverter) and my next meeting. I can\nclick on the title in the terminal and it will open the meet URL.\n\n#### Styling\n\nYou can style some of the waybar item with the following CSS:\n\n```css\n#custom-agenda {\n  color: #696969;\n}\n```\n\nIf you enable the option \"--notify-min-before-events it will output a class\n`soon` if the events is coming soon, you can style it with:\n\n```css\n#custom-agenda.soon {\n  color: #eb4d4b;\n}\n```\n\n### Related\n\n- For Gnome: [gnome-next-meeting-applet](https://github.com/chmouel/gnome-next-meeting-applet)\n\n## Copyright\n\n[Apache-2.0](./LICENSE)\n\n## Authors\n\n- Chmouel Boudjnah \u003chttps://github.com/chmouel\u003e\n  - Fediverse - \u003c[@chmouel@fosstodon.org](https://fosstodon.org/@chmouel)\u003e\n  - Twitter - \u003c[@chmouel](https://twitter.com/chmouel)\u003e\n  - Blog - \u003c[https://blog.chmouel.com](https://blog.chmouel.com)\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchmouel%2Fnextmeeting","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchmouel%2Fnextmeeting","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchmouel%2Fnextmeeting/lists"}