README
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.
Requirements
- Cinnamon 3.4, 3.6, 3.8, 4.0, 4.2, 4.4, or 4.6
gcalendar
Installation
-
Install
gcalendar
:gcalendar is a Free and Open Source Software developed by the same developer to read Google Calendar events from the terminal.
Linux Mint:
sudo add-apt-repository ppa:slgobinath/gcalendar sudo apt update sudo apt install gcalendar
Arch:
yay -S gcalendar
OR
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
gcalendar
from 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
gcalendar
GitHub Repository. -
Authorize
gcalendar
to read your calendar.Just run
gcalendar
from the terminal. It will open Google Calendar OAuth page in your default browser.gcalendar
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
gcalendar
.
Features
- 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
gcalendar --account
)
FAQ
-
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
7
days. 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
gcalendar
command at gcalendar issues. -
How to report bugs?
Please open a GitHub issue at linuxmint/cinnamon-spices-desklets if the desklet doesn't work as expected. Any gcalendar specific bugs must be reported at gcalendar issues.
-
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 yyy
to 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!
Privacy Policy
None of your data is collected, stored, processed or shared with the developer or any third-parties. For more information, please check the detailed privacy policy.
Log In To Comment!
201 Comments