summaryrefslogtreecommitdiff
path: root/doc/asciidoc/startfluxbox.txt
blob: 0042ed3978d3c7a07104e4114f889fce08557421 (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
92
93
94
95
96
startfluxbox(1)
===============
Jim Ramsay <i.am@jimramsay.com>
v1.1.2, 18 February 2009
: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(1p)*, or the
documentation for your shell.

ONLINE DOCUMENTATION
--------------------
More extensive documentation for *startfluxbox(1)* can be found at:::
http://www.xs4all.nl/~hanb/software/fluxbox/startfluxbox.html

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)