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 Puedes posicionar la statusbar en la parte inferior de la pantalla.
108 Habilitar o deshabilitar mostrar el algoritmo de apilamiento en la barra
111 Habilitar o deshabilitar el reloj en la barra de estado, deshabilitado
112 por defecto con un 0, para usar el reloj de la barra de estado
115 Algunas aplicaciones tienen ventanas de dialogo muy pequeñas como para
116 ser usables. Este relación (ratio) es el tamaño de la pantalla, por
117 ejemplo 0.6 es 60% del tamaño físico de la pantalla.
119 Acomodar una region personalizada, removiendo cualquier autodeteción de
120 regiones que ocupe el espacio en la pantalla.
121 Definiendo el formato screen[<idx>]:WIDTHxHEIGHT+X+Y,
122 e.g.\& screen[1]:800x1200+0+0.
124 Setear un ancho minimo preferido para la terminal.
125 Si el valor es mayor que 0,
127 intentará ajustar el tamaño de la fuente de la terminal para mantener
128 el ancho de la terminal por encima de este número cuando la ventana
130 Actualmente solo es soportado por
134 no debe ser un setuid o setgid, que no sea el que viene por defecto en
135 la mayoria de los sistemas.
136 Los usuarios pueden necesitar setear program[term] (ver la sección
138 ) para usar una copia alternativa del binario de
140 sin el seteo del setgid.
141 .It Cm title_class_enabled
142 Habilitar o deshabilitar la clase de ventana en la barre de estado.
143 Habilitado seteando 1
144 .It Cm title_name_enabled
145 Habilitar o deshabilita el titulo de la ventana en la barra de estado.
146 Habilitado seteando 1
149 Mod1 generalmente es la tecla ALT y Mod4 la tecla de windows en una PC.
151 Usando el valor de follow_cursor puedes hacer que el manejador de ventanas
152 se enfoque en la ventana cuando el cursor pase por arriba de las mismas o
153 bien cambiando de estacion de trabajo.
154 .It Cm disable_border
155 Remueve el borde de una sola ventana cuando la barra de estado esta desactivada.
156 .It Cm program Ns Bq Ar p
157 Definir una nueva accion para ejecutar un programa.
161 .It Cm bind Ns Bq Ar x
162 Combinación de teclas para una acción
166 .It Cm quirk Ns Bq Ar c:n
167 Agregar un "quirk" (o forzados) para ventanas con clase
175 Los colores deben ser especificados por la especificación
177 y las fuentes por la especificación
181 te permite definir acciones personales para lanzar los programas que
182 quieras y luego obligar a la misma con una función de acciones.
186 Los programas por defecto se describen acá:
188 .Bl -tag -width "screenshot_wind" -offset indent -compact
191 .It Cm screenshot_all
192 screenshot.sh completo
193 .It Cm screenshot_wind
194 screenshot.sh por ventana
200 dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
203 Los programas en la configuración personal, se especifican aca:
205 .Dl program[<nombre>] = <progpath> [<arg> [... <arg>]]
208 es un identificador, no genera conflictos con ninguna accion o palabra
211 es la ruta al programa, y
213 es ninguno o mas de un argumento para el programa.
215 Las siguientes variables de configuracion en
218 .Sx ARCHIVOS DE CONFIGURACIÓN
220 y pueden ser usadas en los campos de
222 como asi tambien sustituidas por valores al momento del inicio de un
225 .Bl -tag -width "$bar_font_color" -offset indent -compact
229 .It Cm $bar_font_color
231 .It Cm $color_unfocus
235 .Bd -literal -offset indent
236 program[ff] = /usr/local/bin/firefox http://scrotwm.com.ar/
237 bind[ff] = Mod+f # Ahora Mod+F inicia firefox
240 Para deshacer lo anterior:
241 .Bd -literal -offset indent
248 una se?al de HUP reinicia scrotwm.
252 provee muchas funciones (o acciones) accesibles por medio de la
253 asignación (bindings) de teclas o el mouse.
255 Las corrientes asignaciones (bindings) del mouse son:
257 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
263 Redimenciono una ventana
265 Redimenciono una ventana hasta que quede centrada
268 Las corrientes asignaciones (bindings) de teclas son:
270 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
271 .It Cm M-S- Ns Aq Cm Return
280 .It Cm M- Ns Aq Cm Space
282 .It Cm M-S- Ns Aq Cm Space
296 .It Cm M- Ns Aq Cm Return
305 .Cm M-S- Ns Aq Cm TAB
322 .It Cm M-S- Ns Aq Ar n
324 .It Cm M- Ns Aq Cm Right
326 .It Cm M- Ns Aq Cm Left
330 .It Cm M-S- Ns Aq Cm Right
332 .It Cm M-S- Ns Aq Cm Left
342 .It Cm M-S Aq Cm Delete
348 El nombre de las acciónes descripta a continuación:
350 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
352 Ejecutar una terminal
368 Disposición de las ventanas
370 Reiniciar la disposición de las ventanas
372 Achicar la region principal
374 Agrandar la region principal
376 Agregar una ventana a la region principal
378 Quitar una ventana de la region principal
380 Agregar columnas/filas a las pilas
382 Quitar columnas/filas de las pilas
384 Mover la ventana corriente a la region principal
386 Enfocar la proxima ventana en la estación de trabajo
388 Enfocar la anterior ventana en la estación de trabajo
390 Enfocar en la ventana principal de la estación de trabajo
392 Ejecutar con la siguiente ventana en la estación de trabajo
394 Ejecutar con la anterior ventana en la estación de trabajo
396 Cambiar la barra de estado en todas las estaciones de trabajo
398 Borrar la ventana corriente en la estación de trabajo
400 Destruir la ventana corriente en la estación de trabajo
402 Cambiar entre estaciones de trabajo
408 Mover la ventana corriente a una estación de trabajo
414 Cambiar a la proxima estación de trabajo con una ventana en ella
416 Cambiar a la anterior estación de trabajo con una ventana en ella
418 Mover el puntero a la proxima region
420 Mover el puntero a la anterior region
421 .It Cm screenshot_all
422 Tomar una captura de pantalla de todo la pantalla (si esta habilitado)
426 .It Cm screenshot_wind
427 Tomar una captura de pantalla de la ventana seleccionada (si esta habilitado)
432 Mostrar la version en la barra de estado
434 Mostar la ventana en foco entre las flotantes y acomodadas
441 Reiniciar la pantalla
447 Personalizar mapeos (bindings) en el archivo de configuración:
449 .Dl bind[<accion>] = <teclas>
452 una de las acciones listadas (o ninguna) y
454 una o mas teclas modificadas (puede ser ninguna tambien)
455 (MOD, Mod1, Shift, etc.) y una o mas teclas normales
456 (b, barra espaciadora, etc.), separadas por un "+".
458 .Bd -literal -offset indent
459 bind[reset] = Mod4+q # combinación Tecla de Windows + q reinicia
460 bind[] = Mod1+q # des-hace la combinación Alt + q
463 Multiples combinaciones de teclas pueden hacer lo mismo.
466 te da "quirks" (o forzados) ventanas que tienen que ser tratas de manera especial,
467 como por ejemplo, popups, aplicaciones de pantalla completa, etc.
469 Los "quirks" (o forzados) por defecto son:
471 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
472 .It Firefox\-bin:firefox\-bin
480 .It OpenOffice.org 2.4:VCLSalFrame
482 .It OpenOffice.org 3.1:VCLSalFrame
490 .It xine:xine Video Fullscreen Window
500 Los "quirks" (o forzados) se describen a continuación:
502 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
504 Esta ventana no tiene que ser acomodada, pero le permitimos flotar libremente.
506 Ajusta el tamaño de las ventanas transitorias que son demasiado pequeñas utilizando dialog_ratio
508 .Sx ARCHIVOS DE CONFIGURACIÓN ) .
510 Permite que la ventana se ponga donde quiera.
512 Ajusta las fuentes de xterm cuando se redimenciona.
514 Quita el borde para permitir las ventanas en pantalla completa.
517 Las configuraciones de "quirks" (o forzados) en el archivo de configuración se ven a continuación:
519 .Dl quirk[<clases>:<nombre>] = <quirk> [ + <quirk> ... ]
524 especifica la ventana en la cual el "quirk(s)" (o forzados) se aplica, y
526 es uno de los "quirks" (o forzados) de la lista.
528 .Bd -literal -offset indent
529 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # dejamos que mplayer funcione libremente
530 quirk[pcb:pcb] = NONE # borramos el quirk existente
537 corriendo el programa xprop(1) y luego clickear en la ventana que quieras.
538 En el proximo ejemplo, podremos verlo en acción con una ventana de Firefox:
539 .Bd -literal -offset indent
540 $ xprop | grep WM_CLASS
541 WM_CLASS(STRING) = "Navigator", "Firefox"
544 .Bl -tag -width "/etc/scrotwm.confXXX" -compact
545 .It Pa ~/.scrotwm.conf
547 archivo de configuración especifico del usuario.
548 .It Pa /etc/scrotwm.conf
550 configuraciones globales.
554 fue inspirado en xmonad y dwm.
560 .An Marco Peereboom Aq marco@peereboom.us ,
561 .An Ryan Thomas McBride Aq mcbride@countersiege.com
563 .An Darrin Chandler Aq dwchandler@stilyagin.com .
565 Actualmente el menu, se llama con