Complete Guide to the IceWM 4.1 Update: New Features and Fixes

IceWM is a lightweight and fast window manager, designed to offer a streamlined and customizable user experience. Version 4.1 introduces several new features useful for those who need more granular control over window behavior and for those involved in desktop automation.

This guide is aimed at technical users, system administrators, and developers who use IceWM and want to make the most of the new features introduced in version 4.1.

• Window focus control: The new option ignoreUserTime allows configuring IceWM to ignore the user interaction timestamp reported by some applications, solving unexpected focus issues.
• Desktop automation: The mousemove command added to icesh enables moving the mouse pointer via scripts or terminal commands, useful for automating desktop tasks.
• Performance improvements: The default disabling of Alpha compositing improves stability and video performance on systems affected by transparency-related issues.
• Configuration fixes: IceWM now correctly handles unterminated strings in configuration files and resolves parsing errors related to the NETSTARTUP_ID property.
• Translation updates: Translations have been updated for several languages, improving software accessibility.

Prerequisites

• Operating system: Linux
• Desktop environment: IceWM version 4.0 or earlier
• Compiler: GCC or another compatible C++ compiler
• Development libraries: X11, libpng, libjpeg, libxpm
• Build tools: make, autoconf, automake, libtool
• Root access: Administrator privileges for installation

PROCEDURE: Upgrade and Configure IceWM 4.1

By the end of this guide, you will have upgraded IceWM to version 4.1 and configured the new window focus management options.

• Download the IceWM 4.1 source archive from the project's GitHub repository.
• Extract the archive contents to a directory of your choice.
• Open a terminal and navigate to the directory containing the extracted files.
• Compile and install IceWM 4.1 by following the instructions provided in the README file or by running the following commands:
  • ./configure
  • make
  • sudo make install
• If you use a Linux distribution that supports package-based updates, wait for your system's maintainers to make IceWM 4.1 available and install the update via your distribution's package manager.
• Modify the IceWM configuration file to enable the ignoreUserTime option for applications causing unwanted focus behaviors. Add the following line to the window configuration file (typically ~/.icewm/windowlist or ~/.icewm/winoptions):
  • ignoreUserTime=1
• If you want to use the new icesh mousemove option to automate mouse pointer positioning, create a script or run the command icesh mousemove x y, where x and y represent the desired coordinates.
• If you need window transparency and do not experience performance issues, manually enable the Alpha option in the IceWM configuration file by setting it to true.

Verification and Troubleshooting

After upgrading IceWM to version 4.1, it is important to verify that the new features work correctly and resolve any issues.

How to Test if It Works

• Test the ignoreUserTime option:
  • Open the IceWM configuration file, usually ~/.icewm/winoptions.
  • Add the line ignoreUserTime=1 for the windows you want to test.
  • Restart IceWM and verify that the focus behavior is correct.
• Test the mousemove command in icesh:
  • Verify that the mouse cursor moves to the specified position.
• Check the handling of malformed strings:
  • Modify the IceWM configuration file to include unterminated strings.

What to Do if It Fails

• Problems with the ignoreUserTime option:
  • Verify that the configuration file has been saved correctly.
  • Ensure that IceWM has been restarted after the changes.
  • Check the IceWM log for any errors.
• Problems with the mousemove command:
  • Ensure you have the necessary permissions to run the command.
  • Check the command syntax and the specified coordinates.
• Problems with the handling of malformed strings:

For more details, refer to the official changelog.

By the end of this guide, you will have understood the main new features introduced by IceWM version 4.1 and how to leverage them to enhance your experience with this window manager.

Educational Summary

• Application focus control: Use the ignoreUserTime option to manage window focus based on user interactions.
• Desktop automation: Take advantage of the new mousemove command in icesh to reposition the mouse via scripts.
• Performance improvements: Disable Alpha compositing to avoid performance issues, if necessary.
• Configuration data management: Benefit from the correction in handling malformed strings and X11 properties.

Call to Action

To explore all the new features of IceWM 4.1, download the latest version from the GitHub repository or update via your Linux distribution's package manager. Try the new features and customize your configuration to optimize the use of the window manager.