aboutsummaryrefslogtreecommitdiff
path: root/doc/asciidoc/startfluxbox.txt
blob: 4ab681541024742fb29664d932d390d68928d71b (plain)
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
startfluxbox(1)
===============
Jim Ramsay <i.am@jimramsay.com>
v1.3.7, 22 January 2015
:man source:   startfluxbox.txt
:man version:  {revision}
:man manual:   Fluxbox Manual

NAME
----
startfluxbox - start a fluxbox session

SYNOPSIS
--------
*startfluxbox*

DESCRIPTION
-----------
*startfluxbox* is a script which runs the file *~/.fluxbox/startup* If it
doesn't exist it will be generated.

*startfluxbox* should be started from your *\~/.xinitrc* if you use startx, or
 *~/.xsession* if you run a display manager, like xdm.

FILES
-----
*~/.fluxbox/startup*::
    This file contains all commands that should be executed before fluxbox is
    started. The initial file contains helpful comments for beginners. It also
    starts fluxbox.

EXAMPLES
--------
The default *~/.fluxbox/startup* is as follows:
....
#!/bin/sh
#
# fluxbox startup-script:
#
# Lines starting with a '#' are ignored.

# Change your keymap:
xmodmap "$HOME/.Xmodmap"

# Applications you want to run with fluxbox.
# MAKE SURE THAT APPS THAT KEEP RUNNING HAVE AN ''&'' AT THE END.
#
# unclutter -idle 2 &
# wmnd &
# wmsmixer -w &
# idesk &

# And last but not least we start fluxbox.
# Because it is the last app you have to run it with ''exec'' before it.

exec fluxbox
# or if you want to keep a log:
# exec fluxbox -log "$fluxdir/log"
....

If you need to start applications after fluxbox, you can change the *exec
fluxbox* line above to something like this:
....
exec fluxbox &
fbpid=$!

sleep 1
{
    xsetroot -cursor_name left_ptr -fg white -bg black &
    ipager &
    gkrellm2 &
} &

wait $fbpid
....
So xsetroot, ipager, and gkrellm2 will all be started after fluxbox, after
giving fluxbox 1 second to startup.

For more details on what else you can do in this script, see *sh(1)*, or the
documentation for your shell.

AUTHORS
-------
The author of *startfluxbox(1)* is Han Boetes <han at fluxbox.org>

This manpage was converted to asciidoc format by Jim Ramsay <i.am at
jimramsay.com> for fluxbox-1.1.2

SEE ALSO
--------
fluxbox(1)