This app is focused on giving versatility and simplicity, and present a very lightweight command-line application that reminds you of your events in Google Calendar.
The project was inspired by gcalcli, and looking for more bare-bones features and that could handle multiple Google accounts and calendars.
For now, this package is only available through PyPi
pip install gcal_notifier
- Fetch Google events from all accounts
- Notify events
- Uses Cron jobs to keep everything as minimal as possible
gcal_notifier --help
usage: gcal_notifier [-h] {get,notify,print} ...
A simple and lightweight GoogleCalendar notifier for Linux.
positional arguments:
{get,notify,print} Invoking a subcommand with --help prints subcommand usage.
get fetch events from Google Calendar and save them in cache.
notify run reminders with cached events.
print print events to the console.
options:
-h, --help show this help message and exit
For all of this to work, you have to create your credentials for each account you want to use. Note: this section was copied and pasted from the gcsa README.
-
Create a new Google Cloud Platform (GCP) project
-
Configure the OAuth consent screen
-
Create a OAuth client ID credential and download the
credentials.json
file -
Put downloaded
credentials.json
file into~/.config/gcal_notifier/default
See more options in Authentication.
Note:
On the first run, your application will prompt you to the default browser to get permissions from you to use your calendar. This will create token.pickle file in the same folder.
After having your credentials.json
file(s), you can run gcal_notifier get
to see if everything works properly.
If it does, it's time to set up your cron jobs.
-
Run
crontab -e
to edit your cron jobs. -
Choose the intervals that you want to run
get
andremind
. This means that you can fetch events in a different interval that you check for reminders. My personal preference, for example, is:
*/10 * * * * gcal_notifier get
* * * * * gcal_notifier remind
So it runs every 10 minutes to fetch events, but looks for reminders every minute.
That's it! You're all set up!
You can configure some things for now (and hopefully more later), and all the
configurations are done in a file that sits in ~/.config/gcal_notifier/config.ini
A sample of every configuration supported is:
[GENERAL]
# Returns only one event for recurrent events. Default is true
single_events = true
# How to order the events. Default (and recommended) is startTime
order_by = startTime
# Custom notification sound, if you would like to choose (it has to be a wav file).
notification_sound = ~/Music/my_notification.wav
[CALENDAR1]
# Name given to the calendar. Default is 'Calendar'
name = NAME1
# Name or ID of the calendar. Required.
calendar = example@gmail.com
# Reminders to your events, up to 5 integers separated by commas. Default is None
default_reminders = 10,0
# Path to the credentials file. Default is ~/.config/gcal_notifier/credentials.json
# credentials = ~/.config/gcal_notifier/credentials_file.json
[CALENDAR2]
name = NAME2
calendar = xxxxxxxxxxxxxxxxxxxxxxxx@group.calendar.google.com
default_reminders = 10,0
credentials = ~/.config/gcal_notifier/credentials_other_account.json
[CALENDAR3]
name = NAME3
calendar = other@gmail.com
.
.
.
If you find this project useful, please feel free to contribute or report an issue. You can always email me as thalesaknunes22@gmail.com