fdpowermon - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

fdpowermon - füge ein Batteriestandssymbol zu einer freedesktop.org-kompatiblen Taskleiste hinzu

ZUSAMMENFASSUNG

fdpowermon

BESCHREIBUNG

Dieses Programm ermöglicht es einem, ein "Batteriestand"-Symbol in jedem freedesktop.org-kompatiblen anzuzeigen
Statusbereich. Es kann entweder über eine Klartext-Konfigurationsdatei thematisiert werden
(/etc/fdpowermon/theme.cfg or $XDG_CONFIG_DIR/fdpowermon/theme.cfg) oder durch eine kurze
Perl-Skript (/etc/fdpowermon/theme.pl or $XDG_CONFIG_DIR/fdpowermon/theme.pl). Wenn
$XDG_CONFIG_DIR ist nicht gesetzt, $HOME/.config wird standardmäßig verwendet.

Ersteres ist einfacher, da keine Skripterstellung erforderlich ist; und in der Tat die Standardeinstellung
Konfiguration ist ein Beispiel für ein solches Klartext-Theme. Letzteres ermöglicht jedoch
mehr Flexibilität, da man Rückrufe definieren kann, die bei Akkustand ausgeführt werden sollen
eine bestimmte Schwelle erreicht.

Themes, egal ob Perl-Themes oder Nur-Text-Themes, werden in "Schritten" erstellt, die
in einer Zeile definiert. In einer Klartext-Konfigurationsdatei sieht eine solche Zeile wie folgt aus:

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

Dies definiert drei Schritte. Die höchste Stufe zeigt "full.png" loading="lazy" wenn der Akkustand ist
zwischen 11 % und 100 % (einschließlich); der zweite Schritt zeigt "low.png" loading="lazy" wenn der Akkustand
zwischen 3% und 10% (einschließlich) liegt; und der dritte Schritt wechselt zwischen "missing.png"
und "low.png" loading="lazy" in 0-Sekunden-Intervallen, wenn die Batterie zwischen 2% und XNUMX% ist.

Da die Linie mit "Entladen" beginnt, werden diese Schritte bei laufendem System verwendet
auf Batterieleistung. Eine ähnliche Abfolge von Schritten könnte definiert werden, wenn die Batterie
Aufladung:

loading = 0:empty-charging.png, 10:low-charging.png, 100: full-charging.png

dies zeigt "empty-charging.png" loading="lazy" wenn der Akku bei 0% (genau) ist,
"low-charging.png" loading="lazy" zwischen 1% und 10% (einschließlich) und "full-charging.png" loading="lazy" bei 11% und
zu teilen.

Beachten Sie, dass die Reihenfolge wichtig ist: Schritte sollten von niedrig nach hoch definiert werden.

Um die Theme-Konfiguration abzuschließen, müssen wir noch einige weitere Elemente hinzufügen:

[mein Thema]
Schritte = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
loading = 0:empty-charging.png, 10:low-charging.png, 100: full-charging.png
Entladen = 2:missing.png:low.png, 10:low.png, 100:full.png

Dies definiert ein Thema namens "mytheme", das drei Schritte umfasst und nach Bildern in sucht
das Verzeichnis "/home/wouter/.fdpowermon/mytheme-icons". Es ist nicht möglich, a . zu definieren
Thema, das eine andere Anzahl von Schritten für die Ladephase hat als für die
Entladephase; Wenn Sie das möchten, definieren Sie einfach (einen) zusätzliche(n) Schritt(e) für die Phase, die Sie
möchte weniger Schritte haben, die das gleiche Symbol wie der Schritt darüber oder darunter haben.

Beachten Sie, dass auch hier die Reihenfolge wichtig ist; die Zeile "Schritte" sollte vor allen erscheinen
"Laden" oder "Entladen" Leitungen (dies war in fdpowermon 1.7 oder niedriger nicht der Fall).

Wenn mehr als ein Theme konfiguriert ist, verwendet fdpowermon standardmäßig das letzte Theme
in der benutzerspezifischen Konfiguration definiert, oder (wenn keine benutzerspezifische Konfigurationsdatei vorhanden ist) die
letztes Thema, das in der systemweiten Konfiguration definiert wurde.

Perl-Theme-Konfigurationsdateien können fdpowermon::theme::make_default verwenden, um den Standard zu ändern
Thema.

PERL API

@warnungen
Das @fdpowermon::theme::warnings-Array kann verwendet werden, um anzugeben, auf welchen Ebenen fdpowermon
sollte eine Standardwarnung ausgeben. Der Standardwert ist (10, 5, 1), was bedeutet, dass eine Warnung ausgegeben wird
auf einem Niveau von 10 %, 5 % und 1 %. Beachten Sie, dass wenn der Akku besonders schnell leer wird
Tempo, das Niveau kann sich noch weiter verringert haben als vor der Warnung;
Außerdem gibt fdpowermon sofort eine Warnung aus, wenn die Stromversorgung des Geräts unterbrochen wird
und die Leistung liegt unter der ersten Stufe.

Damit fdpowermon immer eine Warnung ausgibt, wenn die Stromversorgung unterbrochen wird, setzen Sie dies auf etwas
wie (100, 10, 5, 1). Damit fdpowermon Warnungen bei 20 %, 10 % und 5 % ausgibt, setzen Sie dies auf
(20. 10. 5).

Beachten Sie, dass der Text der Warnung nicht geändert werden kann. Wenn Sie das möchten, sehen Sie sich die
fdpowermon::theme::warning sub und verwenden Sie ein Ereignis.

