Dwm

From Gentoo Wiki
Jump to:navigation Jump to:search
This page is a translated version of the page Dwm and the translation is 75% complete.
Other languages:


dwm (abbreviazione di dynamic window manager) è un window manager dinamico per X11 prodotto da suckless.org. dwm è un singolo binario, ed il suo codice sorgente non dovrebbe mai eccedere 2000 SLOC.

dwm è configurato modificando il codice sorgente in C e ricompilandolo. Il sito web di suckless afferma che il progetto si concentra sugli utenti di computer avanzati ed esperti e - forse ironicamente - che la personalizzazione tramite la modifica del codice sorgente stesso "tiene l'utenza piccola ed elitista".

Modello di finestra

dwm, in quanto window manager dinamico, gestisce le finestre con layout tiled, floating e monocle. Tutti questi layout possono essere applicati dinamicamente, ottimizzando l'ambiente in base all'applicazione in uso e al compito da svolgere.

Puoi avviare qualche terminale con Shift+Alt+Enter e dwm le disporrà a mosaico divise in master e stack. Un nuovo terminale sarà posizionato nella finestra master, mente le finestre esistenti sono spostate in una pila - in inglese, stack - sulla destra. Alt+Enter alterna le finestre tra master e stack. 

   +------+----------------------------------+--------+
   | tags | title                            | status +
   +------+---------------------+------------+--------+
   |                            |                     |
   |                            |                     |
   |                            |                     |
   |                            |                     |
   |          master            |        stack        |
   |                            |                     |
   |                            |                     |
   |                            |                     |
   |                            |                     |
   +----------------------------+---------------------+

Installazione

USE flag

USE flags for x11-wm/dwm a dynamic window manager for X11

savedconfig Use this to restore your config from /etc/portage/savedconfig ${CATEGORY}/${PN}. Make sure your USE flags allow for appropriate dependencies
xinerama Add support for querying multi-monitor screen geometry through the Xinerama API
Data provided by the Gentoo Package Database · Last update: 2024-04-23 10:40 More information about USE flags

Gli utenti dovrebbero considerare l'abilitare l'USE flag savedconfig per salvare il file di configurazione personalizzato in /etc/portage/savedconfig/x11-wm/dwm-6.0.h per future modifiche.

root #euse --enable savedconfig

Gli utenti con più monitor dovrebbero abilitare l'USE flag xinerama, indipendentemente dall'utilizzo di Xinerama.

root #euse --enable xinerama

Emerge

Installa x11-wm/dwm:

root #emerge --ask x11-wm/dwm

Configurazione

Basi

The information in this section is probably outdated. You can help the Gentoo community by verifying and updating this section.

Per avviare dwm usa un display manager o il comando startx.

Coloro che sceglieranno di usare startx dovranno creare il seguente file:

FILE ~/.xinitrc
exec dbus-launch --sh-syntax --exit-with-session dwm

File di configurazione principale (dwm.h)

Come detto prima, il principale file di configurazione di dwm è /etc/portage/savedconfig/x11-wm/dwm-6.0. Dopo ogni cambiamento, dwm deve essere ricompilato perche' essi abbiano effetto.

Affinchè l'editor di testo possa mostrare correttamente l'evidenziazione di sintassi del C, crea un symlink usando la stessa estensione usata per i file header di C.

root #ln -s /etc/portage/savedconfig/x11-wm/dwm-6.0 /etc/portage/savedconfig/x11-wm/dwm-6.0.h

O consulta la documentazione dell'editor di testo di tua scelta su come cambiare l'evidenziazione di sintassi utilizzata in un file indipendentemente dalla sua estensione.

Per utilizzare una nuova configurazione dopo aver ricompilato dwm, se sei già in una sessione dwm, esci da dwm (Mod+Shift+Q) e riavvialo.

Settings file (dwmrc)

The default xsession file provided by the Gentoo Ebuild (/etc/X11/Sessions/dwm) provides for a default status box that displays system load and the date/time or whatever shell code the user has inside ~/.dwm/dwmrc. The present mechanism (as of dwm-6.0) for sending text to a status box in the window manager's bar is to use 'xsetroot', as illustrated by the default xsession mentioned above. With a few lines of shell code, one can use this mechanism to send arbitrary text to the status bar (for example, the CPU temperature, the current track on the music player, number of unread emails, etc.)

Funzionalità aggiuntive

dmenu

dmenu è un menu dinamico per X, originalmente creato per dwm.

Installazione

Emerge

Installa dmenu:

root #emerge --ask x11-misc/dmenu
Configurazione

