1ICEWM-PROGRAMS(5) Standards, Environments and Macros ICEWM-PROGRAMS(5)
2 NAME
6 icewm-programs - icewm programs configuration file
7 SYNOPSIS
9 $ICEWM_PRIVCFG/programs
10 $XDG_CONFIG_HOME/icewm/programs
11 $HOME/.icewm/programs
12 /etc/icewm/programs
13 /usr/share/icewm/programs
14 DESCRIPTION
16 The programs file is an automatically generated menu configuration file
17 of installed programs. This file should be automatically generated by
18 xdg_menu, wmconfig (Redhat), menu (Debian), or icewm-menu-fdo, perhaps
19 as part of the login or X startup sequence.
20 FORMAT
22 The format of the file contains one of the following line syntax:
23 prog ["]title["] icon program options
25 Specifies a program to execute when the menu item is selected.
26 restart ["]title["] icon program options
28 Specifies a program to replace the window manager when the menu
29 item is selected. This is for launching other window managers from
30 within icewm(1).
31 runonce ["]title["] icon "[res_name][.res_class]" program options
33 Specifies a program to execute when the menu item is selected;
34 however, if a window of the specified res_name and res_class is
35 present, the program will not be run again.
36 menu ["]title["] icon { # contained items }
38 Specifies a sub-menu. The lines that appear between the braces can
39 be any menu item described here.
40 menufile ["]title["] icon ["]filename["]
42 Specifies a file from which to collect sub-menu items (lines) and
43 place them at this point in the menu.
44 menuprog ["]title["] icon program options
46 Specifies a program that will print sub-menu items on standard
47 output and will be collected and placed in the sub-menu at this
48 point.
49 menuprogreload ["]title["] icon timeout program options
51 Similar to menuprog, but after at least timeout seconds the menu is
52 regenerated.
53 include ["]filename["]
55 Read additional entries from the file filename
56 includeprog program options
58 Read additional entries from the output of program options.
59 separator
61 A separator for menu items.
62 Where
64 prog, restart, runonce, menu, menufile, menuprog, menuprogreload,
66 include, includeprog, separator
67 These are literal string keywords.
68 ["]title["]
70 This is the title string associated with the menu item which is
71 displayed in the menu. When the title contains spaces, the title
72 must be surrounded by double quotes ("""), although the title may
73 always be surrounded by double quotes if preferred.
74 icon
76 Is the name of the icon file (with or without extension) or the
77 full path to an icon file.
78 "[res_name][.res_class]"
80 res_name is the resource name of a window launched by program and
81 res_class is the resource class of the window. Only one of
82 res_name or res_class need be specified. This is used to identify
83 whether the program is already running and is for use with the
84 runonce keyword.
85 program options
87 program is the name of the executable or full path to the
88 executable file that will be run in response to selecting the menu
89 item. When used with the menuprog keyword, the program must print
90 on standard output the contents of the menu and is used for dynamic
91 menus.
92 options is the options and arguments passed to the program
94 verbatim.
95 filename
97 filename is the name of the file relative to one of the icewm(1)
98 configuration directories, or the full path to a file. The file is
99 used with the menufile keyword and specifies the file from which to
100 read further menu items.
101 EXAMPLES
103 Following is the example programs file that ships with icewm(1):
104 # This file is intended to be customized by the distributions.
106 # (they should place it in /etc/X11/icewm)
107 #
108 # mostly obsolete, fixme
109 menu Editors folder {
110 prog fte fte fte
111 prog vim vim gvim
112 prog xemacs xemacs xemacs
113 prog emacs emacs emacs
114 prog NEdit nedit nedit
115 prog xedit xedit xedit
116 prog Lyx emacs lyx
117 }
118 menu "WWW" folder {
119 prog Netscape netscape netscape
120 prog Mozilla mozilla mozilla
121 prog Galeon galeon galeon
122 prog Arena arena arena
123 prog Lynx lynx xterm -e lynx
124 prog Links lynx xterm -e links
125 }
126 menu "Document Viewers" folder {
127 prog "Acrobat Reader" pdf acroread
128 prog "DVI Previewer" xdvi xdvi
129 prog "Ghostview" ghostview gv
130 }
131 menu Graphics folder {
132 prog Gimp gimp gimp
133 prog XV xv xv
134 prog XPaint xpaint xpaint
135 prog XFig xfig xfig
136 }
137 menu Games folder {
138 prog "Koules for X" koules xkoules -f
139 prog Xboing xboing xboing
140 prog Xboard xboard xboard
141 prog XGalaga xgalaga xgal
142 prog XDemineur xdemineur xdemineur
143 prog "Tux Racer" tuxracer tuxracer
144 }
145 menu System folder {
146 prog "Control Panel" redhat control-panel
147 }
148 menu Utilities folder {
149 prog XPlayCD xplaycd xplaycd
150 prog XMixer xmixer xmixer
151 prog Clock xclock xclock
152 prog Magnify xmag xmag
153 prog Calculator xcalc xcalc
154 prog Colormap xcolormap xcmap
155 prog Clipboard xclipboard xclipboard
156 prog xkill bomb xkill
157 prog xload xload xload
158 prog xosview xosview xosview
159 separator
160 prog "Screen Saver" xlock xlock -nolock
161 prog "Screen Lock" xlock xlock
162 }
163 menu "Window Managers" folder {
164 restart icewm - icewm
165 restart metacity - metacity
166 restart wmaker - wmaker
167 restart fluxbox - fluxbox
168 restart blackbox - blackbox
169 restart enlightenment - enlightenment
170 restart fvwm2 - fvwm2
171 restart fvwm - fvwm
172 restart sawfish - sawfish
173 restart sawfish2 - sawfish2
174 }
175 FILES
177 Locations for the programs file are as follows:
178 $ICEWM_PRIVCFG/programs
180 $XDG_CONFIG_HOME/icewm/programs
181 $HOME/.icewm/programs
182 /etc/icewm/programs
183 /usr/share/icewm/programs
184 The locations are searched in the order listed; the first file found is
186 read and the remainder ignored.
187 SEE ALSO
189 icewm(1), icewm-menu(5), icewm-menu-fdo(1).
190 AUTHOR
192 Brian Bidulock <mailto:bidulock@openss7.org>.
193 LICENSE
195 IceWM is licensed under the GNU Library General Public License. See
196 the COPYING file in the distribution.
197icewm 3.3.1 2023-01-24 ICEWM-PROGRAMS(5)