Skip to main content

Show your next google calendar event in polybar or i3-bar

Project description

AUR version PyPI Version Badge

What is this?

It's a script that communicates with Google's calendar API, it will go through your calendars and print the next calendar event details.
You can take this output and show it on your i3-bar or polybar

example example

How does it work

It will read your next 10 events from each of your calendars, then go through them all and figure out which one is closest.
It will print the time and title of the closest event.

Setup

Google API

https://developers.google.com/calendar/quickstart/python

  1. You need to create a Google API project and download your OAuth 2.0 credentials json file.You first need to create a project here, then add Google Calendar support, then download the credentials.json file. Alternatively, you can just use this link and click "Enable the Google Calendar API". This will create a project, add Google Calendar support, and let you download the file in 1 click. If you're having trouble, you can use this tutorial for more information https://developers.google.com/calendar/auth. Another great guide can be found here if you're still having trouble: https://github.com/jay0lee/GAM/wiki/CreatingClientSecretsFile.
  2. Download the credentials file to somewhere on your computer.
  3. Proceed to installation phase.

Installation

After downloading the credentials file, install the package.

Pipx

Using pipx will save you time and it's cross-platform. It is a package manager for Python that allows you to easily install and run Python packages in isolated environments.

pipx install https://github.com/rosenpin/i3-agenda

Pip

  1. sudo pip install .
  2. Try running i3-agenda -c $CREDENTIALS_FILE_PATH with "$CREDENTIALS_FILE_PATH" replaced with the path to the credentials.json file you downloaded in the previous step.
  3. Add configuration to your bar (examples in the Examples section below).

Arch Linux (AUR)

  1. yay -S i3-agenda-git
  2. Try running i3-agenda -c $CREDENTIALS_FILE_PATH with "$CREDENTIALS_FILE_PATH" replaced with the path to the credentials.json file you downloaded in the previous step.
  3. Add configuration to your bar (examples in the Examples section below).

Manual

Dependencies

You need to install some python libraries first.
Make sure python3 is your default python.
Run sudo pip3 install python-bidi google-api-python-client google-auth-httplib2 google-auth-oauthlib

  1. Clone the repo to a local directory cd ~/ && git clone https://github.com/rosenpin/i3-agenda && cd i3-agenda
  2. Run the script python3 i3_agenda/i3_agenda.py -c $CREDENTIALS_FILE_PATH with "$CREDENTIALS_FILE_PATH" replaced with the path to the credentials.json file you downloaded in the previous step. If configured correctly, it will prompt you to log in in your browser, accept everything. It should print your next event.
  3. Optional: you can run sudo python setup.py install to add the script to your path so you can run i3-agenda anywhere.
  4. Add configuration to your bar (examples in the Examples section below).

Usage

  -h, --help            show this help message and exit
  --credentials CREDENTIALS, -c CREDENTIALS
                        path to your credentials.json file
  --conf CONF, -cd CONF
                        path to the i3agenda configuration and cache folder
  --cachettl CACHETTL, -ttl CACHETTL
                        time for cache to be kept in minutes
  --update, -u          when using this flag it will not load previous results from cache, it will however save new results to cache.
                        You can use this flag to refresh all the cache forcefully
  --ids IDS [IDS ...], -i IDS [IDS ...]
                        list of calendar ids to fetch, space separated. If  none is specified all calendars will be fetched
  --maxres MAXRES, -r MAXRES
                        max number of events to query Google's API for each of your calendars.
                        Increase this number if you have lot of events in your google calendar
  --today, -d           print only today events
  --no-event-text TEXT  text to display when there are no events
  --hide-event-after HIDE_EVENT_AFTER
                        minutes to show events after they start before showing the next event.
                        If not specified, the current event will be shown until it ends
  --show-event-before SHOW_EVENT_BEFORE
                        minutes to show events before they start. If not specified, the next event will be shown regardless of when it starts
  --date-format DATE_FORMAT
                        the date format like %d/%m/%y. Default is %d/%m
  --limchar LIMCHAR, -l LIMCHAR
                        the max characters that the displayed event can contain
  --skip SKIP, -s SKIP  the number of events to skip from the most recent

Filter displayed calendars

