Superkaramba: differenze tra le versioni

Da Guide@Debianizzati.Org.
Vai alla navigazione Vai alla ricerca
(traduzione, parte due)
Riga 79: Riga 79:
Questo definisce la finestra di Karamba; una finestra di grandi dimensioni richiede più tempo per essere disegnata, quindi cercate di non crearla più grande di quanto gli elementi grafici al suo interno necessitino, ovvero evitate una grossa finestra se avete solo del testo in un angolo.  
Questo definisce la finestra di Karamba; una finestra di grandi dimensioni richiede più tempo per essere disegnata, quindi cercate di non crearla più grande di quanto gli elementi grafici al suo interno necessitino, ovvero evitate una grossa finestra se avete solo del testo in un angolo.  


x - posizione orizzontale della finestra di Karamba /
x - posizione orizzontale della finestra di Karamba / default: x=0
default: x=0


y - posizione verticale della finestra di Karamba /
y - posizione verticale della finestra di Karamba / default: y=0
default: y=0


w - larghezza della finestra di Karamba /
w - larghezza della finestra di Karamba / default: w=300
default: w=300


h - altezza della finestra di Karamba /
h - altezza della finestra di Karamba / default: h=300
default: h=300


right - se right è impostato a true, la finestra verrà posizionata sul lato destro dello schermo e il parametro x verrà ignorato. /
right - se right è impostato a true, la finestra verrà posizionata sul lato destro dello schermo e il parametro x verrà ignorato / default: right=false
default: right=false


bottom - se bottom è impostato a true, la finestra verrà posizionata nella parte bassa dello schermo e il parametro y verrà ignorato. /
bottom - se bottom è impostato a true, la finestra verrà posizionata nella parte bassa dello schermo e il parametro y verrà ignorato / default: bottom=false
default: bottom=false


ontop - se ontop è impostato a true, la finestra resterà in primo piano rispetto alle altre. /
ontop - se ontop è impostato a true, la finestra resterà in primo piano rispetto alle altre / default: ontop=false
default: ontop=false


topbar - se topbar è impostato a true, la finestra verrà posizionata nella parte alta dello schermo e le applicazioni massimizzate non la copriranno (come avviene per kicker, il pannello di kde). In questo caso la finestra non può essere spostata. /
topbar - se topbar è impostato a true, la finestra verrà posizionata nella parte alta dello schermo e le applicazioni massimizzate non la copriranno (come avviene per kicker, il pannello di kde). In questo caso la finestra non può essere spostata / default: topbar=false
default: topbar=false


bottombar - se bottombar è impostato a true, la finestra verrà posizionata nella parte bassa dello schermo e le applicazioni massimizzate non la copriranno (come avviene per kicker, il pannello di kde). In questo caso la finestra non può essere spostata. /
bottombar - se bottombar è impostato a true, la finestra verrà posizionata nella parte bassa dello schermo e le applicazioni massimizzate non la copriranno (come avviene per kicker, il pannello di kde). In questo caso la finestra non può essere spostata / default: bottombar=false
default: bottombar=false


interval - la frequenza di aggiornamento dei contatori in millisecondi. /
interval - la frequenza di aggiornamento dei contatori in millisecondi / default: interval=5000
default: interval=5000


locked - se locked è impostato a true, la finestra non può essere spostata con il trascinamento del mouse; questa opzione può essere modificata con il click destro sulla stessa. /
locked - se locked è impostato a true, la finestra non può essere spostata con il trascinamento del mouse; questa opzione può essere modificata con il click destro sulla stessa / default: locked=false
default: locked=false


===contatori===
===Contatori===
====bar====
====bar====


Riga 125: Riga 114:
h - l'altezza della barra [opzionale].
h - l'altezza della barra [opzionale].


path - il percorso dell'immagine per la barra (relativo al file di configurazione, posizione assoluta nel filesystem o un indirizzo http).
path - il percorso dell'immagine per la barra (relativo al file di configurazione, posizione assoluta nel filesystem o un indirizzo http)


vertical - se impostato a true, la barra è verticale: dal basso verso l'alto.
vertical - se impostato a true, la barra è verticale: dal basso verso l'alto / default: vertical=false
default: vertical=false


value - il valore della barra.
value - il valore della barra / default: value=0
default: value=0


min - il valore minimo; può essere sovrascritto da un sensore.
min - il valore minimo; può essere sovrascritto da un sensore / default: min=0
default: min=0


max - il valore massimo; può essere sovrascritto da un sensore.
max - il valore massimo; può essere sovrascritto da un sensore / default: max=100
default: max=100


Esempi:
Esempi:
Riga 145: Riga 130:
====graph====
====graph====


