https://github.com/chmouel/nextmeeting
nextmeeting - Show your google calendar next meeting in your waybar or polybar
https://github.com/chmouel/nextmeeting
polybar-scripts swaywm waybar-scripts
Last synced: 11 months ago
JSON representation
nextmeeting - Show your google calendar next meeting in your waybar or polybar
- Host: GitHub
- URL: https://github.com/chmouel/nextmeeting
- Owner: chmouel
- License: apache-2.0
- Created: 2023-01-17T09:56:56.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-18T16:37:38.000Z (about 1 year ago)
- Last Synced: 2025-06-21T09:05:54.846Z (11 months ago)
- Topics: polybar-scripts, swaywm, waybar-scripts
- Language: Python
- Homepage:
- Size: 97.7 KB
- Stars: 37
- Watchers: 3
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# nextmeeting - Show your calendar next meeting in your waybar or polybar
## What is it?
nextmeeting is a simple CLI leveraging gcalcli to show the next meetings.
It has a few features compared to just gcalcli :
- bar integration (i.e: [waybar](https://github.com/Alexays/Waybar)/[polybar](https://github.com/polybar/polybar) and probably others)
- smart date in English (not just the date, tomorrow or others)
- show the time to go for current meeting
- change colors if there is 5 minutes to go to the meeting
- hyperlink in default view to click on terminal
- notification via notify-send 5 minutes before meeting
- title ellipsis
- Exclude next day meetings.
## Screenshot
## Installation
Use `pip` with:
`pip install -U nextmeeting`
or Checkout the source of this repo by [using uv](https://docs.astral.sh/uv/getting-started/installation/):
`uv run nextmeeting`
If you don't want to use `uv` you can install the dependences packages from PyPi
or from your operating system package manager if available:
-
-
And the you can run the nextmeeting script:
`python3 ./nextmeeting/cli.py`
alternatively you can even just copy the `./nextmeeting/cli.py` script to your path and run
it to make it more convenient.
### [AUR](https://aur.archlinux.org/packages/nextmeeting)
```shell
yay -S nextmeeting
```
## How to use it?
You need to install [gcalcli](https://github.com/insanum/gcalcli) and [setup
the google Oauth integration](https://github.com/insanum/gcalcli?tab=readme-ov-file#initial-setup) with google calendar.
By default you can start `nextmeeting` and it will show the list of meetings you
have with "human date".
There is a few options to customize things, see `nextmeeting --help` for more options.
### Waybar
A more interesting use of `nextmeeting` is the integration with waybar, to output nicely on your desktop,
for example my configuration look like this:
```json
"custom/agenda": {
"format": "{}",
"exec": "nextmeeting --max-title-length 30 --waybar",
"on-click": "nextmeeting --open-meet-url",
"on-click-right": "kitty -- /bin/bash -c \"batz;echo;cal -3;echo;nextmeeting;read;\";",
"interval": 59,
"return-type": "json",
"tooltip": "true"
},
```
This will show how long i have until the next meeting. If I click on the item
it will open the meet URL attached to the event. If I hit via a right click it will launch a
`kitty` terminal to show the time zones with
[batz](https://github.com/chmouel/batzconverter) and my next meeting. I can
click on the title in the terminal and it will open the meet URL.
#### Styling
You can style some of the waybar item with the following CSS:
```css
#custom-agenda {
color: #696969;
}
```
If you enable the option "--notify-min-before-events it will output a class
`soon` if the events is coming soon, you can style it with:
```css
#custom-agenda.soon {
color: #eb4d4b;
}
```
### Related
- For Gnome: [gnome-next-meeting-applet](https://github.com/chmouel/gnome-next-meeting-applet)
## Copyright
[Apache-2.0](./LICENSE)
## Authors
- Chmouel Boudjnah
- Fediverse - <[@chmouel@fosstodon.org](https://fosstodon.org/@chmouel)>
- Twitter - <[@chmouel](https://twitter.com/chmouel)>
- Blog - <[https://blog.chmouel.com](https://blog.chmouel.com)>