To display events only from certain calendars use the --ids parameter and pass a list of calendar id, space separated.
To obtain the calendar id you can check the settings page of the calendar on Google (usually is the owner email, if it's not shared).
Leaving the list empty will fetch all calendars (default behavior).

Notes

Known issues

It might not work properly if you have more than 10 all day events, this can be fixed by increasing the maxResults variable.

RTL support

If you use RTL or some of your events contain RTL languages, you will need to pipe pybidi with the script. Example: i3-agenda -c ~/.google_credentials.json -ttl 60 | pybidi

Caching

It uses a caching mechanism so you won't have to contact Google servers every minute, to set the cache TTL use the -ttl flag.
Example: i3-agenda --ttl 60 to set the TTL to 60 (meaning it will contact Google again every hour).
This means that if you create a new event, it might take an hour for the script to recognize it.

Multi account support

Multi account support is not officialy supported, but you can use the workaround from this issue: https://github.com/rosenpin/i3-agenda/issues/35#issuecomment-923976482

Examples

Example polybar configuration:

example

modules-center = agenda
....
[module/agenda]
type = custom/script
; Show the next event and forget cache automatically every 60 minutes
exec = i3-agenda -c ~/.google_credentials.json -ttl 60
; left click to launch Google Calendar
click-left = chromium https://calendar.google.com/calendar/r/day
; right click force update the cache, if for example you just added a new event
click-right = notify-send "syncing..." && i3-agenda -c ~/.google_credentials.json --update && notify-send -t 2000 "sync finished"
interval = 60

Example SwiftBar configuration

example This will show your next event as the menu bar title, when you press it you will see a dropdown with all your today events You can call the file agenda.2m.sh to make it refresh every 2 minutes

#!/bin/bash
# <swiftbar.hideAbout>true</swiftbar.hideAbout>

i3-agenda -c ~/.google_credentials.json -ttl 60 --limchar 30

echo "---"
href="href='https://calendar.google.com/calendar/u/0/r/'"

i=1
while :; do
    event=$(i3-agenda -c ~/.google_credentials.json -ttl 60 --limchar 30 --skip $i --today)
    ((i++))
    if [[ "$event" == "No events" ]];then
        exit 0
    fi
    echo "$event | $href"
done

Example i3block configuration:

[i3-agenda]
command=i3-agenda -c ~/.google_credentials.json -ttl 60
interval=60

Example output of the script:
10:55 Grocery shopping

How to use the skip flag to scroll events

Edit the polybar configuration creating two modules:

[module/agenda-ipc]
type = custom/ipc

hook-0 = i3-agenda -c ~/.google_credentials.json --skip $(cat ~/.config/i3-agenda/i3-agenda-skip.tmp || echo 0)
hook-1 = ~/.config/polybar/scripts/i3agenda-onscroll.sh down && i3-agenda -c ~/.google_credentials.json --skip $(cat ~/.config/i3-agenda/i3-agenda-skip.tmp || echo 0)
hook-2 = ~/.config/polybar/scripts/i3agenda-onscroll.sh up && i3-agenda -c ~/.google_credentials.json --skip $(cat ~/.config/i3-agenda/i3-agenda-skip.tmp || echo 0)

format = %{F#61afef}%{F-} <output>

; left click to launch Google Calendar
click-left = firefox https://calendar.google.com/calendar/u/0/r
; right click force update the cache, if for example you just added a new event
click-right = rm ~/.config/i3-agenda/i3-agenda-skip.tmp; i3-agenda -c ~/.config/i3-agenda/client_secret.json --update && notify-send "i3-agenda" "Sync completed"

; show the previous event
scroll-down = polybar-msg hook agenda-ipc 2
; show the next event
scroll-up = polybar-msg hook agenda-ipc 3

[module/agenda]
type = custom/script
interval = 900
exec = polybar-msg hook agenda-ipc 1
label =

Add both modules to the bar, for example:

modules-center = agenda agenda-ipc

In the polybar scripts folder add the file i3agenda-onscroll.sh:

#!/usr/bin/env bash
if [ -n "${1}" ]; then
  file=~/.config/i3-agenda/i3-agenda-skip.tmp
  typeset -i skip=$(cat $file || echo 0)
  if [[ "${1}" == "up" ]]; then
    skip+=1
  elif [[ "${1}" == "down" && $skip -gt 0 ]]; then
    skip=$(( skip - 1))
  fi
  echo $skip > $file
fi

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

i3-agenda-1.8.tar.gz (17.6 kB view details)

Uploaded Source

Built Distribution

i3_agenda-1.8-py3-none-any.whl (14.3 kB view details)

Uploaded Python 3

File details

Details for the file i3-agenda-1.8.tar.gz.

File metadata

  • Download URL: i3-agenda-1.8.tar.gz
  • Upload date:
  • Size: 17.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.18

File hashes

Hashes for i3-agenda-1.8.tar.gz
Algorithm Hash digest
SHA256 51a569a5fe5e57100e35f73b74e79599164c01deb379d0b3ccdda2c4029d8117
MD5 8e5385f0695565cdb32c398972492bfe
BLAKE2b-256 d859d8b0f3f3c7126562b8c649e52adf725db7202f09f6a564f676682f356c24

See more details on using hashes here.

File details

Details for the file i3_agenda-1.8-py3-none-any.whl.

File metadata

  • Download URL: i3_agenda-1.8-py3-none-any.whl
  • Upload date:
  • Size: 14.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.18

File hashes

Hashes for i3_agenda-1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 22414034dfe540fbd8d80d9455ee875a7b3a8817b55c877de27173bb66d7c421
MD5 3e226c19b6550359f29b87d9ab821b08
BLAKE2b-256 6a4dd9ab79cc527bf08cdd55690a0f1f6fe94f9b5e7fdcb1525721fb8a7b9355

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page