3 .\" Copyright (c) 2009 Marco Peereboom <marco@peereboom.us>
4 .\" Copyright (c) 2009 Darrin Chandler <dwchandler@stilyagin.com>
6 .\" Permission to use, copy, modify, and distribute this software for any
7 .\" purpose with or without fee is hereby granted, provided that the above
8 .\" copyright notice and this permission notice appear in all copies.
10 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
23 .Nd es un manejador de ventanas para X11
28 es un manejador de ventanas super minimalista para X11. Intenta no superponer
29 las ventanas para que las mismas puedan usarse de manera eficiente y para cosas mas importantes.
30 Tiene configuraciones normales y no requiere que sepas un lenguaje de
31 programacion para configurarlo. Esta escrito por hackers para hackers y apunta
32 a ser pequeño, compacto y rápido.
36 inicia, lo primero que hace es leer el archivo de configuracion,
39 .Sx ARCHIVOS DE CONFIGURACIÓN
42 La siguiente anotacion se usa a través de esta pagina:
44 .Bl -tag -width Ds -offset indent -compact
58 es muy simple de usar.
59 La mayoria de las acciones se hacen con los mapeos (bindings) de mouse
63 para las personalizaciones y configuraciones por defecto.
64 .Sh ARCHIVOS DE CONFIGURACIÓN
66 primero trata de abrir el archivo por defecto en el directorio del usuario,
68 Si ese archivo no esta disponible,
69 luego trata de abrir el archivo global de configuracion
70 .Pa /etc/scrotwm.conf .
72 El formato del archivo es \*(Lttecla\*(Gt = \*(Ltconfiguracion\*(Gt.
77 Habilitamos o deshabilitamos la opción usando 1 o 0 respectivamente.
79 El archivo soporta las siguientes palabras clave:
81 .Bl -tag -width "title_class_enabledXXX" -offset indent -compact
83 Color del borde de la ventana en foco.
85 Color del borde de la ventana fuera de foco.
87 Habilitar o deshabilitar la barra de estado.
88 .It Cm bar_border Ns Bq Ar x
89 Color del borde de la barra de estado en pantalla.
91 .It Cm bar_color Ns Bq Ar x
92 Color de la ventana de la barra de estado en pantalla.
94 .It Cm bar_font_color Ns Bq Ar x
95 Color de la fuente en la barra de estado en pantalla.
98 Fuente de la barra de estado.
100 Scripts externos con populares agregados de información para la barra
101 de estado, como la vida de la bateria.
103 Frecuencia de actualización, en segundos, de los scripts de la barra de
106 Habilitar o deshabilitar mostrar el algoritmo de apilamiento en la barra
109 Habilitar o deshabilitar el reloj en la barra de estado, deshabilitado
110 por defecto con un 0, para usar el reloj de la barra de estado
113 Algunas aplicaciones tienen ventanas de dialogo muy pequeñas como para
114 ser usables. Este relación (ratio) es el tamaño de la pantalla, por
115 ejemplo 0.6 es 60% del tamaño físico de la pantalla.
117 Acomodar una region personalizada, removiendo cualquier autodeteción de
118 regiones que ocupe el espacio en la pantalla.
119 Definiendo el formato screen[<idx>]:WIDTHxHEIGHT+X+Y,
120 e.g.\& screen[1]:800x1200+0+0.
122 Setear un ancho minimo preferido para la terminal.
123 Si el valor es mayor que 0,
125 intentará ajustar el tamaño de la fuente de la terminal para mantener
126 el ancho de la terminal por encima de este número cuando la ventana
128 Actualmente solo es soportado por
132 no debe ser un setuid o setgid, que no sea el que viene por defecto en
133 la mayoria de los sistemas.
134 Los usuarios pueden necesitar setear program[term] (ver la sección
136 ) para usar una copia alternativa del binario de
138 sin el seteo del setgid.
139 .It Cm title_class_enabled
140 Habilitar o deshabilitar la clase de ventana en la barre de estado.
141 Habilitado seteando 1
142 .It Cm title_name_enabled
143 Habilitar o deshabilita el titulo de la ventana en la barra de estado.
144 Habilitado seteando 1
147 Mod1 generalmente es la tecla ALT y Mod4 la tecla de windows en una PC.
148 .It Cm program Ns Bq Ar p
149 Definir una nueva accion para ejecutar un programa.
153 .It Cm bind Ns Bq Ar x
154 Combinación de teclas para una acción
158 .It Cm quirk Ns Bq Ar c:n
159 Agregar un "quirk" (o forzados) para ventanas con clase
167 Los colores deben ser especificados por la especificación
169 y las fuentes por la especificación
173 te permite definir acciones personales para lanzar los programas que
174 quieras y luego obligar a la misma con una función de acciones.
178 Los programas por defecto se describen acá:
180 .Bl -tag -width "screenshot_wind" -offset indent -compact
183 .It Cm screenshot_all
184 screenshot.sh completo
185 .It Cm screenshot_wind
186 screenshot.sh por ventana
192 dmenu_run -fn $bar_font -nb $bar_color -nf $bar_font_color -sb $bar_border -sf $bar_color
195 Los programas en la configuración personal, se especifican aca:
197 .Dl program[<nombre>] = <progpath> [<arg> [... <arg>]]
200 es un identificador, no genera conflictos con ninguna accion o palabra
203 es la ruta al programa, y
205 es ninguno o mas de un argumento para el programa.
207 Las siguientes variables de configuracion en
210 .Sx ARCHIVOS DE CONFIGURACIÓN
212 y pueden ser usadas en los campos de
214 como asi tambien sustituidas por valores al momento del inicio de un
217 .Bl -tag -width "$bar_font_color" -offset indent -compact
221 .It Cm $bar_font_color
223 .It Cm $color_unfocus
227 .Bd -literal -offset indent
228 program[ff] = /usr/local/bin/firefox http://scrotwm.com.ar/
229 bind[ff] = Mod+f # Ahora Mod+F inicia firefox
232 Para deshacer lo anterior:
233 .Bd -literal -offset indent
240 provee muchas funciones (o acciones) accesibles por medio de la
241 asignación (bindings) de teclas o el mouse.
243 Las corrientes asignaciones (bindings) del mouse son:
245 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
251 Redimenciono una ventana
253 Redimenciono una ventana hasta que quede centrada
256 Las corrientes asignaciones (bindings) de teclas son:
258 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
259 .It Cm M-S- Ns Aq Cm Return
268 .It Cm M- Ns Aq Cm Space
270 .It Cm M-S- Ns Aq Cm Space
284 .It Cm M- Ns Aq Cm Return
293 .Cm M-S- Ns Aq Cm TAB
310 .It Cm M-S- Ns Aq Ar n
312 .It Cm M- Ns Aq Cm Right
314 .It Cm M- Ns Aq Cm Left
316 .It Cm M-S- Ns Aq Cm Right
318 .It Cm M-S- Ns Aq Cm Left
328 .It Cm M-S Aq Cm Delete
334 El nombre de las acciónes descripta a continuación:
336 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
338 Ejecutar una terminal
354 Disposición de las ventanas
356 Reiniciar la disposición de las ventanas
358 Achicar la region principal
360 Agrandar la region principal
362 Agregar una ventana a la region principal
364 Quitar una ventana de la region principal
366 Agregar columnas/filas a las pilas
368 Quitar columnas/filas de las pilas
370 Mover la ventana corriente a la region principal
372 Enfocar la proxima ventana en la estación de trabajo
374 Enfocar la anterior ventana en la estación de trabajo
376 Enfocar en la ventana principal de la estación de trabajo
378 Ejecutar con la siguiente ventana en la estación de trabajo
380 Ejecutar con la anterior ventana en la estación de trabajo
382 Cambiar la barra de estado en todas las estaciones de trabajo
384 Borrar la ventana corriente en la estación de trabajo
386 Destruir la ventana corriente en la estación de trabajo
388 Cambiar entre estaciones de trabajo
394 Mover la ventana corriente a una estación de trabajo
400 Cambiar a la proxima estación de trabajo con una ventana en ella
402 Cambiar a la anterior estación de trabajo con una ventana en ella
404 Mover el puntero a la proxima region
406 Mover el puntero a la anterior region
407 .It Cm screenshot_all
408 Tomar una captura de pantalla de todo la pantalla (si esta habilitado)
412 .It Cm screenshot_wind
413 Tomar una captura de pantalla de la ventana seleccionada (si esta habilitado)
418 Mostrar la version en la barra de estado
420 Mostar la ventana en foco entre las flotantes y acomodadas
427 Reiniciar la pantalla
433 Personalizar mapeos (bindings) en el archivo de configuración:
435 .Dl bind[<accion>] = <teclas>
438 una de las acciones listadas (o ninguna) y
440 una o mas teclas modificadas (puede ser ninguna tambien)
441 (MOD, Mod1, Shift, etc.) y una o mas teclas normales
442 (b, barra espaciadora, etc.), separadas por un "+".
444 .Bd -literal -offset indent
445 bind[reset] = Mod4+q # combinación Tecla de Windows + q reinicia
446 bind[] = Mod1+q # des-hace la combinación Alt + q
449 Multiples combinaciones de teclas pueden hacer lo mismo.
452 te da "quirks" (o forzados) ventanas que tienen que ser tratas de manera especial,
453 como por ejemplo, popups, aplicaciones de pantalla completa, etc.
455 Los "quirks" (o forzados) por defecto son:
457 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
458 .It Firefox-bin:firefox-bin
466 .It OpenOffice.org 2.4:VCLSalFrame
468 .It OpenOffice.org 3.1:VCLSalFrame
476 .It xine:xine Video Fullscreen Window
486 Los "quirks" (o forzados) se describen a continuación:
488 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
490 Esta ventana no tiene que ser acomodada, pero le permitimos flotar libremente.
492 Ajusta el tamaño de las ventanas transitorias que son demasiado pequeñas utilizando dialog_ratio
494 .Sx ARCHIVOS DE CONFIGURACIÓN ) .
496 Permite que la ventana se ponga donde quiera.
498 Ajusta las fuentes de xterm cuando se redimenciona.
500 Quita el borde para permitir las ventanas en pantalla completa.
503 Las configuraciones de "quirks" (o forzados) en el archivo de configuración se ven a continuación:
505 .Dl quirk[<clases>:<nombre>] = <quirk> [ + <quirk> ... ]
510 especifica la ventana en la cual el "quirk(s)" (o forzados) se aplica, y
512 es uno de los "quirks" (o forzados) de la lista.
514 .Bd -literal -offset indent
515 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # dejamos que mplayer funcione libremente
516 quirk[pcb:pcb] = NONE # borramos el quirk existente
523 corriendo el programa xprop(1) y luego clickear en la ventana que quieras.
524 En el proximo ejemplo, podremos verlo en acción con una ventana de Firefox:
525 .Bd -literal -offset indent
526 $ xprop | grep WM_CLASS
527 WM_CLASS(STRING) = "Navigator", "Firefox"
530 .Bl -tag -width "/etc/scrotwm.confXXX" -compact
531 .It Pa ~/.scrotwm.conf
533 archivo de configuración especifico del usuario.
534 .It Pa /etc/scrotwm.conf
536 configuraciones globales.
540 fue inspirado en xmonad y dwm.
546 .An Marco Peereboom Aq marco@peereboom.us ,
547 .An Ryan Thomas McBride Aq mcbride@countersiege.com
549 .An Darrin Chandler Aq dwchandler@stilyagin.com .
551 Actualmente el menu, se llama con