fdpowermon - En ligne dans le cloud

PROGRAMME:

Nom

fdpowermon - ajoute une icône de niveau de batterie à une barre d'état système compatible freedesktop.org

SYNOPSIS

fdpowermon

DESCRIPTION

Ce programme permet d'afficher une icône "niveau de batterie" dans n'importe quel appareil compatible freedesktop.org.
zone d'état. Il peut être thématique via un fichier de configuration en texte brut
(/etc/fdpowermon/theme.cfg or $XDG_CONFIG_DIR/fdpowermon/theme.cfg), ou via un court
script Perl (/etc/fdpowermon/theme.pl or $XDG_CONFIG_DIR/fdpowermon/theme.pl). Si
$XDG_CONFIG_DIR n'est pas défini, $HOME/.config est utilisé par défaut.

Le premier est plus simple, car il ne nécessite aucun script ; et bien la valeur par défaut
la configuration est un exemple d’un tel thème en texte brut. Toutefois, cette dernière permet
plus de flexibilité, car on peut définir des rappels qui doivent être exécutés lorsque le niveau de la batterie
atteint un certain seuil.

Les thèmes, qu'il s'agisse de thèmes Perl ou de thèmes en texte brut, sont construits par des « étapes », qui sont
défini sur une seule ligne. Dans un fichier de configuration en texte brut, une telle ligne ressemble à ceci :

déchargement = 2:missing.png:low.png, 10:low.png, 100:full.png

Cela définit trois étapes. L'étape la plus élevée affiche "full.png" chargement="lazy" lorsque le niveau de la batterie est
entre 11 % et 100 % (inclus) ; la deuxième étape affiche "low.png" chargement = "lazy" lorsque le niveau de la batterie
est compris entre 3 % et 10 % (inclus) ; et la troisième étape alternera entre "missing.png"
et "low.png" chargement="lazy" à intervalles de trois secondes, lorsque la batterie est comprise entre 0 % et 2 %.

Puisque la ligne commence par "décharge", ces étapes sont utilisées lorsque le système est en cours d'exécution
sur batterie. Une série d'étapes similaires pourrait être définie lorsque la batterie est
se charge:

charge = 0:charge-vide.png, 10:charge-faible.png, 100:charge-pleine.png

cela affichera "empty-chargement.png" chargement="lazy" lorsque la batterie est à 0% (exactement),
"low-chargement.png" chargement="lazy" entre 1% et 10% (inclus), et "full-chargement.png" chargement="lazy" à 11% et
au dessus.

Notez que l'ordre est important : les étapes doivent être définies de bas en haut.

Pour compléter la configuration du thème, nous devons ajouter quelques éléments supplémentaires :

[mon thème]
étapes = 3
rép = /home/wouter/.fdpowermon/mytheme-icons
charge = 0:charge-vide.png, 10:charge-faible.png, 100:charge-pleine.png
déchargement = 2:missing.png:low.png, 10:low.png, 100:full.png

Ceci définit un thème appelé "mytheme" qui comporte trois étapes et recherchera des images dans
le répertoire "/home/wouter/.fdpowermon/mytheme-icons". Il n'est pas possible de définir un
thème qui comporte un nombre d'étapes différent pour la phase de charge et pour la
phase de décharge ; si vous le souhaitez, définissez simplement une (des) étape(s) supplémentaire(s) pour la phase que vous
J'aimerais avoir moins d'étapes, qui ont la même icône que l'étape supérieure ou inférieure.

