Skip to content
This repository has been archived by the owner on Mar 21, 2024. It is now read-only.

hannesrauhe/lunchinator

Repository files navigation

INSTALL DEPENDENCIES
=======

Lunchinator works on Mac, Linux and Windows. 

- Windows
Download setup.exe from http://update.lunchinator.de/win/

- Mac
Download package from http://update.lunchinator.de/mac/

- Ubuntu >= 12.04:
sudo apt-add-repository ppa:lunch-team/lunchinator
sudo apt-get update
sudo apt-get lunchinator

- SLES 11 SP2: 
Add the following repositories:

http://download.opensuse.org/repositories/home:/Cornelius_Ratsch/SLE_11_SP2/
http://download.opensuse.org/repositories/devel:/languages:/python/SLE_11_SP2/
sudo zypper in lunchinator

- manually on every system
Install Python, pyqt4 and pip
python -m pip -r requirements.txt

If you have git, you can just clone https://github.com/hannesrauhe/lunchinator.git, otherwise download the zip from https://github.com/hannesrauhe/lunchinator/archive/master.zip and extract it.


-additionally:
Open Up port 50000/UDP and 50001/TCP on your machine


USAGE
=============

execute (Alt-F2 recommended) start_lunchinator.py

first time usage:
*write a hostname/IP of one of the lunch peers (e.g. luder) to the right bottom text field, click on "add host" and wait a few seconds
OR
*another peer/colleague can add your hostname/IP to its list the same way

PLUGINS
=======

Most of the functionality you can see is implemented in Plugins. The core program does just relay/store messages and finds peers.

for example:
-General Settings (to be able to change settings via GUI)
-Notify (to open/close optical drive, show a notification (depends on libnotify) and play a sound on linux (depends on sox)
-Avatar (to set a picture as your avatar - you can see other pictures in the norification without this plugin)

Details
======

Use ./start_lunchinator.py --help to see additional options, e.g., a pure command line version and a server version.

Updates are handled via Git. You can use the auto update instead plugin if you do not have git.

lunch_server listens on incoming UDP connections on Port 50000
ATM it will not parse incoming messages - it will simply show a notice (and open/close your DVD and play a sound at lunch time)
(Exception: Messages starting with HELO are there to communicate user names etc.)