https://github.com/nikitabobko/gcal-notifier-kotlin-gtk

Simple Google Calendar notifier for Linux written in Kotlin using GTK lib
https://github.com/nikitabobko/gcal-notifier-kotlin-gtk

calendar google-calendar gtk java-gnome java-gnome-lib kotlin linux linux-app

Last synced: 3 months ago
JSON representation

Simple Google Calendar notifier for Linux written in Kotlin using GTK lib

• Host: GitHub
• URL: https://github.com/nikitabobko/gcal-notifier-kotlin-gtk
• Owner: nikitabobko
• License: gpl-3.0
• Created: 2018-06-27T23:47:19.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2022-06-21T22:34:00.000Z (over 2 years ago)
• Last Synced: 2024-10-04T13:30:26.843Z (4 months ago)
• Topics: calendar, google-calendar, gtk, java-gnome, java-gnome-lib, kotlin, linux, linux-app
• Language: Kotlin
• Homepage:
• Size: 1.18 MB
• Stars: 19
• Watchers: 4
• Forks: 0
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# gcal-notifier-kotlin-gtk [![Build Status](https://github.com/nikitabobko/gcal-notifier-kotlin-gtk/actions/workflows/main.yaml/badge.svg?branch=master)](https://github.com/nikitabobko/gcal-notifier-kotlin-gtk/actions?query=branch%3Amaster)

![icon](src/view/gtk/res/gcal-icon.png)

Simple Google Calendar notifier for Linux written in Kotlin using GTK lib  

# Installation

#### Debian/Ubuntu

* Download *.deb file from [latest release page](https://github.com/nikitabobko/gcal-notifier-kotlin-gtk/releases/latest)

* Double click on downloaded file and press `Install` button **or** via Terminal:  

`sudo apt install ./gcal-notifier-kotlin-gtk-VERSION.deb`

#### Arch Linux

For Arch Linux users [AUR package](https://aur.archlinux.org/packages/gcal-notifier-kotlin-gtk/) is available

#### Other Linux distributions

* Install [all dependencies](#dependencies)

* Download *.tar file from [latest release page](https://github.com/nikitabobko/gcal-notifier-kotlin-gtk/releases/latest)

* Extract tar archive by executing:  

`tar -xvf gcal-notifier-kotlin-gtk-VERSION.tar`

* Install program by executing `install.sh` script in extracted folder:  

`sudo ./install.sh`

# Usage

While app is running it shows small icon in your system tray and popups notifications for events which are set to be reminded in Google Calendar:  

![popup.png](.screenshots/popup.png)

![notif.png](.screenshots/notif.png)

`Hint:` Gnome users may not see that system tray icon as system tray feature was removed in Gnome 3.26. You may want to install

[TopIcons](https://extensions.gnome.org/extension/495/topicons/) or [TopIcons Plus](https://extensions.gnome.org/extension/1031/topicons/)

to return back system tray.

# Dependencies

* JRE 8

* [java-gnome lib](http://java-gnome.sourceforge.net/)

# Uninstallation

For all uninstallation methods it's recommended to log out from gcal-notifier firstly. You can do this by:  

 `Click gcal-notifier icon in system tray` -> `Log out`

#### Debian/Ubuntu

Execute in terminal:  

`sudo apt autoremove gcal-notifier-kotlin-gtk`

#### Arch Linux

Execute in terminal:  

`sudo pacman -Rsn gcal-notifier-kotlin-gtk`

#### Other Linux distributions

* Execute in terminal:  

  `sudo /opt/gcal-notifier-kotlin-gtk/uninstall.sh`

* Don't forget to uninstall [dependencies](#dependencies) if you don't need them anymore

# Building project from sources

[Bazel](https://bazel.build/) is used for building the project.

Before building project ensure that you have [dependencies](#dependencies) installed.

#### Building jar file

Execute `bazel build gcal-jar` to generate jar file in `bazel-bin` directory.

#### Run debug gcal-notifier version from sources

`bazel run gcal-app`

#### Build tar archive only

`bazel build gcal-tar`

#### Build deb archive only

`bazel build gcal-deb`

#### Running tests

`bazel test //...`