spectrwm

spectrwm

spectrwm è un gestore di finestre minimale che cerca di stare in disparte, in modo che il prezioso spazio sullo schermo possa essere usato per cose più importanti. Hai dei default sensati e non costringe l'utente ad imparare un linguaggio di programmazione per configurarlo. È stato scritto dagli hacker per gli hacker e cerca di essere piccolo, compatto e veloce.

Quando spectrwm viene avviato, legge le impostazioni presenti nel file di configurazione spectrwm.conf. Vedere la sezione FILE DI CONFIGURAZIONE più sotto.

In questa pagina di manuale viene usata la seguente notazione:

spectrwm è molto semplice da usare. La maggior parte delle operazioni vengono svolte usando combinazioni di tasti sulla tastiera o sul mouse. Vedere la sezione SCORCIATOIE più sotto per i default e le possibilità di personalizzazione.

spectrwm prova per prima cosa ad aprire il file di configurazione personale dell'utente, ~/.spectrwm.conf. Se il file in questione non è disponibile, prova ad usare il file di configurazione globale /etc/spectrwm.conf.

Il formato di questo file è <chiave> = <valore>. Per esempio:

Per abilitare o disabilitare un'opzione, usare i valori 1 o 0 rispettivamente.

Il file supporta le seguenti chiavi:

autorun

Esegue un'applicazione nel workspace specificato all'avvio. Definito nel formato ws[<idx>]:applicazione, eg. ws[2]:xterm esegue un xterm nell'area di lavoro 2.

bar_action

Script esterno che aggiunge informazioni come la carica della batteria alla barra di stato.

bar_at_bottom

Posiziona la barra di stato sul fondo dello schermo anziché in cima.

bar_border[x]

Colore del bordo della barra di stato nello schermo x.

bar_border_width

Spessore del bordo attorno alla barra di stato in pixel. Il bordo può essere disabilitato usando il valore 0.

bar_color[x]

Colore della barra di stato nello schermo x.

bar_delay

Frequenza di aggiornamento, in secondi, dello script esterno che aggiunge informazioni alla barra di stato.

bar_enabled

Abilita o disabilita la barra di stato.

bar_font

Font della barra di stato.

bar_font_color[x]

Colore del testo della barra di stato nello schermo x.

bar_justify

Giustifica il testo nella barra di stato. I valori possibili sono left (sinistra), center (centro), e right (destra).

bind[x]

Assegna una combinazione di tasti all'azione x. Vedere la sezione SCORCIATOIE più sotto.

border_width

Spessore del bordo delle finestre in pixel. Il valore 0 disabilita il bordo.

clock_enabled

Abilita o disabilita l'orologio nella barra di stato. Se disabilitato, usando il valore 0, è possibile usare un orologio personalizzato nello script specificato in bar_action.

color_focus

Colore del bordo della finestra che ha il focus.

color_unfocus

Colore del bordo delle finestre che non hanno il focus.

dialog_ratio

Alcune applicazioni hanno finestre di dialogo troppo piccole per risultare utili. Questa è la percentuale dello schermo che verrà usata per le finestre di dialogo: ad esempio, 0.6 indica il 60% della dimensione fisica dello schermo.

disable_border

Rimuovi il bordo dalle finestre se la barra di stato è nascosta e c'è una sola finestra sullo schermo.

focus_mode

Se viene usato il valore follow_cursor (segui il cursore), il gestore di finestre darà il focus alla finestra sotto il puntatore quando si cambia area di lavoro o si creano finestre.

keyboard_mapping

Ignora tutte le scorciatoie esistenti e carica delle nuove scorciatoie dal file specificato. Vedere la sezione FILE DI MAPPATURA DELLA TASTIERA per una lista di file di mappatura che vengono forniti per diversi layout di tastiera.

layout

Layout da utilizzare all'avvio. Definito nel formato ws[<idx>]:master_grow:master_add:stack_inc:layout:always_raise:stack_mode, eg. ws[2]:-4:0:1:0:horizontal assegna il layout orizzontale all'area di lavoro 2, riduce l'area principale di 4 unità, aggiunge una finestra allo stack e mantiene il comportamento predefinito per quanto riguarda le finestre floating. I valori possibili per stack_mode sono vertical (verticale), horizontal (orizzontale) e fullscreen (a schermo intero).

Fare riferimento a master_grow, master_shrink, master_add, master_del, stack_inc, stack_del e always_raise per ulteriori informazioni. Queste impostazioni sono complesse e hanno effetti secondari; è opportuno familiarizzare con questi comandi prima di modificare l'opzione layout.

Questa impostazione non viene applicata dopo il restart.

modkey

