Superkaramba

Versione del 31 mar 2011 alle 13:33 di Skizzhg (discussione | contributi) (traduzione doc)

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.

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

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

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

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.

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

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

path - Path to the image (relative to the config file, absolute location on the filesystem, or a http address).

Examples:

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

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.

x - Horizontal position of the upper left corner.

t - Vertical position of the upper left corner.

w - The width of the label [optional].

h - The height of the label [optional].

value - The text of the label.

align - Sets the alignment of the text. Can be left, center, or right. default: align=left

font - The font to be used.

fontsize - The size of the font.

color - The text's foreground color. Takes three comma separated integers between 0 and 255, inclusive (standard red, green, blue ordering). default: color=0,0,0

example: color=100,200,180.

bgcolor - The color of the shadow. default: bgcolor=0,0,0

shadow - Adds a shadow n pixels from the text. The value can be negative. default: shadow=0 example: shadow=2

fixedpitch - Set this to true to get equally spaced characters. default: fixedpitch=false

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

SENSORS

cpu

The cpu sensor measures the current CPU load. Multiple processors are supported.

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.

default: interval=1000

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

cpu=0 - The first CPU.

cpu=1 - The second CPU.

...

cpu=all - The load of all processors.

default: cpu=all

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

%v - The CPU load.
%load - Same as %v.
%user - The user load.
%system - The system load.
%nice - The nice load.
%idle - The idle load.

default: format="%v"

example: format="CPU load: %v"

disk

Gives information about mounted disks. Network file systems are supported.

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

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

%f - Free disk space in megabytes.
%fp - The percentage of free space.
%u - Used disk space in megabytes.
%up - The percentage of used space.
%t - Total disk space in megabytes.

default: format="%u"

example: format="Free space: %f MB"

example: format="Used space: %up %"

mountpoint - The mounted directory to monitor.

default: mountpoint="/"

example: mountpoint="/mnt/cdrom"

memory

Measures memory and swap values.

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

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

%fm - Free memory in megabytes.
%fmb - Free memory in megabytes (cache and buffers excluded).
%um - Used memory in megabytes.
%umb - Used memory in megabytes (cache and buffers excluded).
%tm - Total memory in megabytes.
%fs - Free swap in megabytes.
%us - Used swap in megabytes.
%ts - Total swap in megabytes.

default: format="%um"

example: format="Free memory: %fm MB"

network

Gives information about the network traffic on a device.

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

device - The network device to use.

default: device="eth0"

example: device="ppp0"

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

%in - Inbound network traffic in kilobytes per second.
%out - Outbound network traffic in kilobytes per second.

default: format="%in"

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

decimals - The number of decimals when measuring network traffic.

default: decimals=0

noatun

Get information from a possible running Noatun process.

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:

%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"

example: 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

  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)