====== Window Managers ======

For every user, the default window manager can be defined by assigning an appropriate value to the ''WINDOW_MANAGER'' variable in
<code>$HOME/.config/slitaz/applications.conf</code>
Default in SliTaz 5.0 is
<file>WINDOW_MANAGER=lxde-session</file>
On how to configure ''slim'' for choosing between installed window managers, see [[en:handbook:xwindow#slim-simple-login-manager|xwindow#slim]].


===== Awesome =====

Awesome is a highly configurable, next generation framework window manager for X.
It is very fast, extensible and licensed under the GNU GPLv2 license.

It is primarily targeted at power users, developers and any people dealing with 
everyday computing tasks and who want to have fine-grained control of their 
graphical environment.

To install awesome:

<code># tazpkg get-install awesome</code>

===== Dwm =====

Dwm is a minimalist dynamic window manager for the X Window System developed by Suckless
that has influenced the development of several other X window managers, including xmonad and awesome.
It is externally similar to wmii, but internally much simpler.
Dwm is written purely in C for performance and security in addition to simplicity and lacks any
configuration interface besides editing the source code.
One of the project's guidelines is that the source code is intended to never exceed 2000 SLOC
and options meant to be user-configurable are all contained in a single header file.

To install dwm:

<code># tazpkg get-install dwm</code>

===== Enlightenment (e17) =====
Enlightenment is a complete desktop environment, fully configurable with the mouse and offering many themes.
The version supplied by the SliTaz project is known as e17 and is still in development,
this version is considered stable enough to be incorporated into the distribution.
Enlightenment was designed to be deployed on systems with limited resources, as well as more powerful systems.
It allows for wallpapers, menus, animated and interactive gadgets and knows how to manage virtual desktops.

To install e17:

<code> # tazpkg get-install enlightenment </code>

Logout your current X session, type ''F1'' at Slim login and choose ''e17'' to start Enlightenment.

=== Menu and desktop icons ===

Enlightenment is compliant to the Freedesktop standards.
Applications are sorted by category and icons automatically appear if a desktop file is supplied.
The (.desktop) system files are contained in the ''/usr/share/applications'' directory or hidden home
''~/.local/share/applications'' directory.
These files have a simple syntax and are editable from the panel or with a simple text editor.
The file menus displaying categories in the Enlightenment menu are found in the ''slitaz-menus'' package:

<code># tazpkg get-install slitaz-menus</code>

=== An icon on the desktop ===

To have an icon on the desktop launching applications, you can create by hand a .desktop file
(([[http://standards.freedesktop.org/desktop-entry-spec/latest/ar01s05.html|Recognized desktop entry keys]]))
in your local directory ~/Desktop.
Desktop files placed in this directory are automatically recognized by Enlightenment.
A single .desktop file can contain eight different types of lines with respectively:
the name (Name), generic name, comment, the command to execute (Exec), icon, type and Freedesktop categories.
Example of a .desktop file for Xterm icon:

<file>
[Desktop Entry]
Name=XTerm
GenericName=Terminal
Comment=Run commands in a shell
Exec=xterm -bg black -fg white -cr orange -sb -bd violet -rightbar
Icon=/usr/share/icons/Tango/jwm/utilities-terminal.png
Type=Application
Categories=Utility;Terminal;
</file>
Additional themes can be found on: http://exchange.enlightenment.org/

===== Fluxbox =====
Fluxbox is a windowmanager for X that was based on the Blackbox 0.61.1 code.
It is very light on resources and easy to handle but yet full of features to make an easy,
and extremely fast desktop experience.
It is built using C++ and licensed under the MIT-License.

To install fluxbox:

<code># tazpkg get-install fluxbox</code>

===== JWM - Joe's Window Manager =====

Joe's window manager, written in C is quick, simple, clean, stable and efficient.
JWM proposes a taskbar, a menu of icons and a pager for the management of virtual desktops.
The taskbar can also act as a dock.
In addition it is easily configurable with a single text file that can change the menu,
fonts and their sizes, and different colors.

To install jwm on SliTaz:

<code># tazpkg get-install jwm</code>

Logout your current X session, push ''F1'' key and at Slim login and choose ''jwm'' to start JWM.
To make JWM your default Window Manager:
<code>$ tazx jwm</code>

=== Use and configure JWM ===

The application of Joe's Window Manager is very fast.
To view the menu just click somewhere on the desktop.
You can resize a window through the edges or corners, minimize or pass a virtual desktop to another via a pager.
You also have configurable keyboard shortcuts for faster access to the applications that you often use.
On SliTaz the system configuration file is ''/etc/jwm/system.jwmrc''.
Apart from this file, each user can use its own configuration file hidden in ''~/.jwmrc''.
This is a text file using XML syntax, it can be edited with a simple text editor;
lines beginning with: <nowiki> <!-- are comments that let you understand what each tag does</nowiki>.

To facilitate the customization of the desktop, SliTaz automatically copies at the launch of the first (graphical) session,
a system configuration file to the root directory of the user. You can directly modify this file and test without risk.
To edit with your favorite text editor:

 <code>$ geany $HOME/.jwmrc & </code>

To retrieve an original configuration file, you can copy the system configuration file to ''.jwmrc'' in your home directory:

<code> $ cp /etc/jwm/system.jwmrc $HOME/.jwmrc </code>

The tag RootMenu corresponds to the menu displayed by clicking on one of the (three) buttons on the mouse.
To add a category, you must use the tag: Menu - this contains entries for various programs.
Any entry in the JWM menu can fit on one line. Example using the GQview image management application:

<file> <Program icon="gqview.png" label="GQview">gqview</Program> </file>

There are still many opportunities to configure RootMenu according to the mouse buttons;
the choice of method to move windows, create groups, etc.
The Manual is available online at the official website of the project.
To view a list of command-line options:
<code>$ jwm -h</code>

=== Create your own JWM style ===

Creating your own graphical style with JWM is relatively quick and easy,
the tags are clear and the attributes possible are given in the comments.
When preparing your work, you can see your amendments by restarting the window manager
from the menu or via the ''jwm -restart'' command.
In the configuration file, style tags start after the <!-- Visual Styles --> comment.
To begin, here is a short list of the main style tags with a short description:

    * Background manages the wallpaper. This tag supports the solid, gradient, image or tile attributes, to respectively: use a solid color, create a gradient, display a resized image or tile an image.
    * BorderStyle controls the windows border.
    * TrayStyle controls a taskbar. The taskbar may, among other things, be automatically hidden or only fill a part of the screen with the width attribute.
    * TrayListStyle controls the style of the list of open windows on the current desktop.
    * PagerStyle controls the pager displaying different virtual desktops (4 by default).
    * MenuStyle defines the menu style.
    * The icons are defined by the IconPath tag, you can use your own personal icons by specifing the full path to the directory that contains them. Note that you can specify more than one path, if you want, you can use your own icons and those contained in the ''/usr/share/pixmaps'' and ''/usr/share/icons'' system directories. SliTaz uses the Tango theme icons: ''tango.freedesktop.org'' for the menu, these are 16x16 and are stored in ''/usr/share/icons/Tango''. You can  add, edit, delete these... If you want to install new icons in your user space, we advise you to use ''~/Picture/Icons'' (set as default) or a hidden directory ''~/.Icons''.

The colors can be defined by their name or RGB number such as ''#3A4956''.
To use colors in their gradient mode, you must specify the two colors separated by a colon, example ''#6C0023:#3E1220''.
You can change fonts and their sizes by using the Font tag.
There are still some other small things that you can change to customize your desktop: such as the name of a menu item and its icon.
Before restarting JWM with your new configuration file, you can check its syntax:
<code>$ jwm -p</code>
To explore further, the official handbook describes all the tags, options and valid attributes.
You can view it at https://joewing.net/projects/jwm/config.html

=== JWM website ===

    * https://joewing.net/projects/jwm/ - The official website of Joe's Window Manager, providing news and a comprehensive manual.
    * #jwm on irc.freenode.net - The JWM IRC discussion channel on Freenode server.

===== Lxde =====

Lxde is the default desktop environment in SliTaz 5.0.

===== Openbox =====

More details in [[en:handbook:desktop|Desktop]]

===== Pekwm =====
Pekwm is a window manager written by Claes Nästén that was once based on the aewm++ window manager,
but has since evolved enough that it no longer resembles aewm++ at all.
It also has an expanded feature-set, including window grouping (similar to ion, pwm, or fluxbox),
auto properties, Xinerama support and keygrabber that supports keychains and much more.

See also [[https://github.com/pekwm/pekwm/blob/master/doc/README.md|Documentation]]

===== Spectrwm =====
Spectrwm is a small dynamic tiling window manager for X11.
It tries to stay out of the way so that valuable screen real estate can be used for much more important stuff.
It has sane defaults and does not require one to learn a language to do any configuration.
It was written by hackers for hackers and it strives to be small, compact and fast.

To install spectrwm:

<code># tazpkg get-install spectrwm</code>


===== Xfce =====

[[http://www.xfce.org/|Xfce]] is a lightweight desktop environment.
It replaces the default OpenBox and PCManFM, and is also based on GTK+.

To install Xfce, select the ''xfce4'' meta-package from the Package Manager. This will install all the related packages.

To use Xfce, ensure you have the correct command for Xfce in the Slim (log-in manager) configuration.
Do this (up to slim-1.3.5) by appending ''xfce4'' to the ''sessions'' line of the
''/etc/slim.conf'' file - note that you will need root permissions to modify the file:
<file>sessions            openbox,e17,jwm,xfce4</file>

You can then select Xfce by pressing ''F1'' at the log-in screen, as you enter your user-name and password.

Extras are available at [[http://goodies.xfce.org/|Xfce Goodies]], including plug-ins, artwork and bindings.

To remove Xfce, use the following command as ''root'' user:
<code>
# for PKG in xfce4 xfce4-session xfce4-panel xfwm4 libxfcegui4 xfce-utils libxfce4util thunar thunar-volman xfconf ; \ 
do yes y | tazpkg remove $PKG ; done
</code>


---- 
\\
^  Page Review Section  ^^ 
|Quality| Medium  |
|Review| Minor/Major Updates  |
|Priority| Medium |
|Problems| stale link http://exchange.enlightenment.org/ |
|::: | tazx jwm does not work in SliTaz 5|
|How to Improve| Fill Pekwm, Dwm, Spectrwm and Fluxbox sections|
|::: |  |

\\
----