Cambia il tasto modificatore. Solitamente Mod1 è il tasto ALT e Mod4 è il tasto Windows su un PC.

program[p]

Definisce una nuova azione per lanciare il programma p. Vedere la sezione PROGRAMMI più sotto.

quirk[c:n]

Aggiunge un "quirk" per le finestre di classe c e nome n. Vedere la sezione QUIRK più sotto.

region

Alloca una regione personalizzata, rimuovendo qualsiasi regione automaticamente rilevata stia occupando lo stesso spazio sullo schermo. Definita nel formato screen[<idx>]:LARGHEZZAxALTEZZA+X+Y, ad esempio screen[1]:800x1200+0+0.

Per fare sì che più monitor vengano considerati come una singola entità è sufficiente creare una regione abbastanza grande da contenerli, eg. screen[1]:2048x760+0+0 unisce due monitor con risoluzione 1024x768 posizionati uno di fianco all'altro.

stack_enabled

Abilita o disabilita la visualizzazione dell'algoritmo di stacking corrente nella barra di stato.

term_width

Imposta la dimensione minima preferita per il terminale. Se questo valore è maggiore di 0, spectrwm cercherà di adattare la dimensione del testo nel terminale in modo che la larghezza del terminale rimanga sopra il valore quando la finestra viene ridimensionata. Al momento solo xterm(1) è supportato. L'eseguibile di xterm(1) deve essere setuid o setgid perché questo funzioni: nella maggior parte dei sistemi, questo avviene di default. L'utente potrebbe voler impostare program[term] (vedere la sezione PROGRAMMI più sotto) per usare una seconda copia dell'eseguibile di xterm(1) che non abbia il bit setgid impostato.

title_class_enabled

Abilita o disabilita la visualizzazione della classe della finestra nella barra di stato. Impostare a 1 per abilitare.

title_name_enabled

Abilita o disabilita la visualizzazione del titolo della finestra nella barra di stato. Impostare a 1 per abilitare.

urgent_enabled

Abilita o disabilita l'hint "urgente". In molti emulatori di terminale, il supporto deve essere abilitato separatamente: per xterm, ad esempio, è necessario aggiungere la riga xterm.urgentOnBell: true al file .Xdefaults.

verbose_layout

Abilita o disabilita la visualizzazione dei valori correnti di master e stack nella barra di stato. Impostare a 1 per abilitare.

window_name_enabled

Abilita o disabilita la visualizzazione del nome della finestra nella barra di stato. Impostare a 1 per abilitare.

I colori devono essere specificati nel formato usato da XQueryColor(3) e i font in quello usato da XQueryFont(3).

Per avere una lista dei font disponibili sul proprio sistema utilizzare fc-list(1) o xlsfonts(1). L'applicazione xfontsel(1) è utile per visualizzare la X Logical Font Description ("XLFD") usata per la chiave bar_font.

spectrwm consente la definizione di azioni personalizzate per lanciare programmi di propria scelta, che possono essere assegnate a combinazioni di tasti nello stesso modo in cui è possibile farlo con le azioni predefinite. Vedere la sezione SCORCIATOIE più sotto.

I programmi di default sono descritti qui sotto:

I programmi personalizzati vengono specificati con la seguente sintassi:

⟨nome⟩ è un qualsiasi identificatore che non va in conflitto con un'azione predefinita o una chiave, ⟨percorso⟩ è il programma desiderato, e ⟨arg⟩ sono zero o più argomenti da passare al programma.

Le seguenti variabili rappresentano valori impostabili in spectrwm (vedere la sezione FILE DI CONFIGURAZIONE sopra), e possono essere usati nel campo ⟨arg⟩ dove saranno sostituite con il valore al momento del lancio del programma:

Esempio:

program[ff] = /usr/local/bin/firefox http://spectrwm.org/
bind[ff] = Mod+Shift+b # adesso Mod+Shift+b lancia firefox

Per eliminare la combinazione precedente:

bind[] = Mod+Shift+b
program[ff] =

spectrwm fornisce molte funzioni (o azioni) accessibili tramite combinazioni di tasti sul mouse o sulla tastiera.

Le scorciatoie assegnate al mouse sono:

Le scorciatoie da tastiera di default sono:

I nomi delle azioni e le relative descrizioni sono le seguenti:

Le scorciatoie personalizzate sono specificate nel file di configurazione come segue:

⟨azione⟩ è una delle azioni elencate sopra (oppure nulla) e ⟨tasti⟩ è dato da zero o più modificatori (MOD, Mod1, Shift, ecc.) e uno o più tasti normali (b, space, ecc.), separati da "+". Per esempio:

bind[reset] = Mod4+q # assegna reset ai tasti Windows + q
bind[] = Mod1+q # rimuovi l'assegnazione di Alt + q