Le opzioni di dmenu possono essere personalizzate usando il file dwm.h, per, ad esempio, mostrare il menu nella parte inferiore dello schermo anzichè quella superiore.

FILE /etc/portage/savedconfig/x11-misc/dmenu-4.9.h
static const char *dmenucmd[] = { "dmenu_run", "-b", "-fn", font, "-nb", normbgcolor, "-nf", normfgcolor, "-sb", selbgcolor, "-sf", selfgcolor, NULL };
Utilizzo

Nella configurazione predefinita, la sequenza Alt + P avvia dmenu.

Ulteriori informazioni sullo status

Per mostrare ulteriori informazioni sullo status con dmenu, si dovrebbe usare x11-apps/xsetroot, che imposta informazioni sotto forma di testo nell'angolo in alto a destra.

In primis, se non è ancora stato installato, installa x11-apps/xsetroot.

Poi, usa uno script o un programma terzo per modificare in automatico le informazioni mostrate nello status di dwm.

root #emerge --ask x11-apps/xsetroot

Conky

Conky, ad esempio, puó mostrare informazioni sul sistema. É preferita l'installazione con l'USE flag -X, dato che solamente informazioni sotto forma di testo possono essere trasmette all'istanza dwm. (Le USE flag da prendere in considerazione sono "-X hddtemp iostats wifi".)

root #emerge --ask app-admin/conky

Un file ~/.config/conky/conky.conf di esempio. Il file di configurazione è diviso in due sezioni: conky.config e conky.text. La sezione conky.config contiene opzioni legate a Conky, mentre la sezione conky.text definisce quali e come l'informazione è mostrata. Per usare Conky sul tuo sistema, potresti dover modificare alcune opzioni nella sezione conky.text, come il percorso alle interfacce network o agli hard disk, che possono variare in base al tuo sistema.

FILE ~/.config/conky/conky.conf
conky.config = {
 
background = no,
format_human_readable = yes,
out_to_console = yes,
temperature_unit = celsius,
total_run_times = 0,
update_interval = 1,
#use_spacer = left,
use_spacer = none,
 
};
 
conky.text = [[
 
M ${memperc}%/${swapperc}% | \
/sda ${diskio sda} /sdb ${diskio sdb} \
/sdc ${diskio sdc} | \
${if_existing /proc/net/route ppp0}P0 U ${upspeed ppp0} D ${downspeed ppp0} |${endif}\
${if_existing /proc/net/route eth0}E0 U ${upspeed eth0} D ${downspeed eth0} |${endif}\
${if_existing /proc/net/route wlan0}W0 U ${upspeed eth0} D ${downspeed eth0}\
${wireless_ap wlan0} ${wireless_link_qual_perc wlan0} ${endif}\
CPU ${hwmon 1 temp 1}F \
/sda ${hddtemp /dev/sda}F \
/sdb ${hddtemp /dev/sdb}F \
     ${time %a, %b %d %Y  %H:%M (%z)}
 
]]
Nota
Se hai già usato Conky, fai attenzione alla nuova sintassi con le parentesi graffe ed i segni uguale.

Aggiungi una nuova linea nel file ~/.xinitrc, di cui abbiamo già parlato prima, prima della riga di avviamento di dwm.

FILE ~/.xinitrc
conky | while read -r; do xsetroot -name "$REPLY"; done &
exec ck-launch-session dbus-launch --sh-syntax --exit-with-session dwm

Script personalizzato

Invece di emergere programmi terzi, puoi creare un semplice loop per mostrare data, ora, meteo ed altre informazioni di sistema.

Per esempio, per mostrare il meteo, data e ora crea uno script in shell, nella directory ~/.scripts/:

FILE ~/.scripts/xsetloop.sh
#!/bin/sh
 
let loop=0
while true; do
	if [[ $loop%300 -eq 0 ]]; then
		weather="$(curl 'https://wttr.in?format=1')"
		let loop=0
	fi
	xsetroot -name " $weather | $(date '+%b %d %a') | $(date '+%H:%M') "
	let loop=$loop+1
	sleep 1
done

Dato che lo script è già di per sè un loop, dobbiamo solo aggiungerlo con xroot nel file ~/.xinitrc.

FILE ~/.xinitrc
. ~/.scripts/xsetloop.sh &
exec ck-launch-session dbus-launch --sh-syntax --exit-with-session dwm

Utilizzo

Tasti e le loro funzioni

Tutti le scorciatoie da tastiera di dwm (o almeno quelle di base) utilizzano un tasto detto MODKEY, definito in dwm.h. Di default il valore di MODKEY è Mod1Mask, che nelle tastiere per PC significa Alt. Nel resto di questo articolo, Mod sarà usato per riferirsi a MODKEY.

