| Name | nextmeeting JSON |
| Version |
1.5.5
JSON |
| download |
| home_page | None |
| Summary | Show your nextmeeting in your poly/waybar with gcalcli |
| upload_time | 2025-01-02 13:29:17 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | None |
| keywords |
calendar
cli
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 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:
- <https://pypi.org/project/python-dateutil/>
- <https://pypi.org/project/gcalcli/>
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 <https://github.com/chmouel>
- Fediverse - <[@chmouel@fosstodon.org](https://fosstodon.org/@chmouel)>
- Twitter - <[@chmouel](https://twitter.com/chmouel)>
- Blog - <[https://blog.chmouel.com](https://blog.chmouel.com)>
Raw data
{
"_id": null,
"home_page": null,
"name": "nextmeeting",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "calendar, cli",
"author": null,
"author_email": "Chmouel Boudjnah <chmouel@chmouel.com>",
"download_url": "https://files.pythonhosted.org/packages/94/5f/53439f84645da4b3d7e3370c8cf1cfbfae933daf69e503473dda08a0cf7c/nextmeeting-1.5.5.tar.gz",
"platform": null,
"description": "# 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\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- <https://pypi.org/project/python-dateutil/>\n- <https://pypi.org/project/gcalcli/>\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 <https://github.com/chmouel>\n - Fediverse - <[@chmouel@fosstodon.org](https://fosstodon.org/@chmouel)>\n - Twitter - <[@chmouel](https://twitter.com/chmouel)>\n - Blog - <[https://blog.chmouel.com](https://blog.chmouel.com)>\n",
"bugtrack_url": null,
"license": null,
"summary": "Show your nextmeeting in your poly/waybar with gcalcli",
"version": "1.5.5",
"project_urls": null,
"split_keywords": [
"calendar",
" cli"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6d57b0d38b712227f263cf5dadb1a0c5934745538bed07cdff2e26807bb3d34a",
"md5": "9e890cabc7583793d189fc6192fb3050",
"sha256": "46ab240cb053f2e0f00616ff985cf2edd2bbd412e5c326b4b8789672cfee9d48"
},
"downloads": -1,
"filename": "nextmeeting-1.5.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9e890cabc7583793d189fc6192fb3050",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 12760,
"upload_time": "2025-01-02T13:29:16",
"upload_time_iso_8601": "2025-01-02T13:29:16.427904Z",
"url": "https://files.pythonhosted.org/packages/6d/57/b0d38b712227f263cf5dadb1a0c5934745538bed07cdff2e26807bb3d34a/nextmeeting-1.5.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "945f53439f84645da4b3d7e3370c8cf1cfbfae933daf69e503473dda08a0cf7c",
"md5": "e6be0bcd3479dd25a1b0f87b43ff6f3e",
"sha256": "35c49c8ab5887d622691facef43e5ec791cb7ac3e576ad83a6d4f2c7b97e8c81"
},
"downloads": -1,
"filename": "nextmeeting-1.5.5.tar.gz",
"has_sig": false,
"md5_digest": "e6be0bcd3479dd25a1b0f87b43ff6f3e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 15100,
"upload_time": "2025-01-02T13:29:17",
"upload_time_iso_8601": "2025-01-02T13:29:17.677648Z",
"url": "https://files.pythonhosted.org/packages/94/5f/53439f84645da4b3d7e3370c8cf1cfbfae933daf69e503473dda08a0cf7c/nextmeeting-1.5.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-02 13:29:17",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "nextmeeting"
}
