LinuxReviws.org --get your your Linux knowledge
> Linux Reviews > Manual Pages (man) >

idesk


  1. idesk.1.man


1. idesk.1.man

Manpage of idesk

idesk

Section: (1)
Updated:
Index Return to Main Contents
 

NAME

Idesk -- program that draws desktop icons.  

SYNOPSIS

Idesk is program that draws desktop icons. Each icon will execute a shell command when double-clicked (set to single-click by an option). The icons can be moved on the desktop by dragging them, and the icons will remember their positions on start-up. Oh yea, forgot there is cool eye-candy.
                                                                                                                The icons can either be PNG (.png) or SVG (.svg) files. There are some problems with librsvg's usage of some svg files it seems. Most simple SVG files _cannot_ be loaded by librsvg. More investigation is needed to see what kind of SVG's work. See note in section 6.  

DEPENDENCIES

gdk-pixbuf-2
pkg-config - GNU autoconf and automake already have it I believe
librsvg-2.0.1 - nautilus has this already I believe
other gnome stuff - if you have everything for librsvg then you should be good.

                                                                                                           
 

INSTALLING

Decompress and untar the tar.gz file into a directory. In that directory:
$> make
$> su
$> make install

Make install will copy the executable-binary file to /usr/local/bin/idesk.  

CONFIGURING

STEPS

1. Following the syntax described in ideskrc(5), create a file in your home directory named .ideskrc.

2. Create a directory called .idesktop/ in your home directory.

3. Inside the new directory, create an icon file with the extension 'lnk'(e.g., home.lnk) as deescribed in LINKS FILES section belw.

4. Start idesk as described in RUNNING below, or kill and restart idesk if it's already running.

5. Move your new icon to where you would like it to be, and verify it works correctly.

6. Repeat steps 3-5 for any additional icons you would like to have.

7. After you have your icons finished and where you want them, change Locked from 'false' to 'true' in .ideskrc.

8. (optional) Add 'idesk' to your .xinitrc or other startup scripts to run it automatically.

 

LINK FILES

In general link file will look like this:
table Icon
  Caption: Home
  Command: nautilus /home/you
  Icon: /home/you/.idesktop/home.png
end

These are the options for icon file, they should mostly be self-explantory. The Icon option is the graphic file for the icon image (either a png file or a svg file). The Execute[i] action (in .ideskrc) runs the Command[i]. If the Caption field is blank or just one space, then no caption will be created for the icon.

table Icon
  Caption: Tux
  Icon: /home/you/icons/tux2.svg
  Width: 600
  Height: 700
  X: 680
  Y: 174
  Command[0]: echo 'Linux rocks!'
end

Important for SVG
If you use a svg icon need to set Width and Height to your desired pixel size. Just make sure that the X value plus the width doesn't exceed your window diemensions, you get a segfault (same for Y value and height). It is best to set X and Y to zero to prevent this.  

DEFAULT USAGE

Double click with the first mouse button will run the command.
Click and drag with the first mouse button moves the icon (if not locked).
Double-click with the middle mouse button reloads the icons and regenerates background. Useful after changing wallpapers to clear graphical artifacts.
Double-click with the right mouse button to toggle the lock state. The state will be saved in the config file, so it will be remembered next startup.
 

RUNNING

Idesk runs as a background process. One suggested way to start idesk is:
nohup idesk > /dev/null &

After Idesk is running, click on an icon to start whatever command you assigned it. Currently 'kill -HUP' will terminate the program. It is required to restart idesk when you add new icons (.lnk files), unless you are running some other utility that runs on top of idesk, such as Fluxspace.

You can reload existing .lnk files in ~/.idesktop/ by double middle-clicking on any icon.

 

SEE ALSO

ideskrc(5)

 

BUGS

High-Contrast currently not implemented.
segfault if SVG image extends beyond window in config file  

PROGRAM AUTHORS

Chris Roberts (nikon) <nikon@sc.rr.com>
Bryn (curious) <curious@ihug.com.au>
Christopher Morris <cmorri9@lsu.edu>
Tim Finley <timmfin@timmfin.net>
 

MANPAGE AUTHOR

Dylan Carlson <absinthe@gentoo.org>
Sergey Kuleshov <svyatogor@gentoo.org>


 

Index

NAME
SYNOPSIS
DEPENDENCIES
INSTALLING
CONFIGURING
LINK FILES
DEFAULT USAGE
RUNNING
SEE ALSO
BUGS
PROGRAM AUTHORS
MANPAGE AUTHOR

This document was created by man2html using the manual pages.
Time: 17:31:12 GMT, October 23, 2013

Meet new people