Blog Forum Wiki Links Contact Us NetbookUser
 
Translations of this page:

Working with the IceWM Windows Manager

The Asus Eee comes with a dormant window manager called IceWM. (A window manager is a graphical user interface that controls placement and appearance of windows within an operating system). By simply editing a text file, one can gain access to a world of window and taskbar settings, and can also enable a Start Menu. This document will focus primarily on activating the Start Menu, but later on we will add how-to's for other settings.

Enabling the IceWM Start Menu in Easy Mode

The IceWM Start Menu can be enabled in Easy Mode

It would be great if someone could assist me with a redirect from the old version of this page to this version. I believe this site has a necessary plugin and further details.

Copying and editing preferences file in Terminal

This will involve creating a folder in your /home/user directory and copying an existing preferences text file over to that new directory. This preferences file contains many, many interesting settings but for now we will simply focus on enabling the Start Menu.

1. Open your Terminal using the keyboard combination Ctrl-Alt-T.

2.1) Type the following commands, as shown in the screenshot below.

/home/user> mkdir ~/.icewm
/home/user> cp /etc/X11/icewm/preferences /home/user/.icewm

3. Now, from here you can simply edit the file and be done with it if you happen to know how, but if you are new to using the command line you might wish to verify that the file was actually copied. Then, assuming you navigate to the new directory first as shown below, you would enter the command nano preferences.

/home/user> cd .icewm
/home/user> ls
/home/user> nano preferences

4. Now you should be looking at your newly copied IceWM preferences file in Nano.

5. Using the cursor key, navigate to the line containing “TaskBarShowStartMenu” and change the zero to a 1 as shown below.

6. Now you can hit the Ctrl-X key combination, press “Y” to save, then press <enter> to save the name as 'preferences'.

7. That's it! Now you can press the key combination Ctrl-Alt-Backspace to restart X (restarting your Eee is unnecessary) and you will see a Start Menu.

ADDITIONAL:

If you are happy with your icewm start menu and is using it very often, you can also add a hot keystroke to bring it up. Just edit this line in the same preferences file.

# KeySysMenu="Ctrl+Esc"
KeySysMenu="Ctrl+Super_L"

Now you will be able to bring up the start menu by pressing [Ctrl] and [Home].

Copying and editing preferences file in File Manager

1. Open the Work Tab

2. Open File Manager

3. Click “View”, “Show Hidden Files”

4. Click “View, “Show All File Systems”

5. In the left-hand pane, click “My Home” and create a hidden folder entitled .icewm

6. In the left-hand pane, navigate from “All File Systems” to /etc/X11/icewm

7. In the right-hand pane, click Ctrl-A to select all files

8. Click Ctrl-C to copy to the clipboard

9. In the left-hand pane, select My Home, .icewm and click Ctrl-V to paste from the clipboard

10. Right click on the file named “preferences” and choose “Open With…” → Text Editor.

11. Find the line “TaskBarShowStartMenu”, change the value from 0 to 1.

12. Save the file and press the key-combination Ctrl-Alt-Backspace to restart X (restarting your Eee is unnecessary).

Changing the time format to AM/PM

1. In the same preferences file discussed above, scroll down to the section titled “Clock Time Format” and look at the TimeFormat value as shown below.

2. Change the TimeFormat to read as follows

TimeFormat="%I:%M %p"

3. Now save your changes and restart X (or restart your Eee if you wish).

This article is under development.

Config the "logout" command

Edit the same preferences file, search for the following sections and changed them as below to bring up the Instant Shutdown dialog box (same as when you push the power button):

#  Confirm logout
# ConfirmLogout=1 # 0/1
ConfirmLogout=0
...

#  Command to start logout
LogoutCommand="/opt/xandros/bin/shutdown_dialog"

#  Command to cancel logout
LogoutCancelCommand="/opt/xandros/bin/shutdown_dialog"

#  Command to shutdown the system
ShutdownCommand="/opt/xandros/bin/shutdown_dialog"

#  Command to reboot the system
RebootCommand="/opt/xandros/bin/shutdown_dialog"

Set up the Run command option

To get a run command dialogue box from the icewm start menu, you will need to install a helper program. There are a few choices for this: SublimePorte's launcher tools(altools), Mercury, kysrun or xexec.