Visualizza un grafico the scorre verso sinistra.
Visualizza un grafico the scorre verso sinistra  


x - posizione orizzontale dell'angolo alto sinistro.
x - posizione orizzontale dell'angolo alto sinistro


y - posizione verticale dell'angolo alto sinistro.
y - posizione verticale dell'angolo alto sinistro


w - la larghezza del grafico [opzionale].
w - la larghezza del grafico [opzionale]


h - l'altezza del grafico [opzionale].
h - l'altezza del grafico [opzionale]


points - il numero dei punti nel grafico.
points - il numero dei punti nel grafico


min - il valore minimo; può essere sovrascritto da un sensore.
min - il valore minimo; può essere sovrascritto da un sensore / default: min=0
default: min=0


max - il valore massimo; può essere sovrascritto da un sensore.
max - il valore massimo; può essere sovrascritto da un sensore / default: max=100
default: max=100


color - il colore del grafico; occorrono tre numeri interi tra 0 e 255 separati da una virgola (rosso, verde, blu).
color - il colore del grafico; occorrono tre numeri interi tra 0 e 255 separati da una virgola (rosso, verde, blu) / default: color=0,0,0
default: color=0,0,0
esempio: color=100,200,180.
esempio: color=100,200,180.


Esempi:
Esempi:
Riga 172: Riga 154:
====image====
====image====


Displays an image at the desired position. The image can be connected to a sensor: the value from the sensor is interpreted as an image path. Images can be grabbed directly from the web. Images with transparency can be used.
Visualizza un'immagine nella posizione desiderata, questa può essere collegata a un sensore: il valore del sensore viene interpretato come un percorso dell'immagine. Le immagini, anche trasparenti, possono essere prese direttamente dal web.


x - Horizontal position of the image's upper left corner.
x - posizione orizzontale dell'angolo alto sinistro dell'immagine


y - Vertical position of the image's upper left corner.
y - posizione verticale dell'angolo alto sinistro dell'immagine


path - Path to the image (relative to the config file, absolute location on the filesystem, or a http address).
path - il percorso dell'immagine (relativo al file di configurazione, posizione assoluta nel filesystem o un indirizzo http)


Examples:
Esempi:
  image x=10 y=10 path="/tmp/pic.png"
  image x=10 y=10 path="/tmp/immagine.png"
  image x=10 y=10 path="http://your-site.se/image.jpg"
  image x=10 y=10 path="http://tuo-sito.se/immagine.jpg"
  image x=10 y=10 sensor=program program="pictures.pl"
  image x=10 y=10 sensor=program program="pictures.pl"


====text====
====text====


Displays a text label at the desired position. You can use the w and h options to define a clipping area: no text will be drawn outside this area. All sensors can be connected to a text meter.
Visualizza un'etichetta di testos nella posizione desiderata. È possibile utilizzare le opzioni «w» e «h» per definire un'area di ritaglio: nessun testo verrà visualizzato al di fuori di quest'area. Tutti i sensori possono essere connessi a un contatore testuale.


x - Horizontal position of the upper left corner.
x - posizione orizzontale dell'angolo alto sinistro


t - Vertical position of the upper left corner.
t - posizione verticale dell'angolo alto sinistro


w - The width of the label [optional].
w - la larghezza dell'etichetta [opzionale]


h - The height of the label [optional].
h - l'altezza dell'etichetta [opzionale]


value - The text of the label.
value - il testo dell'etichetta


align - Sets the alignment of the text. Can be left, center, or right.
align - imposta l'allineamento del testo: left, center o right / default: align=left
default: align=left


font - The font to be used.
font - il carattere da utilizzare


fontsize - The size of the font.
fontsize - la dimensione del carattere


color - The text's foreground color. Takes three comma separated integers between 0 and 255, inclusive (standard red, green, blue ordering).
color - il colore del testo; occorrono tre numeri interi tra 0 e 255 separati da una virgola (rosso, verde, blu) / default: color=0,0,0
default: color=0,0,0
esempio: color=100,200,180.
example: color=100,200,180.


bgcolor - The color of the shadow.
bgcolor - il colore dell'ombra / default: bgcolor=0,0,0
default: bgcolor=0,0,0


shadow - Adds a shadow n pixels from the text. The value can be negative.
shadow - applica un'ombra di «n» pixel dal testo, il valore può essere negativo / default: shadow=0
default: shadow=0
esempio: shadow=2
example: shadow=2


fixedpitch - Set this to true to get equally spaced characters.
fixedpitch - impostare a «true» per ottenere i caratteri equidistanti / default: fixedpitch=false
default: fixedpitch=false


Examples:
Esempi:
text x=0 y=0 value="test string"
text x=0 y=0 value="stringa di testo"
text x=0 y=0 sensor=cpu color=255,0,0 font="arial" sensor=cpu
text x=0 y=0 sensor=cpu color=255,0,0 font="arial" sensor=cpu


===SENSORS===
===Sensori===
====cpu====
====cpu====


The cpu sensor measures the current CPU load. Multiple processors are supported.
Misura l'attuale carico della CPU, sono gestibili più processori.


interval - The update interval in milliseconds. The first specified interval parameter will be used for subsequent CPUs, although each CPU may still have it's own interval parameter.
interval - l'intervallo di aggiornamento in millisecondi. Il primo parametro specificato verrà utilizzato per ulteriori CPU, sebbene ognuna possa avere un proprio intervallo / default: interval=1000


default: interval=1000
cpu - l'indice della CPU, utile solo se si ha più di un processore


cpu - The index of the CPU. The is only useful if you have more than one processor.
cpu=0 - la prima CPU


cpu=0 - The first CPU.
cpu=1 - la seconda CPU
 
cpu=1 - The second CPU.


...
...


cpu=all - The load of all processors.
cpu=all - il carico di tutti i processori


default: cpu=all
default: cpu=all


format - The specification of the displayed text. Possible values are:
format - le specifiche del testo visualizzato; i valori possibili sono:
  %v - The CPU load.
  %v - il carico della CPU,
  %load - Same as %v.
  %load - come %v,
  %user - The user load.
  %user - il carico dell'utente,
  %system - The system load.
  %system - il carico di sistema,
  %nice - The nice load.
  %nice - il carico secondo il parametro nice,
  %idle - The idle load.
  %idle - il carico secondo il parametro idle.
 
default: format="%v"
default: format="%v"


Riga 259: Riga 233:
====disk====
====disk====


Gives information about mounted disks. Network file systems are supported.
Fornisce informazioni sui dischi montati, sono gestibili filesystem di rete.
 
interval - The update interval in milliseconds. The first specified interval parameter will be used for subsequent disk sensors, although each sensor may still have it's own interval parameter.


default: interval=5000
interval - l'intervallo di aggiornamento in millisecondi. Il primo parametro specificato verrà utilizzato per ulteriori sensori di disco, sebbene ognuno possa avere un proprio intervallo / default: interval=5000


format - The specification of the displayed text. Possible values are:
format - le specifiche del testo visualizzato; i valori possibili sono:
  %f - Free disk space in megabytes.
  %f - spazio libero su disco in megabyte,
  %fp - The percentage of free space.
  %fp - la percentuale dello spazio libero,
  %u - Used disk space in megabytes.
  %u - spazio usato su disco in megabyte,
  %up - The percentage of used space.
  %up - la percentuale dello spazio usato,
  %t - Total disk space in megabytes.
  %t - spazio complessivo su disco in megabyte.
default: format="%u"
default: format="%u"


example: format="Free space: %f MB"
esempio: format="Spazio libero: %f MB"
 
example: format="Used space: %up %"


mountpoint - The mounted directory to monitor.
esempio: format="Spazio usato: %up %"


default: mountpoint="/"
mountpoint - la directory montata da monitorare / default: mountpoint="/"


example: mountpoint="/mnt/cdrom"
esempio: mountpoint="/mnt/cdrom"


====memory====
====memory====


Measures memory and swap values.
Misura i valori di memoria e swap.
 
interval - The update interval in milliseconds. The first specified interval parameter will be used for subsequent memory sensors, although each sensor may still have it's own interval parameter.


default: interval=3000
interval - l'intervallo di aggiornamento in millisecondi. Il primo parametro specificato verrà utilizzato per ulteriori sensori di memoria, sebbene ognuno possa avere un proprio intervallo / default: interval=3000


format - The specification of the displayed text. Possible values are:
format - le specifiche del testo visualizzato; i valori possibili sono:
  %fm - Free memory in megabytes.
  %fm - memoria libera in megabyte,
  %fmb - Free memory in megabytes (cache and buffers excluded).
  %fmb - memoria libera in megabyte (esclusi cache e buffer),
  %um - Used memory in megabytes.
  %um - memoria usata in megabyte,
  %umb - Used memory in megabytes (cache and buffers excluded).
  %umb - memoria usata in megabyte (esclusi cache e buffer),
  %tm - Total memory in megabytes.
  %tm - memoria totale in megabyte,
  %fs - Free swap in megabytes.
  %fs - swap libera in megabyte,
  %us - Used swap in megabytes.
  %us - swap usata in megabyte,
  %ts - Total swap in megabytes.
  %ts - swap complessiva in megabyte.
default: format="%um"
default: format="%um"


example: format="Free memory: %fm MB"
esempio: format="Memoria libera: %fm MB"


====network====
====network====


Gives information about the network traffic on a device.
Fornisce informazioni sul traffico di rete di una periferica.
 
interval - The update interval in milliseconds. The first specified interval parameter will be used for subsequent network sensors, although each sensor may still have it's own interval parameter.


default: interval=2500
interval - l'intervallo di aggiornamento in millisecondi. Il primo parametro specificato verrà utilizzato per ulteriori sensori di rete, sebbene ognuno possa avere un proprio intervallo / default: interval=2500


device - The network device to use.
device - la periferica di rete da utilizzare / default: device="eth0"


default: device="eth0"
esempio: device="ppp0"


example: device="ppp0"
format - le specifiche del testo visualizzato; i valori possibili sono:
 
  %in - traffico in entrata in kilobytes per secondo,
format - The specification of the displayed text. Possible values are:
  %out - traffico in uscita in kilobytes per secondo.
  %in - Inbound network traffic in kilobytes per second.
  %out - Outbound network traffic in kilobytes per second.
default: format="%in"
default: format="%in"


example: format="Incoming trafic: %in kB/s"
esempio: format="Traffico in entrata: %in kB/s"


decimals - The number of decimals when measuring network traffic.
decimals - il numero di decimali da utilizzare quando si misura il traffico di rete / default: decimals=0
 
default: decimals=0


====noatun====
====noatun====


Get information from a possible running Noatun process.
Ottiene informazioni da un possibile processo Noatun in esecuzione.
 
interval - The update interval in milliseconds. The first specified interval parameter will be used for subsequent noatun sensors, although each sensor may still have it's own interval parameter.
 
default: interval=1000


format - The specification of the displayed text. Possible values are:
interval - l'intervallo di aggiornamento in millisecondi. Il primo parametro specificato verrà utilizzato per ulteriori sensori noatun, sebbene ognuno possa avere un proprio intervallo / default: interval=1000
%id - The noatun dcop name. Can be useful when connecting to a clickarea
(refer to the first example for usage of this).
%title - Title of the current song
%time - Time of the current song
%remain - Remaining time of the current song
%length - Length of the current song
%full - Sensor returns MAX if Noatun is started, else 0. %full is useful when
connecting the sensor to a bar, the image will be shown only if Noatun is running.


default: format="%title %time / %total"
format - le specifiche del testo visualizzato; i valori possibili sono:
%id - il nome dcop di noatun, può essere utile connettendosi a una clickarea (WTF?)
(per utilizzarlo fare riferimento al primo esempio),
%title - titolo del brano in corso,
%time - tempo del brano in corso,
%remain - tempo rimanente del brano in corso,
%length - lunghezza del brano in corso,
%full - se Noatun è avviato il sensore restituisce «MAX», altrimenti «0»; utile connettendo il sensore ad una barra, l'immagine verrà mostrata solo se Noatun è in esecuzione / default: format="%title %time / %total"


example: onclick="dcop %v Noatun play" sensor=noatun format="%id"
esempio: onclick="dcop %v Noatun play" sensor=noatun format="%id"


====program====
====program====

Versione delle 13:42, 5 apr 2011

Template:Sommario

Superkaramba

Introduzione

Come precedentemente indicato:

[Articolo e-zine]

[Superkaramba] è, in termini semplici, uno strumento che ti permette di creare facilmente eye-candy interattivi sul tuo desktop KDE. Attualmente, solo su linux è ufficialmente supportato.

SuperKaramba è uno strumento basato su karamba che permette a chiunque di creare e gestire facilmente piccoli widget interattivi su un desktop KDE. I widget sono definiti in un semplice file di testo che può essere aumentato con codice Python per renderli interattivi. Qui sono solo alcuni esempi di ciò che si può fare:

   * mostra le informazioni di sistema come CPU, la riproduzione di MP3, ecc;
   * crea barre degli strumenti personalizzate che lavorano in ogni modo immaginabile;
   * creazione di piccoli giochi virtuali o animali che vivono sul tuo desktop;
   * mostra le informazioni da Internet, come il meteo e headlines;

Questo pacchetto è parte di KDE, come una componente del modulo KDE utilità.

Come consigliato nel sito ufficiale, per poter scaricare nuovi temi dovete andare a cercarli su kde-look.org, qui potrete trovare di tutto, dalle GUI per visualizzare le risorse alle dock-bar.

Installare Superkaramba

KDE3

# apt-get install superkaramba

KDE4

# apt-get install plasma-scriptengine-superkaramba

Utilizzo

Eseguire il comando

$ superkaramba

La finestra che si aprirà vi mostrerà diverse opzioni, tra queste vi è la possibilità di scaricare diversi oggetti da Kde.look, oppure aprire un tema scaricato o avviare un tema già caricato in superkaramaba ma non attivo.

Karamba003.jpeg

Consiglio di disabilitare la tray icon di superkaramba che reputo inutile.

Con un click del pulsante destro all'interno di un plasmoide di superkaramba si aprirà il menu delle opzioni

Karamba001.jpeg

da qui sarà possibile accedere al menù di superkaramba.

Karamba002.jpeg

Modifiche al tema

Con molta probabiltà alcune cose non funzioneranno a dovere al primo avvio di un tema.

Il fatto è dovuto alla non corretta configurazione dei parametri, infatti questi non vengono riconosciuti in automatico e sono legati a quanto scritto e testato dell'editore del tema.

I problemi più comuni sono legati alla scheda di rete (eth0 al posto di eth1 o altro), oppure al riconoscimento degli HD e delle partizioni montate che non hanno la stessa ubicazione e/o nome diverso(hda,sda,....), in questo caso occorre editare il file .theme.

Usate l'editor di testo che preferite e applicate le modifiche dovute, al salvataggio del file il tema si aggiornerà automaticamente.

Dipendenze importanti

Per poter visualizzare correttamente gli output karamba necessita di alcuni software a cui si appoggia.

Ecco un breve elenco degli indispensabili:

  • hddtemp
  • smartmoontol
  • sensors

Per le temperature delle GPU pare che solo i driver propietari di ATI e NVidia diano risultati.

Documentazione

Karamba Docs

Superkaramba Docs

karamba

Questo definisce la finestra di Karamba; una finestra di grandi dimensioni richiede più tempo per essere disegnata, quindi cercate di non crearla più grande di quanto gli elementi grafici al suo interno necessitino, ovvero evitate una grossa finestra se avete solo del testo in un angolo.

x - posizione orizzontale della finestra di Karamba / default: x=0

y - posizione verticale della finestra di Karamba / default: y=0

w - larghezza della finestra di Karamba / default: w=300

h - altezza della finestra di Karamba / default: h=300

right - se right è impostato a true, la finestra verrà posizionata sul lato destro dello schermo e il parametro x verrà ignorato / default: right=false

bottom - se bottom è impostato a true, la finestra verrà posizionata nella parte bassa dello schermo e il parametro y verrà ignorato / default: bottom=false

ontop - se ontop è impostato a true, la finestra resterà in primo piano rispetto alle altre / default: ontop=false

topbar - se topbar è impostato a true, la finestra verrà posizionata nella parte alta dello schermo e le applicazioni massimizzate non la copriranno (come avviene per kicker, il pannello di kde). In questo caso la finestra non può essere spostata / default: topbar=false

bottombar - se bottombar è impostato a true, la finestra verrà posizionata nella parte bassa dello schermo e le applicazioni massimizzate non la copriranno (come avviene per kicker, il pannello di kde). In questo caso la finestra non può essere spostata / default: bottombar=false

interval - la frequenza di aggiornamento dei contatori in millisecondi / default: interval=5000

locked - se locked è impostato a true, la finestra non può essere spostata con il trascinamento del mouse; questa opzione può essere modificata con il click destro sulla stessa / default: locked=false

Contatori

bar

Visualizza una barra, come una barra di avanzamento, nella posizione desiderata; è disegnata usando l'immagine fornita dall'opzione «path» e possono essere utilizzare immagini trasparenti. Se le opzioni «w» e «h» non sono specificate, la dimensione della barra è uguale a quella dell'immagine. Il default è di avere un avanzamento da sinistra verso destra ma è possibile ottenrne una verticale (dal basso verso l'alto) con l'opzione «vertical».

x - posizione orizzontale dell'angolo alto sinistro.

y - posizione verticale dell'angolo alto sinistro.

w - la larghezza della barra [opzionale].

h - l'altezza della barra [opzionale].

path - il percorso dell'immagine per la barra (relativo al file di configurazione, posizione assoluta nel filesystem o un indirizzo http)

vertical - se impostato a true, la barra è verticale: dal basso verso l'alto / default: vertical=false

value - il valore della barra / default: value=0

min - il valore minimo; può essere sovrascritto da un sensore / default: min=0

max - il valore massimo; può essere sovrascritto da un sensore / default: max=100

Esempi:

bar x=0 y=0 w=10 h=200 vertical=true path="img.png" sensor=cpu
bar x=0 y=0 path="img.png" min=30 max=60 sensor=cpu

graph

Visualizza un grafico the scorre verso sinistra

x - posizione orizzontale dell'angolo alto sinistro

y - posizione verticale dell'angolo alto sinistro