Notez que l’ordre est ici également important ; la ligne "étapes" doit apparaître avant tout
lignes de « charge » ou de « décharge » (ce n'était pas le cas dans fdpowermon 1.7 ou version antérieure).

Si plusieurs thèmes sont configurés, fdpowermon utilisera par défaut le dernier thème
défini dans la configuration par utilisateur, ou (si aucun fichier de configuration par utilisateur n'existe) le
dernier thème défini dans la configuration à l’échelle du système.

Les fichiers de configuration du thème Perl peuvent utiliser fdpowermon::theme::make_default pour modifier la valeur par défaut
thème.

PERL API

@avertissements
Le tableau @fdpowermon::theme::warnings peut être utilisé pour spécifier à quels niveaux fdpowermon
devrait émettre un avertissement standard. La valeur par défaut est (10, 5, 1), ce qui signifie émettre un avertissement
à un niveau de 10 %, 5 % et 1 %. Notez que si la batterie se décharge à un rythme particulièrement rapide
rythme, le niveau peut avoir baissé encore plus que cela avant l'émission de l'avertissement ;
de plus, fdpowermon émettra un avertissement immédiatement lorsque l'alimentation sera coupée de la machine
et la puissance est inférieure au premier niveau.

Pour que fdpowermon émette toujours un avertissement lorsque l'alimentation est coupée, définissez ceci sur quelque chose
comme (100, 10, 5, 1). Pour que fdpowermon émette des avertissements à 20 %, 10 % et 5 %, définissez ceci sur
(20 10, 5, XNUMX).

Notez qu'il n'est pas possible de modifier le texte de l'avertissement. Si vous le souhaitez, consultez le
fdpowermon::theme::warning sub et utilisez un événement.

$use_notify
La variable $fdpowermon::theme::use_notify peut être utilisée pour décider d'utiliser ou non un
un message libnotify (si défini sur une valeur différente de zéro) ou une fenêtre de dialogue (si défini sur une valeur qui
est évalué à zéro).

La valeur par défaut est d'utiliser libnotify si les données d'introspection libnotify Glib sont installées, ou
une boîte de dialogue sinon. Parce que les boîtes de dialogue peuvent détourner l'attention et donc faire des ravages
avec le travail de l'utilisateur, l'utilisation de libnotify est fortement recommandée par l'auteur.

Notez que si vous définissez explicitement la variable sur une valeur différente de zéro, alors le test si la variable est ou non
Les données d'introspection Glib installées seront ignorées. Assurez-vous qu'il est disponible dans ce
maisons!

neufs
Créez un nouveau thème fdpowermon. Renvoie une référence bénie ; par exemple,

mon $theme = nouveau fdpowermon::theme;

$theme->set_stepcount($count)
Définissez le nombre d'étapes dans le thème. Notez qu'un thème fdpowermon doit avoir un égal
nombre d'étapes dans le sens "chargement" et "déchargement".

Doit être appelé avant d'appeler set_chargement, set_dischargement ou parse_step.

$theme->set_dir($dir)
Définissez le répertoire de base utilisé pour les noms de fichiers d'icônes.

$theme->set_chargement(\@elements)
Définissez les icônes qui doivent être affichées lorsque la batterie est en charge. L'argument devrait être
créé au moyen de la méthode parse_step.

$theme->set_discharge(\@elements)
Définissez les icônes qui doivent être affichées lorsque la batterie se décharge. L'argument devrait être
créé au moyen de la méthode parse_step.

$theme->parse_step($defs)
Analyse la chaîne donnée en quelque chose qui peut être transmis à set_charger ou
set_discharge. Les définitions doivent être au format étapes, décrit ci-dessus, sans
le début « charge = » ou « décharge = ».

Bien que cette méthode renvoie une arrayref qui peut être inspectée et (probablement) modifiée,
les thèmes qui souhaitent être rétrocompatibles doivent le traiter comme une structure de données opaque.

$theme->set_event($étape, \&rappeler, 'd')
Mettez à jour le thème pour que le sous-'callback' soit exécuté lorsque nous déchargeons et que nous atteignons
$step pour la première fois. Pour définir un événement lors de la charge, transmettez un « c » comme troisième
argument.

Notez que les étapes sont des tableaux et sont donc basées sur 0 ; les éléments portant le numéro le plus bas sont
les étapes du niveau le plus bas.

Lorsque l'événement se déclenche, la routine de rappel recevra deux arguments : le premier est
le niveau actuel de la batterie (en pourcentage) ; le second est un nombre indiquant si le
la batterie est actuellement en charge (1) ou en décharge (0). En cas d'analyse de l'ACPI
la commande échoue, cependant, le deuxième argument peut être undef ; tu devrais te préparer à ça
possibilité. Notez que fdpowermon lui-même gère ce cas en supposant que la batterie est
mise en charge; vous souhaiterez peut-être ou non faire de même.

$thème->registre($nom)
Enregistre un thème sous un nom donné. Si un thème existe déjà sous ce nom, c'est
remplacé.

make_default($nom)
Fait d'un thème portant un nom donné le thème par défaut.

get_theme($nom)
Recherche un thème avec le nom donné ; par exemple,

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

avertissement ($ message)
Produisez un avertissement, soit en utilisant libnotify, soit en utilisant une boîte de dialogue :

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

Consultez la documentation sur $fdpowermon::theme::use_notify ci-dessus pour plus de détails sur lesquels
la mise en œuvre est choisie.

EXEMPLES

Pour un exemple complet de thème .cfg, regardez ci-dessus.

Pour construire entièrement le même thème à partir de Perl, vous feriez quelque chose comme ceci :

mon $theme = nouveau fdpowermon::theme;
$thème->set_stepcount(3);
$theme->set_dir("/home/wouter/.fdpowermon/mytheme-icons");
$theme->set_chargement($theme->parse_step("0:vide-charge.png, 10:faible-charge.png, 100: pleine-charge.png"));
$theme->set_discharge($theme->parse_step("2:missing.png:low.png, 10:low.png, 100:full.png"));

(notez qu'en tant que thème Perl, cela irait dans theme.pl, pas dans theme.cfg ; voir ci-dessus pour les
emplacements pour les thèmes Perl)

Cependant, à moins que vous ne souhaitiez créer le thème de manière dynamique, procéder de cette façon n'est pas
recommandé. Au lieu de cela, vous créeriez le thème à partir d'un fichier .cfg et éventuellement le modifieriez
de perl. Supposons que vous souhaitiez ajouter un événement pour suspendre le système lorsque l'alimentation est rétablie.
faible; dans ce cas, vous feriez quelque chose comme ceci :

sous suspendre {
système("sudo pm-suspend");
}

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

Cela appellerait le sous-marin « suspendre » lorsque la batterie se décharge et que nous atteignons le niveau le plus bas.
étape (dans l'exemple ci-dessus, ce serait lorsque la batterie atteint 10 % ; vous souhaiterez peut-être
faites-le un peu plus tard). Ce sous-programme « suspension » appelle simplement le programme « pm-suspend », avec
sudo, pour suspendre le système.

Utilisez fdpowermon en ligne à l'aide des services onworks.net