Google Calendar Desklet
View your upcoming calendar events on your Cinnamon Desktop. This desklet uses
gcalendar to pull events from Google Calendar. You can configure every aspect of the desklet using the configure dialog.
- Cinnamon 3.4, 3.6, 3.8, 4.0, 4.2, 4.4, or 4.6
gcalendar is a Free and Open Source Software developed by the same developer to read Google Calendar events from the terminal.
sudo add-apt-repository ppa:slgobinath/gcalendar sudo apt update sudo apt install gcalendar
yay -S gcalendar
packer -S gcalendar
Disclaimer: ppa:slgobinath/gcalendar and AUR gcalendar are my (the developer of this desklet) own repositories that are not monitored by the Linux Mint team, and user installs it at their own discretion.
I am providing the PPA and AUR to make the installation process simple. However, if you have any concerns with adding a PPA or installing from AUR, you can also install
gcalendarfrom PyPi or from the source code.
Install From PyPi:
sudo apt install python3-pip python3-setuptools python3-dateutil python3-oauth2client python3-googleapi pip3 install gcalendar
Install From Source:
sudo apt install python3-pip python3-setuptools python3-dateutil python3-oauth2client python3-googleapi git git clone https://github.com/slgobinath/gcalendar.git cd gcalendar pip3 install -e .
For more information, please visit the
gcalendarto read your calendar.
gcalendarfrom the terminal. It will open Google Calendar OAuth page in your default browser.
For more details, see this YouTube video: gcalendar Authorization. After authorizing gcalendar, you should see your calendar events printed in the terminal.
Download and add this desklet.
- If there is a warning sign in the "Desklets" dialog, try to remove and add the desklet again. If it doesn't work, a system restart may help the desklet to detect
- Select events from multiple calendars of the same Google account
- Custom date range
- Customize update frequency
- Manually update the agenda by clicking on the desklet
- Customize the look and feel
- Multiple account support (Using
How to manually refresh the desklet?
Just click on the desklet. It will retrieve fresh events from Google Calendar.
What does "No events found..." mean?
It means you do not have any events in the selected time interval. By default, the desklet retrieves events for the next
7days. You can modify it by adjusting the "Number of days to include (days)" property in the configuration dialog. If that doesn't work, please ensure that you have some events in your Google Calendar by visiting the official website.
What does "Unable to retrieve events..." mean?
It means the desklet could not retrieve any events and there is a possible error. Please report the bug with the output of
gcalendarcommand at gcalendar issues.
How to report bugs?
Can I use my own client id and client secrets?
You can use your own credentials but use them with
gcalendar --client-id xxx --client-secret yyyto authorize before using them in the desklet.
I love this desklet/gcalendar and want to appreciate it. How can I express it?
It is a great pleasure to see someone likes your work. Though I am the core developer, there are other contributors contributing to this desklet by fixing bugs and translating it into other languages. If you like the desklet, please show it to the world by login to the CINNAMON spices website and clicking the Like it button. I also appreciate it, if you can buy me a coffee!