w - la larghezza del grafico [opzionale]

h - l'altezza del grafico [opzionale]

points - il numero dei punti nel grafico

min - il valore minimo; può essere sovrascritto da un sensore / default: min=0

max - il valore massimo; può essere sovrascritto da un sensore / default: max=100

color - il colore del grafico; occorrono tre numeri interi tra 0 e 255 separati da una virgola (rosso, verde, blu) / default: color=0,0,0 esempio: color=100,200,180.

Esempi:

graph x=0 y=0 w=200 h=60 points=100 sensor=cpu

image

Visualizza un'immagine nella posizione desiderata, questa può essere collegata a un sensore: il valore del sensore viene interpretato come un percorso dell'immagine. Le immagini, anche trasparenti, possono essere prese direttamente dal web.

x - posizione orizzontale dell'angolo alto sinistro dell'immagine

y - posizione verticale dell'angolo alto sinistro dell'immagine

path - il percorso dell'immagine (relativo al file di configurazione, posizione assoluta nel filesystem o un indirizzo http)

Esempi:

image x=10 y=10 path="/tmp/immagine.png"
image x=10 y=10 path="immagine.jpg"
image x=10 y=10 sensor=program program="pictures.pl"

text

Visualizza un'etichetta di testos nella posizione desiderata. È possibile utilizzare le opzioni «w» e «h» per definire un'area di ritaglio: nessun testo verrà visualizzato al di fuori di quest'area. Tutti i sensori possono essere connessi a un contatore testuale.

x - posizione orizzontale dell'angolo alto sinistro

t - posizione verticale dell'angolo alto sinistro

w - la larghezza dell'etichetta [opzionale]

h - l'altezza dell'etichetta [opzionale]

value - il testo dell'etichetta

align - imposta l'allineamento del testo: left, center o right / default: align=left

font - il carattere da utilizzare

fontsize - la dimensione del carattere

color - il colore del testo; occorrono tre numeri interi tra 0 e 255 separati da una virgola (rosso, verde, blu) / default: color=0,0,0 esempio: color=100,200,180.

bgcolor - il colore dell'ombra / default: bgcolor=0,0,0

shadow - applica un'ombra di «n» pixel dal testo, il valore può essere negativo / default: shadow=0 esempio: shadow=2

fixedpitch - impostare a «true» per ottenere i caratteri equidistanti / default: fixedpitch=false

Esempi: text x=0 y=0 value="stringa di testo" text x=0 y=0 sensor=cpu color=255,0,0 font="arial" sensor=cpu

Sensori

cpu

Misura l'attuale carico della CPU, sono gestibili più processori.

interval - l'intervallo di aggiornamento in millisecondi. Il primo parametro specificato verrà utilizzato per ulteriori CPU, sebbene ognuna possa avere un proprio intervallo / default: interval=1000

cpu - l'indice della CPU, utile solo se si ha più di un processore

cpu=0 - la prima CPU

cpu=1 - la seconda CPU

...

cpu=all - il carico di tutti i processori

default: cpu=all

format - le specifiche del testo visualizzato; i valori possibili sono:

%v - il carico della CPU,
%load - come %v,
%user - il carico dell'utente,
%system - il carico di sistema,
%nice - il carico secondo il parametro nice,
%idle - il carico secondo il parametro idle.

default: format="%v"

esempio: cpu=0 format="%user%"

disk

Fornisce informazioni sui dischi montati, sono gestibili filesystem di rete.

interval - l'intervallo di aggiornamento in millisecondi. Il primo parametro specificato verrà utilizzato per ulteriori sensori di disco, sebbene ognuno possa avere un proprio intervallo / default: interval=5000

format - le specifiche del testo visualizzato; i valori possibili sono:

%f - spazio libero su disco in megabyte,
%fp - la percentuale dello spazio libero,
%u - spazio usato su disco in megabyte,
%up - la percentuale dello spazio usato,
%t - spazio complessivo su disco in megabyte.

default: format="%u"

esempio: format="Spazio libero: %f MB"

esempio: format="Spazio usato: %up %"

mountpoint - la directory montata da monitorare / default: mountpoint="/"

esempio: mountpoint="/mnt/cdrom"

memory

Misura i valori di memoria e swap.

interval - l'intervallo di aggiornamento in millisecondi. Il primo parametro specificato verrà utilizzato per ulteriori sensori di memoria, sebbene ognuno possa avere un proprio intervallo / default: interval=3000

format - le specifiche del testo visualizzato; i valori possibili sono:

%fm - memoria libera in megabyte,
%fmb - memoria libera in megabyte (esclusi cache e buffer),
%um - memoria usata in megabyte,
%umb - memoria usata in megabyte (esclusi cache e buffer),
%tm - memoria totale in megabyte,
%fs - swap libera in megabyte,
%us - swap usata in megabyte,
%ts - swap complessiva in megabyte.