If you are already using altools, then it may be a good choice for you. The other two: Mercury and kysrun both offers a database so that you don't need to remember the commands for each program. However, all of them do not support filenames, especially hidden folder and filenames. Therefore, xexec is my preferred choice.

For installation of the first three programs, please refer to instructions on their website. For xexec, installation is very simple being available from the Debian repositories. Just enter the following command in a console:

sudo apt-get install xexec

To config the Run command in icewm start menu, edit the same preferences file, look for this section and change as per your choice:

#  Command to select and run a program
# RunCommand=""
#RunCommand="grun"
RunCommand="/usr/bin/rundlg"     # for running Launcher Tools
RunCommand="/home/user/bin/mercury"   # for running Mercury in /home/user/bin (change the path if you have installed it elsewhere)
RunCommand="/usr/bin/xexec"      # for running xexec

You can also add a hot key to call up this run command dialog. See this wiki for detailed steps.

Setting Up a More Useful Start Menu

File to edit is menu in /home/user/.icewm

# - anything after # in the line is comment

Each entry in the menu is declared on one line, except for the “menu” special case. Each ordinary line is made up of four items separated by spaces; an object type, the displayed name, the icon name, and the action. The action can include arguments, as it is everything up to end of line. If the displayed name contains spaces then it must be surrounded in quotes. The objects are :

prog - is a program you can run from your menu

separator - is line between groups

restart - Restarting another window manager

menu - defines a sub-menu group folder inline

menufile - defines a sub-menu from another file, e.g. the shortcut names you placed in the toolbar

menuprog - defines a sub-menu built by running a program

Some sample program entries :

format : prog “title” icon_name program_executable options

Games

prog "Potato Guy" ktuberling ktuberling -caption "Potato Guy"

Utility

prog "Control Panel" konqueror konqueror
prog "File Manager" Icon XandrosFileManager
prog "File Manager (Root)" Icon kdesu "XandrosFileManager --caption 'File Manager (ROOT)' --icon xfm_root"
prog "Text Editor" kwrite kwrite
prog "Screen Shot" ksnapshot ksnapshot
prog "Remote Desktop" krdc krdc
prog "Synaptic Package" synaptic kdesu synaptic 

These could be grouped into sub-menus :

menu Games folder {
prog "Potato Guy" ktuberling ktuberling -caption "Potato Guy"
}
menu Editors folder {
prog "KDE Text Editor" kwrite kwrite
prog NEdit nedit nedit
}


IceWM Menu Templates

Here are some sample templates to consider adopting. Simply copy and paste as needed. (Thank you, alanking!)

Xandros/KDE Applications shortcuts

If you found it too much trouble to add the menu items one by one, there is an easy way in adding one menu item to call up the Xandros/KDE application shortcuts in the KDE file manager.

prog "apps:/Xandros" crystalsvg/16x16/actions/about_kde.png konqueror 'applications:/Xandros'

This will include all the applications known to the system just like the KDE Start Menu when you have activated the Advanced desktop.

Install Debian Programs Menu

There is a program called Debian Menu System (or in short menu as known by dpkg) that can automatically generate program menu shortcut entries for Debian Menu aware programs in a Debian system such as the EeePC.

After installing menu, you will have a start menu similiar to that in Advanced Desktop. And then you won't need to manually add programs to the icewm start menu for most programs (but there are always exceptions).

To install menu, you will need to edit your /etc/apt/sources.list file (as root) to add this line for adding Debian repositories,

deb ftp://ftp.debian.org/debian/ etch main

then update cache with this command:

sudo apt-get update

Finally, install menu,

sudo apt-get install menu

Please note that if you install this for the first time, after your restart your EeePC, it will take a long time for the system to generate the new Program menu in the icewm start menu. So just be patient.

Quick buttons In The Toolbar

This article is under development.


Kudos to o2smartphone who published his findings in this discussion thread on the forum, as well as other contributors in that thread.

If you have some time, please contribute to this article by adding screenshots.

1) there are together 6 files inside the folder, you are advised to copy them all for more enhancement to the menu, cp /etc/X11/icewm/*.* /home/user/.icewm
 
howto/icewmstartmenu.txt · Last modified: 2009/01/20 09:55 by eeeric
 
Recent changes RSS feed Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki