Development

Developing kano-desktop

This repository contains mainly configuration files and scripts. For config files, documentation for the packages they configure is linked to in README. For other kano packages, documentation starts in the README files in their respective github repos.

Although the files here are platform-neutral, the desktop system as a whole is intended to run on an ARM architecture, therefore you need a RaspberryPI or equivalent and a Debian based Linux system.

The repository contains the following folders:

• debian - This folder contains instructions to the debian packaging tools on how to install the package
• bin - This contains scrips installed in /usr/bin, including the main kano-uixinit script which starts the desktop (see README ) and kano-screenshot-hotkey which supports taking screenshots. open-me.sh is a small easter-egg for our young users :-)
• config
  • autostart - The LXDE autostart config, which basically starts kano-uixinit when the graphical desktop is loaded
  • chromium - defaults and bookmarks for the chromium web browser
  • pcmanfm - Preferences for the 'file manager' tool
  • lxpanel - This configures the layout of the panel bar at the bottom of the screen.
  • openbox - Preferences for the window manager; these affect all windows. See comments in the file.
  • dconf - (edit using gconftool-2) load dialog layout settings
  • gtk-2.0 - Also dialog box layout settings for any app based on gtk
  • keyboard - configuration files for xbindkeys (see README )
  • libfm - file manager settings, used by the pcmanfm file manager
  • LXDE - Style and keyboard/mouse preferences
  • lxterminal - Style preferences for the terminal app, which widgets are present, and scrollback amount
  • profile - This contains scripts which are run whenever an interactive shell starts, either in a terminal or virtual console.
  • rxvt - Preferences for an alternative terminal app
• kdesk -
  • kdeskrc - This file contains the configuration of kdesk, which manages the 'desktop' (the area of the screen behind any windows where icons are shown). It contains Style preferences and configuration of the screensaver, plus the location of the icon_hook script.
    • kdesktop - This contains one file configuring each of the default icons on the desktop.
    • icon_hooks.sh - This is a script which is run when any app sends an event causing kdesk to redraw the icons. This allows the icons to by dynamically updated to show login status etc. It is also overloaded to perform certain actions when the screensaver goes off (eg, running the updater)
• gtk-2.0 - Style preferences for GTK-based apps.
• kano-mount-trigger - A small program in C which is called when a USB stick is inserted. It is configured to run the file manager by 95-kano-mount-trigger.rules
• pam-configs - A small modification to the 'pluggable authentication' system to modify whether users can see each others files
• scripts - a pair of scripts called by lightdm when a user session starts or ends.
• Legal - Legal documents for Kano OS and Kano World