1ICEWM-SESSION(1)                 User Commands                ICEWM-SESSION(1)
2
3
4

NAME

6        icewm-session - X.Org session manager provider with IceWM
7

SYNOPSIS

9       icewm-session [OPTIONS]
10

DESCRIPTION

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

OPTIONS

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

USAGE

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

SEE ALSO

82       icewm(1), icewm-env(5), icewm-shutdown(5), icewm-startup(5),
83       icewmbg(1).
84

BUGS

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

AUTHOR

91       Brian Bidulock <mailto:bidulock@openss7.org>.
92
93       See --copying for full copyright notice and copying permissions.
94

LICENSE

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.1                       2019-11-25                  ICEWM-SESSION(1)
Impressum