1ICEWM-SESSION(1) User Commands ICEWM-SESSION(1)
2
3
4
6 icewm-session - X.Org session manager provider with IceWM
7
9 icewm-session [OPTIONS]
10
12 icewm-session is an implementation of X.Org session manager and can be
13 run from X11 session setup. It runs icewm as default window manager and
14 handles the startup and life cycle control of the WM and all related
15 support applications.
16
18 SPECIFIC OPTIONS
19 -c, --config=FILE
20 Let IceWM load preferences from FILE.
21
22 -t, --theme=FILE
23 Let IceWM load the theme FILE.
24
25 -i, --icewm=FILE
26 Use FILE as the IceWM window manager.
27
28 -a, --alpha
29 Use a 32-bit visual for translucency.
30
31 -b, --nobg
32 Do not start icewmbg.
33
34 -n, --notray
35 Do not start icewmtray. This is only applicable if IceWM was
36 explicitly configured to use an external icewmtray process.
37
38 -s, --sound
39 Also start icesound.
40
41 GENERAL OPTIONS
42 -d, --display=DISPLAY
43 Use DISPLAY to connect to the X server. If this option is missing
44 then DISPLAY is read from the environment variable "DISPLAY".
45
46 --sync
47 Use a slower synchronous mode communication with X11 server.
48
49 -h, --help
50 Print a brief usage statement to stdout and exit.
51
52 -V, --version
53 Print the program version to stdout and exit.
54
55 -C, --copying
56 Print copying permissions to stdout for the program and exit.
57
59 On startup icewm-session executes the following steps. From the file
60 env in the configuration directory it loads additional environment
61 variables, if that file exists. Then it will start icewmbg to manage
62 root background colors and images. It may also start icesound, if this
63 was enabled at configuration time. Then icewm is started.
64
65 If there exists an executable script startup in the configuration
66 directory, it will be executed. It may contain commands to initialize
67 X11 settings with xset, load keyboard configuration, start a
68 compositing manager like compton and load system tray applications.
69
70 When icewm exits or is told to exit, icewm-session will execute a
71 shutdown script, if it exists in the configuration directory. When
72 this finishes, icewm-session will terminate icewm, icewmbg and
73 icesound. Finally icewm-session will exit.
74
75 If the icewm process crashes then icewm-session will attempt to restart
76 it. If two such crashes occur in a short period, then icewm-session
77 will attempt to popup a dialog using either xmessage, kdialog or
78 zenity. This dialog asks if the user wishes to continue restarting
79 icewm or abort execution of icewm-session.
80
82 icewm(1), icewm-env(5), icewm-shutdown(5), icewm-startup(5),
83 icewmbg(1).
84
86 icewm-session had no known bugs at the time of release. Please report
87 bugs for current versions to the source code repository at
88 <https://github.com/bbidulock/icewm/issues>.
89
91 Brian Bidulock <mailto:bidulock@openss7.org>.
92
93 See --copying for full copyright notice and copying permissions.
94
96 IceWM is licensed under the GNU Library General Public License. See
97 the COPYING file in the distribution or use the --copying flag to
98 display copying permissions.
99
100
101
102icewm 1.6.5 2020-03-17 ICEWM-SESSION(1)