$use_notify
Die Variable $fdpowermon::theme::use_notify kann verwendet werden, um zu entscheiden, ob a
libnotify-Nachricht (wenn auf einen Wert ungleich Null gesetzt) ​​oder ein Dialogfenster (wenn auf einen Wert gesetzt, der
wird zu Null ausgewertet).

Standardmäßig wird libnotify verwendet, wenn die libnotify-Glib-Introspektionsdaten installiert sind, oder
ein Dialogfeld, wenn nicht. Weil Dialogfelder den Fokus stehlen und damit verheerende Auswirkungen haben können
mit der Arbeit des Benutzers wird die Verwendung von libnotify vom Autor dringend empfohlen.

Beachten Sie, dass, wenn Sie die Variable explizit auf einen Wert ungleich Null setzen, der Test, ob die
Glib Introspection-Daten installiert sind, werden ignoriert. Stellen Sie sicher, dass es darin verfügbar ist
Häuser!

neu
Erstellen Sie ein neues fdpowermon-Theme. Gibt eine gesegnete Referenz zurück; z.B,

mein $theme = new fdpowermon::theme;

$theme->set_stepcount($count)
Legen Sie die Anzahl der Schritte im Design fest. Beachten Sie, dass ein fdpowermon-Theme gleich sein muss
Schrittzahl sowohl in Richtung "Laden" als auch in Richtung "Entladen".

Sollte vor dem Aufruf von set_charging, set_discharging oder parse_step aufgerufen werden.

$theme->set_dir($dir)
Legen Sie das Basisverzeichnis fest, das für Symboldateinamen verwendet wird.

$theme->set_charging(\@elemente)
Legen Sie die Symbole fest, die angezeigt werden sollen, wenn der Akku geladen wird. Das Argument sollte sein
mit der Methode parse_step erstellt.

$theme->set_discharging(\@elements)
Legen Sie die Symbole fest, die angezeigt werden sollen, wenn der Akku entladen wird. Das Argument sollte sein
mit der Methode parse_step erstellt.

$theme->parse_step($defs)
Analysiert den angegebenen String in etwas, das an set_charging weitergegeben werden kann oder
set_entladen. Die Definitionen sollten im oben beschriebenen Stufenformat vorliegen, ohne
das führende " Laden = " oder " Entladen = ".

Während diese Methode eine Arrayref zurückgibt, die überprüft und (wahrscheinlich) geändert werden kann,
Themen, die aufwärtskompatibel sein wollen, sollten sie als undurchsichtige Datenstruktur behandeln.

$theme->set_event($step, \&zurückrufen, 'D')
Aktualisieren Sie das Thema, damit der Unter-'Rückruf' ausgeführt wird, wenn wir entladen und wir erreichen
$step zum ersten Mal. Um stattdessen beim Aufladen ein Ereignis festzulegen, übergeben Sie ein 'c' als drittes
Argument.

Beachten Sie, dass die Schritte Arrays sind und daher 0-basiert sind; die Elemente mit der niedrigsten Nummer sind
die untersten Stufen.

Wenn das Ereignis ausgelöst wird, werden der Callback-Routine zwei Argumente übergeben: das erste ist
der aktuelle Akkustand (in Prozent); die zweite ist eine Zahl, die angibt, ob die
Akku wird gerade geladen (1) oder entladen (0). Falls das Parsen des ACPI
Befehl schlägt fehl, das zweite Argument kann jedoch undef sein; darauf solltest du dich vorbereiten
Wahrscheinlichkeit. Beachten Sie, dass fdpowermon diesen Fall selbst handhabt, indem es davon ausgeht, dass die Batterie
Aufladen; Sie können dasselbe tun oder auch nicht.

$theme->register($name)
Registriert ein Thema unter einem bestimmten Namen. Wenn unter diesem Namen bereits ein Thema existiert, ist es
ersetzt.

make_default($name)
Macht ein Thema mit einem bestimmten Namen zum Standardthema.

get_theme($name)
Sucht nach einem Thema mit dem angegebenen Namen; z.B,

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

Warnung($Nachricht)
Erstellen Sie eine Warnung, entweder mit libnotify oder mit einem Dialogfeld:

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

Einzelheiten dazu finden Sie in der Dokumentation zu $fdpowermon::theme::use_notify oben
Ausführung gewählt wird.

Beispiele:

Ein vollständiges Beispiel für ein .cfg-Thema finden Sie oben.

Um das gleiche Thema vollständig aus Perl zu erstellen, gehen Sie folgendermaßen vor:

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

(Beachte, als Perl-Theme würde dies in theme.pl, nicht in theme.cfg gehen; siehe oben für mögliches
Standorte für Perl-Themen)

Wenn Sie das Thema jedoch nicht dynamisch erstellen möchten, ist dies nicht der Fall
empfohlen. Stattdessen würden Sie das Thema aus einer .cfg-Datei erstellen und möglicherweise ändern
aus perl. Angenommen, Sie möchten ein Ereignis hinzufügen, um das System zu unterbrechen, wenn der Strom ankommt
niedrig; in diesem Fall würdest du etwa so vorgehen:

Unter aussetzen {
system("sudo pm-suspend");
}

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

Dies würde das "Suspend"-Sub aufrufen, wenn sich der Akku entlädt und wir den niedrigsten Wert erreichen
Schritt (im obigen Beispiel wäre dies der Fall, wenn der Akku 10 % erreicht hat
mach das etwas später). Dieses 'suspend'-Sub ruft einfach das Programm "pm-suspend" auf, mit
sudo, um das System anzuhalten.

Verwenden Sie fdpowermon online mit den onworks.net-Diensten