Skip to content

akerge/itc-kit

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

itc-kit

This application is a collection of some tools suitable for a student in the Estonian information technology college.

The application was developed for the Ubuntu linux distribution and can probably run on any linux distibution that runs a desktop environment that uses GTK (Notable exception KDE). Though it has yet to be properly tested.

The application comes with four main functionalities:

  • Your IT college ÕIS user timetable display on desktop (via Conky)
  • Email notification for Estonian IT College Webmail
  • Reminder system
  • Productivity tracker

Installation

Just install the .zip of this repo, extract anywhere and run the install.sh script inside with root privleges.

Note: Please make sure universe repos are enabled: System Settings -> Software & Updates.

In Ubuntu terminal:

cd path/to/install.sh
sudo sh install.sh

This will perform an update for the latest packages, install the necessary dependencies and create a file structure in your home directory (hidden directory .itc-kit).

An application launcher named "itc-kit" is created. The application can also be run from the terminal with the command "itc-kit.py" or the alias "itc".

Running the program creates a toolbar indicator with the IT college icon where you can access all functionality.

Note: Running an untrusted shell script with root privleges can be dangerous, you should check the content of the script first.

Don't worry it's simple. :)

Timetable

After activating it from the plugins menu you should see a transparent empty timetable on your desktop. To get your timetable:

  • Go to itcollege.ois.ee and log in
  • Go to timetable and select Ical
  • Copy the URL
  • Select the applications timetable submenu
  • Set ical URL

The color and number of days displayed can be changed in the Timetable submenu.

Note: Currently the application only supports the english version of the timetable. ÕIS Language can be changed in the upper left corner.

Email

Activating the plugin should prompt you for an email and password. Here use your IT college email username and password.

You should now hear a sound and see a notification icon in the application indicator when you recieve an email. After opening the main menu you will see the the sender.

Note: If you name is for example Mikk Pulk then although your username is mpulk your email is still mikk.pulk@itcollege.ee

Reminders

This plugin allows you to create reminders that will trigger at the specified time in the application indicator.

Productivity tracker

Activating this plugin will allow the tracking of three types of activities. Those that are productive, neutral or counterproductive.

Three rings displaying the percentages of each activity are displayed in the lower right corner of the screen.

Development Team

Itc-kit was created by:

Kristo Koert (Software architecture, all python code, installation script)

Johannes Vatsfeldt (Design choices, all lua code, conky configuration files)

Sten Luhtoja (Contributed to designing/testing ical parsing system)

Contact

Kristo Koert email: kristo.koert@itcollege.ee

Note: Olen tavaline tudeng, võtke julgelt ühendust kui probleeme, soovitusi või tahate panustada. :)

Contributing

All pull request are welcome!

Licence

Itc-kit is open-sourced software licensed under the MIT license.

itc-kit

itc-kit

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 79.6%
  • Lua 18.4%
  • Shell 2.0%