Spostare una finestra manualmente

Per spostare una finestra in un'altro desktop virtuale manualmente, tieni premuto Mod and fai click sinistro dovunque tu voglia sulla finestra. Poi, sempre tenendo premuto Mod, clicca sul desktop dove vuoi spostarla.

Scorciatoie di default

Queste scorciatoie sono usate di default in x11-wm/dwm.

Gestione di finestre
  • Mod+1-9 - Mostra il desktop di numero specificato.
  • Mod+Shift+1-9 - Tenendo il mouse sopra una finestra, la sposterà nel desktop specificato.
  • Mod+Shift+0 - Tenendo il mouse sopra una finestra, la sposterà su ogni desktop.
Utilità
  • Mod+Shift+Enter - Apri un terminale
  • Mod+Shift+C - Chiudi una finestra
  • Mod+P - Avvia dmenu
  • Mod+J o Mod+K - Spostati in un'altro terminale.
  • Mod+Enter - Alterna stack e master.
  • Mod+Shift+Q - Esci da dwm.
Cambiare il layout
  • Mod+F - Cambia il layout a floating.
  • Mod+T - Cambia il layout a tiled.

Tasti volume

Attenzione
"..." vuol dire essere incluso in x11-wm/dwm e non alla fine del file.

Aggiungi le seguenti righe al file di configurazione e ri-emergi dwm:

FILE /etc/portage/savedconfig/x11-wm/dwm-6.0
#include <X11/XF86keysym.h>
 
...
 
/* commands */
static const char *upvol[] = { "amixer", "set", "Master", "2+", NULL };
static const char *downvol[] = { "amixer", "set", "Master", "2-", NULL };
 
// for muting/unmuting //
static const char *mute[] = { "amixer", "-q", "set", "Master", "toggle", NULL };
 
// for pulse compatible //
static const char *upvol[] = { "amixer", "-q", "sset", "Master", "1%+", NULL };
static const char *downvol[] = { "amixer", "-q", "sset", "Master", "1%-", NULL };
static const char *mute[] = { "amixer", "-q", "-D", "pulse", "sset", "Master", "toggle", NULL };
 
...
 
