fdpowermon - Online nel cloud

PROGRAMMA:

NOME

fdpowermon - aggiunge un'icona del livello della batteria a un vassoio di sistema compatibile con freedesktop.org

SINOSSI

fdpowermon

DESCRIZIONE

Questo programma consente di visualizzare un'icona "livello batteria" in qualsiasi dispositivo compatibile con freedesktop.org
zona di stato. Può essere tematizzato tramite un file di configurazione di testo normale
(/etc/fdpowermon/theme.cfg or $XDG_CONFIG_DIR/fdpowermon/theme.cfg), o attraverso un breve
script perl (/etc/fdpowermon/theme.pl or $XDG_CONFIG_DIR/fdpowermon/theme.pl). Se
$XDG_CONFIG_DIR non è impostato, $HOME/.config è usato come predefinito.

Il primo è più semplice, in quanto non richiede alcuno scripting; e infatti l'impostazione predefinita
configurazione è un esempio di un tema di testo semplice. Tuttavia, quest'ultimo consente
maggiore flessibilità, in quanto è possibile definire callback che dovrebbero essere eseguite quando il livello della batteria
raggiunge una certa soglia.

I temi, siano essi temi perl o temi di testo semplice, sono costruiti attraverso 'passaggi', che sono
definito in un'unica riga. In un file di configurazione di testo normale, una riga simile ha questo aspetto:

scarica = 2:missing.png:low.png, 10:low.png, 100:full.png

Questo definisce tre passaggi. Il livello più alto mostra "full.png" loading="lazy" quando il livello della batteria è
tra 11% e 100% (incluso); il secondo passaggio mostra "low.png" loading="lazy" quando il livello della batteria
è compreso tra il 3% e il 10% (incluso); e il terzo passaggio si alternerà tra "missing.png"
e "low.png" loading="lazy" a intervalli di tre secondi, quando la batteria è compresa tra 0% e 2%.

Poiché la linea inizia con "scarica", questi passaggi vengono utilizzati quando il sistema è in funzione
a batteria. Una linea di passaggi simile potrebbe essere definita per quando la batteria è
di ricarica:

addebito = 0:empty-ricarica.png, 10:basso-ricarica.png, 100: pieno-ricarica.png

questo mostrerà "empty-charge.png" loading="lazy" quando la batteria è allo 0% (esattamente),
"low-charge.png" loading="lazy" tra l'1% e il 10% (incluso) e "full-charge.png" loading="lazy" all'11% e
sopra.

Nota che l'ordinamento è significativo: i passaggi dovrebbero essere definiti dal basso verso l'alto.

Per completare la configurazione del tema, dobbiamo aggiungere qualche altro elemento:

[mito]
passi = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
addebito = 0:empty-ricarica.png, 10:basso-ricarica.png, 100: pieno-ricarica.png
scarica = 2:missing.png:low.png, 10:low.png, 100:full.png

Questo definisce un tema chiamato "mytheme" che ha tre passaggi e cercherà le immagini in
la directory "/home/wouter/.fdpowermon/mytheme-icons". Non è possibile definire a
tema che ha un numero di passaggi diverso per la fase di ricarica rispetto a quello che ha per la
fase di scarica; se lo desideri, definisci (un) passaggio/i extra per la fase che desideri
vorrebbe avere meno passaggi, che ha la stessa icona del passaggio sopra o sotto.

Nota che l'ordinamento è significativo anche qui; la riga "steps" dovrebbe apparire prima di qualsiasi
linee di "carica" ​​o "scarica" ​​(non era il caso di fdpowermon 1.7 o inferiore).

Se è configurato più di un tema, fdpowermon, per impostazione predefinita, utilizzerà l'ultimo tema
definito nella configurazione per utente, o (se non esiste un file di configurazione per utente) il
ultimo tema definito nella configurazione a livello di sistema.

I file di configurazione del tema Perl possono usare fdpowermon::theme::make_default per modificare il valore predefinito
tema.

PERL API

@avvertenze
L'array @fdpowermon::theme::warnings può essere utilizzato per specificare a quali livelli fdpowermon
dovrebbe emettere un avviso standard. Il valore predefinito è (10, 5, 1), che significa emettere un avviso
a un livello del 10%, 5% e 1%. Si noti che se la batteria si scarica a un ritmo particolarmente veloce
ritmo, il livello potrebbe essersi ridotto ulteriormente rispetto a quello precedente l'emissione dell'avviso;
inoltre, fdpowermon emetterà un avviso immediatamente quando l'alimentazione viene rimossa dalla macchina
e la potenza è al di sotto del primo livello.

Per fare in modo che fdpowermon emetta sempre un avviso quando viene rimossa l'alimentazione, impostalo su qualcosa
come (100, 10, 5, 1). Per fare in modo che fdpowermon emetta avvisi al 20%, 10% e 5%, impostalo su
(20, 10, 5).

Si noti che non è possibile modificare il testo dell'avviso. Se lo desideri, guarda il
fdpowermon::theme::warning sub e usa un evento.

$usa_notifica
La variabile $fdpowermon::theme::use_notify può essere utilizzata per decidere se utilizzare a
messaggio libnotify (se impostato su un valore diverso da zero) o una finestra di dialogo (se impostato su un valore che
valuta zero).

