# ncid-applet INSTALL # Last modified Fri Nov 11, 2011 Requirements: The NCID applet requires NCID, tcl, gnome, and gnocl. NCID Project: http://ncid.sourceforge.net NCID: http://ncid.sourceforge.net/ncid/ncid.html ncid-applet: http://ncid.sourceforge.net/ncid-applet/ncid-applet.html Gnocl distributions: http://sourceforge.net/projects/gnocl/ Gnocl documentation: http://gnocl.org/ Gnocl blog: http://gnocl.blogspot.com/ Install gnocl: - Obtain version 0.9.95 or later of gnocl, gnoclGnome, and gnoclGconf Note: gnocl, gnoclGnome, and gnoclGconf must be obtained from the nightly build section if using version 0.9.95. Binary packages may be provided. - obtain current source if needed, for example: wget http://downloads.sourceforge.net/gnocl/Gnocl-Nightly-Build/gnocl-0.9.95-22-05-11.tar.bz2 wget http://downloads.sourceforge.net/gnocl/Gnocl-Nightly-Build/gnoclGnome-0.9.95-26-05-11.tar.bz2 wget http://downloads.sourceforge.net/gnocl/Gnocl-Nightly-Build/gnoclGconf-0.9.95-05-06-11.tar.bz2 - Untar all 3 files: tar -xjvf gnocl-0.9.95-22-05-11.tar.bz2 tar -xjvf gnoclGnome-0.9.95-26-05-11.tar.bz2 tar -xjvf gnoclGconf-0.9.95-05-06-11.tar.bz2 - If using Fedora, make sure dependent packages are installed: (separate yum installs are shown, but best to do as one yum install) yum install tcl-devel yum install gtk2-devel yum install libglade2-devel yum install libgnomeui-devel yum install libpanelappletmm-devel yum install libnotify-devel yum install libcanberra-devel yum install gnome-desktop-devel - If using Ubuntu, make sure dependent packages are installed: apt-get tcl8.4-dev (or whatever version you are using) apt-get libgnomeui-dev apt-get libpanelappletmm-dev apt-get libnotify-dev apt-get libglade2-dev apt-get libgnome-desktop-dev apt-get libcanberra-dev apt-get libcanberra-gtk-dev - cd to each of the gnocl package top level directories: * review the README file and install any software packages required to compile the gnocl package * cd src; make; make install * for package gnocl you also need to do: make devinstall - you can also remove a package library from /src: for example: make uninstall First time applet install: ./applet-install Upgrade applet: ./applet-remove ./ncid-pref remove ./applet-install Remove applet: ./applet-remove Remove applet preferences: ./ncid-pref remove View applet preferences: ./ncid-pref read Adding the applet to the panel: Install the applet. If "NCID Applet" is not listed in "Add to Panel...", logout and then login again. This should cause "NCID Applet" to appear in "Add to Panel..." the next time you open it. Removing the applet from the panel: Remove applet and remove applet preferences. if "NCID Applet" is still listed in "Add to Panel...", logout and login again. This should cause "NCID Applet" to to disappear from "Add to Panel..." the next time you open it. Configuring applet: When "ncid-applet" is added to the panel for the first time or if the saved preferences were deleted, "ncid-applet" will bring up the Preferences window so it can be configured. If the applet is on the same computer as the server, the defaults should be OK and can be accepted as-is. If the applet and server are on different computers, the IP address needs to be changed to the IP address or the DNS name of the server. Click the "Connect" button to try to connect to the server. Review all preferences and then click on "Close" to save and exit. The saved preferences can be viewed: gconftool-2 --recursive-unset /apps/panel/applets/ncid If the preferences were not saved, nothing is listed. Usage: Use the built-in help.