default: format="%um"

esempio: format="Memoria libera: %fm MB"

network

Fornisce informazioni sul traffico di rete di una periferica.

interval - l'intervallo di aggiornamento in millisecondi. Il primo parametro specificato verrà utilizzato per ulteriori sensori di rete, sebbene ognuno possa avere un proprio intervallo / default: interval=2500

device - la periferica di rete da utilizzare / default: device="eth0"

esempio: device="ppp0"

format - le specifiche del testo visualizzato; i valori possibili sono:

%in - traffico in entrata in kilobytes per secondo,
%out - traffico in uscita in kilobytes per secondo.

default: format="%in"

esempio: format="Traffico in entrata: %in kB/s"

decimals - il numero di decimali da utilizzare quando si misura il traffico di rete / default: decimals=0

noatun

Ottiene informazioni da un possibile processo Noatun in esecuzione.

interval - l'intervallo di aggiornamento in millisecondi. Il primo parametro specificato verrà utilizzato per ulteriori sensori noatun, sebbene ognuno possa avere un proprio intervallo / default: interval=1000

format - le specifiche del testo visualizzato; i valori possibili sono:

%id - il nome dcop di noatun, può essere utile connettendosi a una clickarea (WTF?)
(per utilizzarlo fare riferimento al primo esempio),
%title - titolo del brano in corso,
%time - tempo del brano in corso,
%remain - tempo rimanente del brano in corso,
%length - lunghezza del brano in corso,
%full - se Noatun è avviato il sensore restituisce «MAX», altrimenti «0»; utile connettendo il sensore ad una barra, l'immagine verrà mostrata solo se Noatun è in esecuzione / default: format="%title %time / %total"

esempio: onclick="dcop %v Noatun play" sensor=noatun format="%id"

program

Used to run a program and connect the output to a meter.

interval - The update interval in milliseconds. The first specified interval parameter will be used for subsequent program sensors with an identical program parameter (including parameters), although each sensor may still have it's own interval parameter.

default: interval=3600000

program - The program that you want to run.

example: program="ftpwho -v"

encoding - This parameter will let you display text with, for example., Russian characters. The parameter value is the name of the encoding. A list of encodings can be found here: QTextCodec Class Reference. The first specified encoding parameter will be used for subsequent program sensors with an identical program parameter (including parameters), although each sensor may still have it's own encoding parameter.

default: encoding="" - Your locale is used.

example: encoding="KOI8-R"

example: encoding="ISO8859-6"

line - Use line if you only want a single line of the file.

line=1 - The first line of the file.

line=2 - The second line of the file.

...

line=-1 - The last line of the file.

line=-2 - The second last line of the file.

...

sensor

The sensor sensor uses the "sensors" program to measure CPU temperature, fan speeds, voltages, and more. The "sensors" program is required to get this sensor to work.

interval - The update interval in milliseconds. The first specified interval parameter will be used for subsequent time sensors, although each sensor may still have it's own interval parameter.

default: interval=30000

format - The specification of the displayed text. Possible values are:

%v - The value of the sensor.

default: format="%v"

example: format="Fanspeed: %v"

type - Which meter in the "sensors" program to monitor. Run the "sensors" program to list the available meters.

default: type="temp2"

example: type="fan1"

textfile

Reads a text file repeatedly.

interval - The update interval in milliseconds. The first specified interval parameter will be used for subsequent textfile sensors with an identical path parameter, although each sensor may still have it's own interval parameter.

default: interval=60000

path - The path to the textfile

example: path="/home/user/file.txt"

encoding - Using this parameter will let you display text with, for example., Russian characters. The parameter value is the name of the encoding. A list of encodings can be found here: QTextCodec Class Reference. The first specified encoding parameter will be used for subsequent textfile sensors with an identical path parameter, although each sensor may still have it's own encoding parameter.

default: encoding="" - Your locale is used.

example: encoding="KOI8-R"

example: encoding="ISO8859-6"

line - Use line if you only want a single line of the file.

line=1 - The first line of the file.

line=2 - The second line of the file.

...

line=-1 - The last line of the file.

line=-2 - The second last line of the file.

...

rdf - Set rdf=true if the texfile is a RDF/RSS file.

default: rdf=false

time

Returns the current time and/or date.

interval - The update interval in milliseconds. The first specified interval parameter will be used for subsequent time sensors, although each sensor may still have it's own interval parameter.

default: interval=60000

format - The specification of the displayed text. Possible values are:

d - the day as number without a leading zero (1-31).
dd - the day as number with a leading zero (01-31).
ddd - the abbreviated localized day name (e.g. 'Mon'..'Sun').
dddd - the long localized day name (e.g. 'Monday'..'Sunday').
M - the month as number without a leading zero (1-12).
MM - the month as number with a leading zero (01-12).
MMM - the abbreviated localized month name (e.g. 'Jan'..'Dec').
MMMM - the long localized month name (e.g. 'January'..'December').
yy - the year as two digit number (00-99).
yyyy - the year as four digit number (1752-8000).
h - the hour without a leading zero (0..23 or 1..12 if AM/PM display).
hh - the hour with a leading zero (00..23 or 01..12 if AM/PM display).
m - the minute without a leading zero (0..59).
mm - the minute with a leading zero (00..59).
s - the second without a leading zero (0..59).
ss - the second with a leading zero (00..59).
z - the milliseconds without leading zeroes (0..999).
zzz - the milliseconds with leading zeroes (000..999).
AP - use AM/PM display. AP will be replaced by either "AM" or "PM".
ap - use am/pm display. ap will be replaced by either "am" or "pm".

Example format strings (assumed that the QDateTime is 21 May 2001 14:13:09):

format="dd.MM.yyyy" -> 21.05.2001
format="ddd MMMM d yy" -> Tue May 21 01
format="hh:mm:ss.zzz" -> 14:13:09.042
format="h:m:s ap" -> 2:13:9 pm

uptime

Returns the current time and/or date.

interval - The update interval in milliseconds. The first specified interval parameter will be used for subsequent time sensors, although each sensor may still have it's own interval parameter.

default: interval=60000

format - The specification of the displayed text. Possible values are:

%d - Days.
%h - Hours.
%m - Minutes.
%s - Seconds.
%H - Hours with possible leading zero.
%M - Minutes with possible leading zero.
%S - Seconds with possible leading zero.

default: format="%dd %h:%M"

xmms

Get information from a possible running XMMS process.

interval - The update interval in milliseconds. The first specified interval parameter will be used for subsequent xmms sensors, although each sensor may still have it's own interval parameter.

default: interval=1000

Tips

Warning.png ATTENZIONE

La funzione interval, che spesso se non indicata specificatamente impone tempi molto brevi di default nella sincronizzazione dei dati.

Su alcuni dati di scarsa utilità usare dei tempi lunghi, sempre espressi in millisecondi in modo da risparmiare risorse.



Il consumo della CPU nell'esecuzione di superkaramba dipende molto da questi tempi, si consiglia perciò di dilatare i tempi di esecuzione di ciò che si ritiene poco utile, come ad esempio il priprio IP locale che difficilmente cambierà, ha un tempo di default di 2500.

Per il resto seguite le vostre esigenze, sapendo ora che più breve sarà il tempo di aggiornamento del sensore, maggiore sarà il consumo di CPU.

Miscellaneous

clickarea

Defines a clickable area. Click in the area and the specified proram is executed. A double click is required if the window is not locked. The clickarea is used as a meter, i.e., sensors can be connected.

x - Horizontal position of the area's upper left corner.

y - Vertical position of the area's upper left corner.

w - The width of the clickarea.

h - The height of the clickarea.

preview - If preview=true, a rectangle will shown around the area.

onclick - The program that will be run when the area is clicked.

%v will be replaced with a possible sensor value.

Example:

clickarea x=0 y=0 w=100 h=10 onclick="kdialog --msgbox 'CPU load: %v'" sensor=cpu

defaultfont

The purpose of the defaultfont is to reduce the amount of parameters when using the text tag. Text labels after a defaultfont tag, in the theme file, will use the default parameters if the label has unspecified parameters.

The default is ignored if the text label has its own values. You don't need to specify all font parameters. Multiple defaultfont tags are allowed. Any previous defaults will be deleted.

Example:

defaultfont shadow=2 color=255,0,0
text x=0 y=0 value="test"
defaultfont font="times" fontsize=10 color=255,0,0
text x=0 y=40 value="test" font="arial"
text x=0 y=80 value="test" color=0,0,0

<group>, </group>

Items can be grouped together with the group tag. This will make it easier to move several items and at the same time keep the distances to each other. It is possible to have groups in groups.

x - Horizontal position of the group's upper left corner.

y - Vertical position of the group's upper left corner.

Example:

<group> x=20 y=20
text x=0 y=0 value="test1"
text x=10 y=10 value="test2"
</group> x=20 y=20

theme

Themes can be loaded from inside a theme using the theme tag. It is possible to create a theme that only loads other themes.

path - The path to the desired theme file.

example: theme path=noatun.theme

--Mm-barabba 16:22, 16 gen 2011 (CET)