Introduzione

Di seguito sono riportate le istruzioni per installare e configurare una sessione di PekWM in Ubuntu e derivate.

PekWM è un windows manager leggero e facilmente personalizzabile, utilizzabile anche in altri ambienti grafici.
Può essere utilizzato anche come ambiente grafico a sé stante, come descritto nella presente guida.

Inoltre è utile sapere che una sessione di base di PekWM:

non prevede la presenza di barre o altri pulsanti sulla Scrivania: per accedere al menu di sistema è sufficiente premere il tasto destro del mouse in un qualsiasi punto vuoto del desktop.
comporta l'installazione di pochi pacchetti e dipendenze: se già presenti altri ambienti grafici, solitamente influisce per nulla o in minima parte sulla stabilità e sull'aspetto estetico di questi ultimi.

Requisiti di sistema

PekWM impiega una quantità limitata di risorse hardware, tanto da funzionare bene in computer molto datati.

Installazione

Installare il pacchetto pekwm.

Completata l'installazione, per avviare la sessione:

Se già si dispone di un ambiente grafico, terminare la sessione corrente e al login selezionare la sessione PekWM .
Se si è su sistema minimale, installare il pacchetto xinit se non presente (per abilitare il server grafico). Successivamente, a seconda delle proprie esigenze:
- Installare un display manager, riavviare il pc ed effettuare il login.
- Digitare da linea di comando:
```
startx
```

Ecco come si presenta il desktop di PekWM:

Configurazione

Applicazioni d'avvio

Recarsi nella cartella nascosta ~/.pekwm nella propria Home (solitamente visualizzabile in un file manager con la combinazione di tasti Ctrl + H).
Aprire con un editor di testo il file start.
Aggiungere in coda al file la riga:
```
 eval applicazione &
```
dove al posto di applicazione inserire il comando da avviare all'avvio.

È possibile aggiunge più applicazioni separandole col carattere &.
Rendere eseguibile il file digitando in un terminale:
```
chmod +x .pekwm/start
```

Modifica del menu

Per aggiungere applicazioni e sottomenu al menu, procedere come segue:

Recarsi nella cartella nascosta ~/.pekwm nella propria Home (solitamente visualizzabile in un file manager con la combinazione di tasti Ctrl + H).
Aprire con un editor di testo il file menu.
Cancellare il contenuto e al suo posto inserire righe come le seguenti:
- Per aggiungere applicazioni richiamabili nella schermata principale del menu:
```
   RootMenu = "Pekwm" {
          Entry = "Terminale" { Actions = "Exec $TERM &" }
          Entry = "Esegui.." { Actions = "ShowCmdDialog" }
```
  La seconda arriva avvia il terminale, la terza avvia la finestra di avvio comandi.
- Per aggiungere sottomenu:
```
   Separator {}

   SubMenu = "Sottomenu" {
           Entry = "Applicazione" { Actions = "Exec applicazione &" }

                    }
```
  sostituendo a Sottomenu il nome del sottomenu, a Applicazione il nome dell'applicazione, a applicazione il comando relativo ad Applicazione.

Per aggiungere icone al menu, seguire i seguenti passaggi:

Creare una cartella nominata icons dentro la cartella nascosta ~/.pekwm nella propria Home (solitamente visualizzabile in un file manager con la combinazione di tasti Ctrl + H).
Inserire al suo interno le icone dei programmi che si vogliono visualizzare.
Aggiungerci le icone che si vogliono visualizzare nel menu.
Aprire con un editor di testo il file menu nella cartella nascosta ~/.pekwm nella propria Home .
Modificare le righe del tipo
```
 Entry = "Applicazione" { Actions = "Exec applicazione &" }
```
in
```
 Entry = "Applicazione" { Icon = "icona_applicazione"; Actions = "Exec applicazione &" }
```
sostituendo a Applicazione il nome dell'applicazione, a applicazione il comando relativo ad Applicazione e a icona_applicazione l'icona da associare contenuta nella cartella icons.

Modificare il tema

Per modificare agevolmente il tema, aggiungere al menu il sottomenu Menu → Temi PekWM:

Submenu = "Temi PekWM" {
        Entry { Actions = "Dynamic $_PEKWM_SCRIPT_PATH/pekwm_themeset.sh $_PEKWM_THEME_PATH" }
        Entry { Actions = "Dynamic $_PEKWM_SCRIPT_PATH/pekwm_themeset.sh ~/.pekwm/themes" }
                }

Per ottenere nuovi temi, seguire uno dei seguenti passaggi:
- Installare il pacchetto pekwm-themes contenente una raccolta di tema.
- Scaricare un tema (ad esempio dal sito Box-Look-org), poi seguire i seguenti passaggi
  1. Decomprimere il file .tar.gz scaricato precedentemente.
  2. Spostare la cartella estratta in /usr/share/pekwm/themes (sarà necessario utilizzare i privilegi di amministrazione).
Per cambiare tema il percorso del menu Temi PekWM → Temi e selezionare il tema desiderato.

Spegnimento del computer

Per aggiungere l'opzione di spegnimento al menu, seguire i seguenti passaggi:

Installare il pacchetto obsession

aggiungere al menu il pulsante:

    Separator {}
 
    Entry = "Arresta PC" { Actions = "Exec obsession-logout &" }
       }