L'impostazione predefinita è utilizzare libnotify se i dati di introspezione di libnotify Glib sono installati, oppure
una finestra di dialogo in caso contrario. Perché le finestre di dialogo possono rubare l'attenzione e quindi provocare il caos
con il lavoro dell'utente, l'uso di libnotify è fortemente raccomandato dall'autore.

Nota che se imposti esplicitamente la variabile su diverso da zero, allora il test se
I dati di introspezione di Glib installati verranno ignorati. Assicurati che sia disponibile in quello
Astuccio!

nuovi
Crea un nuovo tema fdpowermon. Restituisce un riferimento benedetto; per esempio,

il mio $tema = nuovo fdpowermon::theme;

$tema->set_stepcount($count)
Imposta il numero di passaggi nel tema. Nota che un tema fdpowermon deve avere un uguale
numero di passaggi sia nella direzione di "carica" ​​che in quella di "scarica".

Dovrebbe essere chiamato prima di chiamare set_charge, set_discharging o parse_step.

$tema->set_dir($dir)
Imposta la directory di base utilizzata per i nomi dei file di icone.

$tema->set_charge(\@elements)
Imposta le icone che devono essere visualizzate quando la batteria è in carica. L'argomento dovrebbe essere
creato tramite il metodo parse_step.

$tema->set_discharge(\@elementi)
Imposta le icone che dovrebbero essere mostrate quando la batteria si sta scaricando. L'argomento dovrebbe essere
creato tramite il metodo parse_step.

$theme->parse_step($defs)
Analizza la stringa data in qualcosa che può essere passato a set_charge o
set_scaricamento. Le definizioni dovrebbero essere nel formato dei passaggi, descritto sopra, senza
la prima " carica = " o " scarica = ".

Mentre questo metodo restituisce un arrayref che può essere ispezionato e (probabilmente) modificato,
i temi che vogliono essere compatibili con le versioni successive dovrebbero trattarlo come una struttura dati opaca.

$tema->set_event($passo, \&richiama, 'D')
Aggiorna il tema in modo che il sub 'callback' venga eseguito quando stiamo scaricando e raggiungiamo
$step per la prima volta. Per impostare un evento durante la ricarica, invece, passa una 'c' come terza
discussione.

Si noti che i passaggi sono array e quindi sono basati su 0; gli elementi con il numero più basso sono
i gradini di livello più basso.

Quando l'evento si attiva, alla routine di callback verranno passati due argomenti: il primo è
il livello attuale della batteria (in percentuale); il secondo è un numero che indica se il
la batteria si sta attualmente caricando (1) o scaricando (0). Nel caso in cui l'analisi dell'ACPI
il comando fallisce, tuttavia, il secondo argomento potrebbe essere undef; dovresti prepararti per questo
possibilità. Nota che fdpowermon stesso gestisce quel caso assumendo che la batteria sia
ricarica; potresti o non potresti voler fare lo stesso.

$tema->registra ($nome)
Registra un tema con un determinato nome. Se esiste già un tema con quel nome, è
sostituito.

make_default($nome)
Fa in modo che un tema con un determinato nome sia il tema predefinito.

get_theme($nome)
Cerca un tema con il nome dato; per esempio,

my $theme = fdpowermon::theme::get_theme("default");

avviso ($ messaggio)
Produci un avviso, utilizzando libnotify o utilizzando una finestra di dialogo:

fdpowermon::theme::warning($messaggio);

Vedi la documentazione su $fdpowermon::theme::use_notify sopra per i dettagli su cosa
si sceglie l'attuazione.

ESEMPI

Per un esempio completo di tema .cfg, guarda sopra.

Per costruire lo stesso tema completamente da perl, faresti qualcosa del genere:

il mio $tema = nuovo fdpowermon::theme;
$tema->set_stepcount(3);
$theme->set_dir("/home/wouter/.fdpowermon/mytheme-icons");
$theme->set_charging($theme->parse_step("0:empty-charge.png, 10:low-charge.png, 100: full-charging.png"));
$theme->set_discharging($theme->parse_step("2:missing.png:low.png, 10:low.png, 100:full.png"));

(nota, come tema perl, questo andrebbe in theme.pl, non in theme.cfg; vedi sopra per possibile
posizioni per i temi perl)

Tuttavia, a meno che tu non voglia creare il tema in modo dinamico, farlo in questo modo non lo è
consigliato. Invece, creeresti il ​​tema da un file .cfg e possibilmente lo modificheresti
da perla. Supponiamo che desideri aggiungere un evento per sospendere il sistema quando arriva l'alimentazione
basso; in tal caso, faresti qualcosa del genere:

sospensione secondaria {
system("sudo pm-suspend");
}

my $theme = fdpowermon::theme::get_theme("mytheme");
$tema->set_event(0, \&suspend, 'd');

Questo chiamerebbe il sub "sospensione" quando la batteria si sta scaricando e raggiungiamo il livello più basso
passo (nell'esempio sopra, sarebbe quando la batteria raggiunge il 10%; potresti volerlo
fallo un po' più tardi). Questo sottotitolo "sospendi" chiama semplicemente il programma "pm-suspend", con
sudo, per sospendere il sistema.

Usa fdpowermon online usando i servizi onworks.net