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
147 .It Cm window_name_enabled
148 Habilitar o deshabilita el nombre de la ventana en la barra de estado.
149 Habilitado seteando 1
152 Mod1 generalmente es la tecla ALT y Mod4 la tecla de windows en una PC.
154 Usando el valor de follow_cursor puedes hacer que el manejador de ventanas
155 se enfoque en la ventana cuando el cursor pase por arriba de las mismas o
156 bien cambiando de estacion de trabajo.
157 .It Cm disable_border
158 Remueve el borde de una sola ventana cuando la barra de estado esta desactivada.
159 .It Cm program Ns Bq Ar p
160 Definir una nueva accion para ejecutar un programa.
164 .It Cm bind Ns Bq Ar x
165 Combinación de teclas para una acción
169 .It Cm quirk Ns Bq Ar c:n
170 Agregar un "quirk" (o forzados) para ventanas con clase
178 Los colores deben ser especificados por la especificación
180 y las fuentes por la especificación
184 te permite definir acciones personales para lanzar los programas que
185 quieras y luego obligar a la misma con una función de acciones.
189 Los programas por defecto se describen acá:
191 .Bl -tag -width "screenshot_wind" -offset indent -compact
194 .It Cm screenshot_all
195 screenshot.sh completo
196 .It Cm screenshot_wind
197 screenshot.sh por ventana
203 dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
206 Los programas en la configuración personal, se especifican aca:
208 .Dl program[<nombre>] = <progpath> [<arg> [... <arg>]]
211 es un identificador, no genera conflictos con ninguna accion o palabra
214 es la ruta al programa, y
216 es ninguno o mas de un argumento para el programa.
218 Las siguientes variables de configuracion en
221 .Sx ARCHIVOS DE CONFIGURACIÓN
223 y pueden ser usadas en los campos de
225 como asi tambien sustituidas por valores al momento del inicio de un
228 .Bl -tag -width "$bar_font_color" -offset indent -compact
232 .It Cm $bar_font_color
234 .It Cm $color_unfocus
238 .Bd -literal -offset indent
239 program[ff] = /usr/local/bin/firefox http://scrotwm.com.ar/
240 bind[ff] = Mod+f # Ahora Mod+F inicia firefox
243 Para deshacer lo anterior:
244 .Bd -literal -offset indent
251 una se?al de HUP reinicia scrotwm.
255 provee muchas funciones (o acciones) accesibles por medio de la
256 asignación (bindings) de teclas o el mouse.
258 Las corrientes asignaciones (bindings) del mouse son:
260 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
266 Redimenciono una ventana
268 Redimenciono una ventana hasta que quede centrada
271 Las corrientes asignaciones (bindings) de teclas son:
273 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
274 .It Cm M-S- Ns Aq Cm Return
283 .It Cm M- Ns Aq Cm Space
285 .It Cm M-S- Ns Aq Cm Space
299 .It Cm M- Ns Aq Cm Return
308 .Cm M-S- Ns Aq Cm TAB
325 .It Cm M-S- Ns Aq Ar n
327 .It Cm M- Ns Aq Cm Right
329 .It Cm M- Ns Aq Cm Left
333 .It Cm M-S- Ns Aq Cm Right
335 .It Cm M-S- Ns Aq Cm Left
345 .It Cm M-S Aq Cm Delete
351 El nombre de las acciónes descripta a continuación:
353 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
355 Ejecutar una terminal
371 Disposición de las ventanas
373 Reiniciar la disposición de las ventanas
375 Achicar la region principal
377 Agrandar la region principal
379 Agregar una ventana a la region principal
381 Quitar una ventana de la region principal
383 Agregar columnas/filas a las pilas
385 Quitar columnas/filas de las pilas
387 Mover la ventana corriente a la region principal
389 Enfocar la proxima ventana en la estación de trabajo
391 Enfocar la anterior ventana en la estación de trabajo
393 Enfocar en la ventana principal de la estación de trabajo
395 Ejecutar con la siguiente ventana en la estación de trabajo
397 Ejecutar con la anterior ventana en la estación de trabajo
399 Cambiar la barra de estado en todas las estaciones de trabajo
401 Borrar la ventana corriente en la estación de trabajo
403 Destruir la ventana corriente en la estación de trabajo
405 Cambiar entre estaciones de trabajo
411 Mover la ventana corriente a una estación de trabajo
417 Cambiar a la proxima estación de trabajo con una ventana en ella
419 Cambiar a la anterior estación de trabajo con una ventana en ella
421 Mover el puntero a la proxima region
423 Mover el puntero a la anterior region
424 .It Cm screenshot_all
425 Tomar una captura de pantalla de todo la pantalla (si esta habilitado)
429 .It Cm screenshot_wind
430 Tomar una captura de pantalla de la ventana seleccionada (si esta habilitado)
435 Mostrar la version en la barra de estado
437 Mostar la ventana en foco entre las flotantes y acomodadas
444 Reiniciar la pantalla
450 Personalizar mapeos (bindings) en el archivo de configuración:
452 .Dl bind[<accion>] = <teclas>
455 una de las acciones listadas (o ninguna) y
457 una o mas teclas modificadas (puede ser ninguna tambien)
458 (MOD, Mod1, Shift, etc.) y una o mas teclas normales
459 (b, barra espaciadora, etc.), separadas por un "+".
461 .Bd -literal -offset indent
462 bind[reset] = Mod4+q # combinación Tecla de Windows + q reinicia
463 bind[] = Mod1+q # des-hace la combinación Alt + q
466 Multiples combinaciones de teclas pueden hacer lo mismo.
469 te da "quirks" (o forzados) ventanas que tienen que ser tratas de manera especial,
470 como por ejemplo, popups, aplicaciones de pantalla completa, etc.
472 Los "quirks" (o forzados) por defecto son:
474 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
475 .It Firefox\-bin:firefox\-bin
483 .It OpenOffice.org 2.4:VCLSalFrame
485 .It OpenOffice.org 3.1:VCLSalFrame
493 .It xine:xine Video Fullscreen Window
503 Los "quirks" (o forzados) se describen a continuación:
505 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
507 Esta ventana no tiene que ser acomodada, pero le permitimos flotar libremente.
509 Ajusta el tamaño de las ventanas transitorias que son demasiado pequeñas utilizando dialog_ratio
511 .Sx ARCHIVOS DE CONFIGURACIÓN ) .
513 Permite que la ventana se ponga donde quiera.
515 Ajusta las fuentes de xterm cuando se redimenciona.
517 Quita el borde para permitir las ventanas en pantalla completa.
520 Las configuraciones de "quirks" (o forzados) en el archivo de configuración se ven a continuación:
522 .Dl quirk[<clases>:<nombre>] = <quirk> [ + <quirk> ... ]
527 especifica la ventana en la cual el "quirk(s)" (o forzados) se aplica, y
529 es uno de los "quirks" (o forzados) de la lista.
531 .Bd -literal -offset indent
532 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # dejamos que mplayer funcione libremente
533 quirk[pcb:pcb] = NONE # borramos el quirk existente
540 corriendo el programa xprop(1) y luego clickear en la ventana que quieras.
541 En el proximo ejemplo, podremos verlo en acción con una ventana de Firefox:
542 .Bd -literal -offset indent
543 $ xprop | grep WM_CLASS
544 WM_CLASS(STRING) = "Navigator", "Firefox"
547 .Bl -tag -width "/etc/scrotwm.confXXX" -compact
548 .It Pa ~/.scrotwm.conf
550 archivo de configuración especifico del usuario.
551 .It Pa /etc/scrotwm.conf
553 configuraciones globales.
557 fue inspirado en xmonad y dwm.
563 .An Marco Peereboom Aq marco@peereboom.us ,
564 .An Ryan Thomas McBride Aq mcbride@countersiege.com
566 .An Darrin Chandler Aq dwchandler@stilyagin.com .
568 Actualmente el menu, se llama con