Difference between revisions of "IceWM"

From ArchWiki
Jump to navigation Jump to search
(Menu: menumaker doesn't need root, removed duplicate content by link to xdg-menu article)
(Themes: removed subjective statements)
Line 73: Line 73:
=== Themes ===
=== Themes ===
Some themes are included by default, much larger selection is available in the {{Pkg|icewm-themes}} package in the repository, but even the best of them have a spartan, 'old Windows' feel. Much better examples (like [http://box-look.org/content/show.php/Carbonit+Ice?content=146421|this], [http://box-look.org/content/show.php/IceBuntu?content=62935|this] or [http://box-look.org/content/show.php/IceClearlooks?content=96346|this]) can be found at [http://www.box-look.org/index.php?xcontentmode=7311 box-look.org].
A small number of themes are included in the {{Pkg|icewm}} package. These can supplemented by the themes available from the {{Pkg|icewm-themes}}. Many more themes can be downloaded from [http://www.box-look.org/index.php?xcontentmode=7311 box-look.org].
== File managers ==
== File managers ==

Revision as of 08:13, 1 May 2014

According to Wikipedia:

IceWM is a window manager for the X Window System graphical infrastructure, written by Marko Maček. It was coded from scratch in C++ and is released under the terms of the GNU Lesser General Public License. It is relatively lightweight in terms of memory and CPU usage, and comes with themes that allow it to imitate the UI of Windows 95, OS/2, Motif, and other graphical user interfaces.

Configurability and presence of simple session management places IceWM between simplest DEs and feature-rich WMs.


IceWM can be installed from the official repositories with the icewm package.

Alternatively, you can install the latest development version from the testing branch: icewm-testingAUR. A CVS version is also available: icewm-cvsAUR. Both of these packages are available in the AUR. Due to a slow pace of development, the testing versions are often no different from the stable release.

Starting IceWM

Graphical login

Just select IceWM from the session menu of your favourite display manager.

Starting IceWM Manually

For a basic session, append the following to ~/.xinitrc

exec icewm

To run icewm, icewmbg and icewmtray with your IceWM session, append the following to ~/.xinitrc

exec icewm-session

See xinitrc for details, such as preserving the logind session.

Using IceWM in a desktop environment

IceWM can replace the native window manager in most desktop environment's. Check you desktop environment's article for details on how to replace the native window manager.


Although IceWM configuration is originally text-based, there are GUI-based tools available, notably icewm-utilsAUR in the AUR. However these tools are relatively old and most users prefer to simply edit the text configuration files. Configuration changes from defaults can be made either system wide (in /etc/icewm/) or on a user-specific basis (in ~/.icewm/).

To change your icewm configuration from the default, simply copy the default configuration files from /usr/share/icewm/ to ~/.icewm/, for example:

Note: Do this as a regular user, not as root.
$ mkdir ~/.icewm/
$ cp -R /usr/share/icewm/* ~/.icewm/
  • preferences is the core configuration file for IceWM.
  • menu controls the contents of the IceWM application menu.
  • keys allows the user to customize keyboard shortcuts
  • toolbar row of launcher icons on the taskbar
  • winoptions behavior of individual applications
  • theme theme path/name
  • startup script or command (must be executable) executed on startup
  • shutdown the same for shutdown
  • Startup commands that install system tray applets must be preceded by sleep 1 &&, otherwise IceWM will create an ugly black window that will prevent it from quitting; in that case, use xkill on the task bar.
  • You will have to create the startup script yourself as it is not included in the package. Don't forget to make it executable.

Generating menu entries

  • menumaker from the official repositories is a Python script that automatically populates your applications menu based on what is installed in your system. Although this may result in a menu filled with many unwanted applications, it may still be preferable to manually editing the menu configuration file. When running MenuMaker, use the -f flag to overwrite an existing menu file:
$ mmaker -f icewm

You can avoid populating your menu with terminal based applications such as alsamixer by running the following switches with the menumaker command: --no-legacy and --no-debian. For example:

$ mmaker -f --no-legacy --no-debian icewm
  • Alternatively, you can generate a menu using Xdg-menu.


A small number of themes are included in the icewm package. These can supplemented by the themes available from the icewm-themes. Many more themes can be downloaded from box-look.org.

File managers

It should be noted that IceWM is a window manager only and therefore does not include a file manager. PCManFM and Rox Filer enable desktop icons, but Idesk can also be used to achieve this functionality.

Note: For a greater listing of file managers, examine the File managers category listing.


No start menu icon (Intel graphics)

If you have Intel Graphics you may find that the start menu in your taskbar has no icon. This is due to a recent change in the xf86-video-intel driver which means that the newer, but more unstable, SNA acceleration backend is used by default instead of the older stable UXA acceleration backend. Instructions for changing the acceleration backend can be found here.

Unable to logout when PCManFM is managing the desktop

If you use PCManFM to manage the desktop you may find that the IceWM logout button no longer works. The workaround is to define a logout command. To do this, open ~/.icewm/preferences, uncomment the following line: # LogoutCommand="" and enter a command which can be used to logout. For example: LogoutCommand="pkill -u username" where username is your username.

No shutdown or reboot options in logout menu (logout command has been defined)

Shutdown and reboot commands will be ignored if a logout command has been defined. If you want shutdown and reboot options in the logout menu then you must not define a logout command.

No shutdown or reboot options in logout menu (logout command has not been defined)

If you have defined shutdown and reboot commands (such as systemctl poweroff and systemctl reboot) and you have not defined a logout command but you still find that there are no shutdown or reboot options in the logout menu then it is likely that you are using IceWM 1.3.8. An upstream bug, introduced into IceWM 1.3.8, renders many menu dialogs inert. See here and here The only known workaround is to downgrade to IceWM 1.3.7. You can find the IceWM 1.3.7 package in the Arch Rollback Machine.

See also