Più combinazioni di tasti possono essere assegnate alla stessa azione.

I file di mappatura per svariati layout di tastiera sono elencati qui sotto. Questi file possono essere utilizzati tramite la chiave di configurazione keyboard_mapping per caricare scorciatoie create appositamente per un determinato layout di tastiera.

spectrwm fornisce la possibilità di specificare dei "quirk" per la gestione di finestre che devono subire un trattamento speciale da un gestore di finestre tiling, come ad esempio alcune finestre di dialogo e applicazioni a schermo intero.

I quirk abilitati di default sono elencati qui sotto:

I quirk sono descritti qui sotto:

I quirk personalizzati vanno specificati nel file di configurazione come segue:

⟨classe⟩ e ⟨nome⟩ specificano a quali finestre i quirk vanno applicati, e ⟨quirk⟩ è uno dei quirk presente nella lista sopra. Ad esempio:

quirk[MPlayer:xv] = FLOAT + FULLSCREEN + FOCUSPREV
quirk[pcb:pcb] = NONE  # rimuovi un quirk precedentemente specificato

È possibile ottenere ⟨classe⟩ e ⟨nome⟩ usando xprop(1) e facendo click sulla finestra desiderata. Nel seguente esempio è stato fatto click sulla finestra principale di Firefox:

$ xprop | grep WM_CLASS
WM_CLASS(STRING) = "Navigator", "Firefox"

Bisogna tenere conto del fatto che usare grep(1) per trovare WM_CLASS inverte la classe e il nome. Nell'esempio precedente, la dichiarazione del quirk sarebbe

quirk[Firefox:Navigator] = FLOAT

spectrwm assegna automaticamente i quirk alle finestre in base al valore della proprietà _NET_WM_WINDOW_TYPE in base al seguente schema:

In tutti gli altri casi, nessun quirk è automaticamente assegnato alla finestra. I quirk specificati nel file di configurazione hanno la precedenza sui quirk assegnati in automatico.

spectrwm implementa in maniera parziale la specifica Extended Window Manager Hints (EWMH). Ciò permette di controllare sia le finestre che spectrwm stesso tramite script e programmi esterni. Per renderlo possibile, spectrwm risponde ad alcuni eventi di tipo ClientMessage; questo tipo di messaggio può essere inviato da un terminale usando programmi come wmctrl(1) e xdotool(1). Per il formato esatto di questi messaggi, si veda la specifica EWMH.

L'id della finestra che ha il focus è memorizzato nella proprietà _NET_ACTIVE_WINDOW della root window. È quindi possibile ottenere il titolo della finestra attiva usando xprop(1) e grep(1)

$ WINDOWID=`xprop -root _NET_ACTIVE_WINDOW | grep -o "0x.*"`
$ xprop -id $WINDOWID WM_NAME | grep -o "\".*\""

Per dare il focus ad una finestra, è sufficiente inviare il messaggio _NET_ACTIVE_WINDOW alla root window. Ad esempio, usando wmctrl(1) (supponendo che 0x4a0000b sia l'id della finestra a cui dare il focus):

$ wmctrl -i -c 0x4a0000b

Per chiudere una finestra si può inviare il messaggio _NET_CLOSE_WINDOW alla root window. Ad esempio, usando wmctrl(1) (supponendo che 0x4a0000b sia l'id della finestra da chiudere):

$ wmctrl -i -c 0x4a0000b

Per passare una finestra da floating a tiled si può aggiungere o rimuovere l'atomo _NET_WM_STATE_ABOVE alla proprietà _NET_WM_STATE della finestra, inviando il messaggio _NET_WM_STATE alla root window. Ad esempio, usando wmctrl(1) (supponendo che 0x4a0000b sia l'id della finestra):

$ wmctrl -i -r 0x4a0000b -b toggle,_NET_WM_STATE_ABOVE

Le finestre floating possono essere ridimensionate o spostate inviando il messaggio _NET_MOVERESIZE_WINDOW alla root window. Ad esempio, usando wmctrl(1) (supponendo che 0x4a0000b sia l'id della finestra da spostare):

$ wmctrl -i -r 0x4a0000b -e 0,100,50,640,480

Questo comando sposta la finestra in (100,50) e la ridimensiona a 640x480.

I messaggi _NET_MOVERESIZE_WINDOW vengono ignorati per le finestre stacked.

È possibile riavviare spectrwm inviandogli il segnale HUP.

~/.spectrwm.conf

impostazioni di spectrwm dell'utente.

/etc/spectrwm.conf

impostazioni globali di spectrwm.

spectrwm prende ispirazione da xmonad & dwm.

spectrwm è stato scritto da: