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 el reloj en la barra de estado, deshabilitado
107 por defecto con un 0, para usar el reloj de la barra de estado
110 Algunas aplicaciones tienen ventanas de dialogo muy pequeñas como para
111 ser usables. Este relación (ratio) es el tamaño de la pantalla, por
112 ejemplo 0.6 es 60% del tamaño físico de la pantalla.
114 Acomodar una region personalizada, removiendo cualquier autodeteción de
115 regiones que ocupe el espacio en la pantalla.
116 Definiendo el formato screen[<idx>]:WIDTHxHEIGHT+X+Y,
117 e.g.\& screen[1]:800x1200+0+0.
119 Setear un ancho minimo preferido para la terminal.
120 Si el valor es mayor que 0,
122 intentará ajustar el tamaño de la fuente de la terminal para mantener
123 el ancho de la terminal por encima de este número cuando la ventana
125 Actualmente solo es soportado por
129 no debe ser un setuid o setgid, que no sea el que viene por defecto en
130 la mayoria de los sistemas.
131 Los usuarios pueden necesitar setear program[term] (ver la sección
133 ) para usar una copia alternativa del binario de
135 sin el seteo del setgid.
136 .It Cm title_class_enabled
137 Habilitar o deshabilitar la clase de ventana en la barre de estado.
138 Habilitado seteando 1
139 .It Cm title_name_enabled
140 Habilitar o deshabilita el titulo de la ventana en la barra de estado.
141 Habilitado seteando 1
144 Mod1 generalmente es la tecla ALT y Mod4 la tecla de windows en una PC.
145 .It Cm program Ns Bq Ar p
146 Definir una nueva accion para ejecutar un programa.
150 .It Cm bind Ns Bq Ar x
151 Combinación de teclas para una acción
155 .It Cm quirk Ns Bq Ar c:n
156 Agregar un "quirk" (o forzados) para ventanas con clase
164 Los colores deben ser especificados por la especificación
166 y las fuentes por la especificación
170 te permite definir acciones personales para lanzar los programas que
171 quieras y luego obligar a la misma con una función de acciones.
175 Los programas por defecto se describen acá:
177 .Bl -tag -width "screenshot_wind" -offset indent -compact
180 .It Cm screenshot_all
181 screenshot.sh completo
182 .It Cm screenshot_wind
183 screenshot.sh por ventana
189 dmenu_run -fn $bar_font -nb $bar_color -nf $bar_font_color -sb $bar_border -sf $bar_color
192 Los programas en la configuración personal, se especifican aca:
194 .Dl program[<nombre>] = <progpath> [<arg> [... <arg>]]
197 es un identificador, no genera conflictos con ninguna accion o palabra
200 es la ruta al programa, y
202 es ninguno o mas de un argumento para el programa.
204 Las siguientes variables de configuracion en
207 .Sx ARCHIVOS DE CONFIGURACIÓN
209 y pueden ser usadas en los campos de
211 como asi tambien sustituidas por valores al momento del inicio de un
214 .Bl -tag -width "$bar_font_color" -offset indent -compact
218 .It Cm $bar_font_color
220 .It Cm $color_unfocus
224 .Bd -literal -offset indent
225 program[ff] = /usr/local/bin/firefox http://scrotwm.com.ar/
226 bind[ff] = Mod+f # Ahora Mod+F inicia firefox
229 Para deshacer lo anterior:
230 .Bd -literal -offset indent
237 provee muchas funciones (o acciones) accesibles por medio de la
238 asignación (bindings) de teclas o el mouse.
240 Las corrientes asignaciones (bindings) del mouse son:
242 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
248 Redimenciono una ventana
250 Redimenciono una ventana hasta que quede centrada
253 Las corrientes asignaciones (bindings) de teclas son:
255 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
256 .It Cm M-S- Ns Aq Cm Return
265 .It Cm M- Ns Aq Cm Space
267 .It Cm M-S- Ns Aq Cm Space
281 .It Cm M- Ns Aq Cm Return
290 .Cm M-S- Ns Aq Cm TAB
307 .It Cm M-S- Ns Aq Ar n
309 .It Cm M- Ns Aq Cm Right
311 .It Cm M- Ns Aq Cm Left
313 .It Cm M-S- Ns Aq Cm Right
315 .It Cm M-S- Ns Aq Cm Left
325 .It Cm M-S Aq Cm Delete
331 El nombre de las acciónes descripta a continuación:
333 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
335 Ejecutar una terminal
351 Disposición de las ventanas
353 Reiniciar la disposición de las ventanas
355 Achicar la region principal
357 Agrandar la region principal
359 Agregar una ventana a la region principal
361 Quitar una ventana de la region principal
363 Agregar columnas/filas a las pilas
365 Quitar columnas/filas de las pilas
367 Mover la ventana corriente a la region principal
369 Enfocar la proxima ventana en la estación de trabajo
371 Enfocar la anterior ventana en la estación de trabajo
373 Enfocar en la ventana principal de la estación de trabajo
375 Ejecutar con la siguiente ventana en la estación de trabajo
377 Ejecutar con la anterior ventana en la estación de trabajo
379 Cambiar la barra de estado en todas las estaciones de trabajo
381 Borrar la ventana corriente en la estación de trabajo
383 Destruir la ventana corriente en la estación de trabajo
385 Cambiar entre estaciones de trabajo
391 Mover la ventana corriente a una estación de trabajo
397 Cambiar a la proxima estación de trabajo con una ventana en ella
399 Cambiar a la anterior estación de trabajo con una ventana en ella
401 Mover el puntero a la proxima region
403 Mover el puntero a la anterior region
404 .It Cm screenshot_all
405 Tomar una captura de pantalla de todo la pantalla (si esta habilitado)
409 .It Cm screenshot_wind
410 Tomar una captura de pantalla de la ventana seleccionada (si esta habilitado)
415 Mostrar la version en la barra de estado
417 Mostar la ventana en foco entre las flotantes y acomodadas
424 Reiniciar la pantalla
430 Personalizar mapeos (bindings) en el archivo de configuración:
432 .Dl bind[<accion>] = <teclas>
435 una de las acciones listadas (o ninguna) y
437 una o mas teclas modificadas (puede ser ninguna tambien)
438 (MOD, Mod1, Shift, etc.) y una o mas teclas normales
439 (b, barra espaciadora, etc.), separadas por un "+".
441 .Bd -literal -offset indent
442 bind[reset] = Mod4+q # combinación Tecla de Windows + q reinicia
443 bind[] = Mod1+q # des-hace la combinación Alt + q
446 Multiples combinaciones de teclas pueden hacer lo mismo.
449 te da "quirks" (o forzados) ventanas que tienen que ser tratas de manera especial,
450 como por ejemplo, popups, aplicaciones de pantalla completa, etc.
452 Los "quirks" (o forzados) por defecto son:
454 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
455 .It Firefox-bin:firefox-bin
463 .It OpenOffice.org 2.4:VCLSalFrame
465 .It OpenOffice.org 3.1:VCLSalFrame
473 .It xine:xine Video Fullscreen Window
483 Los "quirks" (o forzados) se describen a continuación:
485 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
487 Esta ventana no tiene que ser acomodada, pero le permitimos flotar libremente.
489 Ajusta el tamaño de las ventanas transitorias que son demasiado pequeñas utilizando dialog_ratio
491 .Sx ARCHIVOS DE CONFIGURACIÓN ) .
493 Permite que la ventana se ponga donde quiera.
495 Ajusta las fuentes de xterm cuando se redimenciona.
497 Quita el borde para permitir las ventanas en pantalla completa.
500 Las configuraciones de "quirks" (o forzados) en el archivo de configuración se ven a continuación:
502 .Dl quirk[<clases>:<nombre>] = <quirk> [ + <quirk> ... ]
507 especifica la ventana en la cual el "quirk(s)" (o forzados) se aplica, y
509 es uno de los "quirks" (o forzados) de la lista.
511 .Bd -literal -offset indent
512 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # dejamos que mplayer funcione libremente
513 quirk[pcb:pcb] = NONE # borramos el quirk existente
520 corriendo el programa xprop(1) y luego clickear en la ventana que quieras.
521 En el proximo ejemplo, podremos verlo en acción con una ventana de Firefox:
522 .Bd -literal -offset indent
523 $ xprop | grep WM_CLASS
524 WM_CLASS(STRING) = "Navigator", "Firefox"
527 .Bl -tag -width "/etc/scrotwm.confXXX" -compact
528 .It Pa ~/.scrotwm.conf
530 archivo de configuración especifico del usuario.
531 .It Pa /etc/scrotwm.conf
533 configuraciones globales.
537 fue inspirado en xmonad y dwm.
543 .An Marco Peereboom Aq marco@peereboom.us ,
544 .An Ryan Thomas McBride Aq mcbride@countersiege.com
546 .An Darrin Chandler Aq dwchandler@stilyagin.com .
548 Actualmente el menu, se llama con