-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
96 lines (68 loc) · 3.54 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
x-session-selector
==================
The goal is to provide a simple and lightweight mechanic to start a X session.
x-session-selector can be used as a "better" `startx` replacement, but its main
usage case is to provide a X session selection after a user has logged in on
a TTY.
License
-------
x-session-selector is licensed under GNU GPLv3.
Features
--------
* Allows to select a session/WM on the command line.
* Starts X with the selected session/WM.
Usage
-----
Start it after login on a tty.
The parameters it supports:
USAGE: xsessionselector [OPTION]
--automatic[=TIMEOUT] Activates the automatic selection system, if no
timeout is provided it defaults to 2 seconds.
--display=DISPAY The display number to assign. If not provided will
default to the next free X display number.
--help Prints this help.
--no-newline When --print-only is provided, does not print
a new line after the selection.
--print-only Only print the selection to stdout (if any).
--select=SELECTION Select this item, the provided argument is
the executable, f.e. /usr/bin/openbox.
--shell=SHELL The executable to start when dropping to shell,
defaults to nothing. If this is not provided,
the program will simply exit, if a value is
provided, it will be executed.
--timeout=TIMEOUT When --automatic is provided, sets the timeout,
defaults to 2 seconds.
--tty-only Only present the prompt when being on a TTY.
When not on a TTY the program will exit, except
if --shell has been provided, then the shell will
be executed.
--vt=VT The number of the virtual terminal to use,
defaults to the current VT. Provided number must
be positive, but can be prefixed with + or - to
to change relative from the current VT.
--wsessions-dir=DIR The directory from which to read the available
Wayland sessions, defaults to
/usr/share/wayland-sessions/.
--xlauncher=XLAUNCHER The executable to use as launcher for X, defaults
to xinit. The selected session together with
the display number will be given as arguments to
the provided executable.
--xsessions-dir=DIR The directory from which to read the available
X sessions, defaults to /usr/share/xsessions/.
Examples
--------
The most simple example is to use it as a `startx` replacement:
$ xsessionselector
However, after a login it might be wanted to automatically select one entry
and automatically starting this entry after a certain amount of time:
$ xsessionselector --automatic=5 --select=/usr/bin/openbox
For testing purposes, or if you just want to use it as fancy selector,
x-session-selector can also only print the selected entry:
$ xsessionselector --print-only
In a similar manner if you have trouble with it, you can set the X launcher to
`echo` to see what exactly is being started:
$ xsessionselector --xlauncher=echo
Dependencies
------------
Dependencies are minimal:
* ncurses