static Key keys[] = {
        /* modifier                     key        function        argument */
        { 0,              XF86XK_AudioRaiseVolume, spawn,          {.v = upvol } },
        { 0,              XF86XK_AudioLowerVolume, spawn,          {.v = downvol } },
        { 0,              XF86XK_AudioMute,        spawn,          {.v = mute } },

Personalizzazione

dwm è configurato modificando il suo codice sorgente.

(Se hai dei consigli per la personalizzazione di dwm, puoi modificare questa pagina e aggiungerli!)

Modifiche con patch

Gentoo ha un modo specifico di applicare le patch a dwm. Se le patch sono pronte per essere fuse con il codice sorgente di dwm, esiste una funzione specifica detta eapply_user che puó essere usata durante emerge. Sposta le patch necessarie in uno di questi luoghi:

Patch in /etc/portage/patches/category/application

Inizia creando la seguente directory:

root #mkdir -p /etc/portage/patches/x11-wm/dwm

Copia le patch per dwm e mettile in /etc/portage/patches/x11-wm/dwm/. Assicurati che ogni patch abbia un numero come prefisso. Ad esempio: 01-nome_della_patch.patch. Inoltre, il nome del file deve finire con <cone>.patch o .diff, altrimenti Portage non lo applicherà. Nel seguente esempio presumiamo che la patch si trovi nella home directory dell'utente larry. (/home/larry)

root #cp /home/larry/01-dwm.6.0-xft.patch /etc/portage/patches/x11-wm/dwm/

Adesso basta installare dwm, ed emerge si occuperà dell'applicare le patch.

root #emerge --ask x11-wm/dwm

Mettere le patch in un repository di ebuild configurato con Portage

Creare un repository di ebuild per le patch di dwm può aiutare quando le si vuole condividere, sia con un'altra macchina che pubblicamente.

Copia x11-wm/dwm da /var/dwb/repos/gentoo/ ad un nuovo repository di ebuild, o ad un qualunque repository di ebuild esistente appropriato.

Metti le patch nella directory del repository (in questo esempio, il repository creato per contenere questi file sarà chiamato "dwm_patches"):

root #cp /home/larry/01-dwm-6.0-xft.diff /var/db/repos/dwm_patches/x11-wm/dwm/files/

Apri il file di ebuild, /var/db/repos/dwm_patches/x11-wm/dwm/dwm-6.1.ebuild, in un editor di testo ed elenca le patch nell'array PATCHES per poterle applicare automaticamente:

FILE /var/db/repos/dwm_patches/x11-wm/dwm-6.1.ebuild
PATCHES=( "${FILESDIR}/01-dwm-6.0-xft.diff"
          "${FILESDIR}/02-dwm-6.1-x11.diff"
)

Avvia emerge

root #emerge --ask x11-wm/dwm

Assigning applications to window tags

A user can have their favorite applications start on a different window tag, such as starting MPlayer on window tag number five.

First, know the name of the application recorded by Xorg so dwm can be aware of this window on startup. To find this, start the target application (MPlayer in this example) and then further execute the xprop command (x11-apps/xprop). Click on the MPlayer window and xprop will report Xorg's data on the MPlayer window. Use the second window name identified on the WM_CLASS(STRING) line. Now we have the name of the window dwm needs to be aware of.

Nota
Sometimes an application will have multiple windows of itself and will report one window with capital letters, while the second will have no capital letters. Wildcard characters are allowed within window names.
FILE /etc/portage/savedconfig/x11-wm/dwm-6.0.h
static const Rule rules[] ={
    { "MPlayer",    NULL,       NULL,   1 << 4,     True,        0 },
};

Troubleshooting

Upgrading to dwm-6.0

Upgrading from dwm-5.9 to dwm-6.0 incorporated many changes making the previous config.h a likely problem for compiling dwm-6.0. Likely problems displayed might be compiler error messages "'nmaster' undeclared". To resolve, compile and install dwm-6.0 without using the custom config.h file and then find the default dwm-6.0 config.h file and diff against the old config.h file. (Or, decompress the dwm-6.0 tarball to acquire the default dwm-6.0 config.h file.)

Fix " Permission Denied"

A logind provider, like systemd or elogind, must be running in order to start a X session as non privileged user. If a logind provider is not running and the user issues startx dwm fails to start and message similar to this appears: 

(EE) parse_vt_settings: Cannot open /dev/tty0 (Permission denied)

If this is the case and the system is OpenRC-based, add elogind to boot and start the service:

root #rc-update add elogind boot
root #/etc/init.d/elogind start

for more information, please visit Non root Xorg wiki page.

Remap mod key

If there are conflicts with the default dwm Alt conflicting with other console interface applications, use the Esc while within the console application. The Esc is an immediate usable fall back escape key. Another option, redefine the Mod key to use the keyboard Super (Windows) or other additional keys near the Space.

FILE /etc/portage/savedconfig/x11-wm/dwm-6.0.h
#define MODKEY Mod4Mask         /* Use Super Key */

To assign a second Mod key allowing a user to have a Mod key on both sides of the keyboard, mimic or copy this keys activity to another key on the keyboard. The Microsoft Menu key (or context menu key) on Microsoft keyboards is directly opposite of the Super (Windows). The x11-apps/xmodmap package is required for this. (For reference, the two key's values are: showkey 125/127 and xev 133/135 respectively - on MS NEK4000 keyboard.)

FILE $HOME/.xinitrc
# Top of $HOME/.xinitrc file is a good place for this.
# This reassigns MS NEK4000 right Menu key to simulate DWM Mod4Key as well.
xmodmap -e "keycode 135 = Super_L" # reassign MS Menu Keypress to Super_L
xmodmap -e "remove mod1 = Super_L" # make sure X keeps it out of the mod1 group

Now, a user should have a non-conflicting and easily accessible Mod key on both sides of the keyboard!

Fix Java application misbehaving

Java-based applications are known to misbehave as Java doesn't know the WM being used. This result in GUI of specific Java applications to not work properly. To solve this we need to set the window manager name property of the root window. This can be done using the wmname tool and set it to LG3D.

Install the tool:

root #emerge --ask x11-misc/wmname

and set the property name:

user $wmname LG3D

To make this setting permanent add this command to ~/.xinitrc.

Suggerimento
It is also useful to export AWT_TOOLKIT if some Java applications are using AWT, as noted below.

Blank (grey) windows of Java applications

Java-based applications, such as Apache NetBeans, does not render properly. To mitigate this problem set the AWT_TOOLKIT variable as:

user $AWT_TOOLKIT=MToolkit; export AWT_TOOLKIT

To make the action permanent is is required to add the command to the startup script, for example ~/.xinitrc.

Background not redrawing

Sometimes the background may not properly redraw when the current view is switched. For example, some terminal emulators such as st don't draw the entirety of their allocated window space. In these cases, X root window must have a properly defined color. This can be done with the xsetroot command. For example:

user $xsetroot -solid black
Retrieved from "https://wiki.gentoo.org/index.php?title=Dwm/it&oldid=1355985"