fdpowermon: en línea en la nube

PROGRAMA:

NOMBRE

fdpowermon: agregue un icono de nivel de batería a una bandeja del sistema compatible con freedesktop.org

SINOPSIS

fdpowermon

DESCRIPCIÓN

Este programa permite mostrar un icono de "nivel de batería" en cualquier sitio compatible con freedesktop.org.
área de estado. Puede tener un tema a través de un archivo de configuración de texto sin formato
(/etc/fdpowermon/tema.cfg or $ XDG_CONFIG_DIR / fdpowermon / theme.cfg), oa través de un breve
script de perl/etc/fdpowermon/tema.pl or $ XDG_CONFIG_DIR / fdpowermon / theme.pl) Si
$ XDG_CONFIG_DIR no está configurado, $ HOME / .config se usa por defecto.

El primero es más fácil, ya que no requiere ningún script; y de hecho el predeterminado
La configuración es un ejemplo de un tema de texto sin formato. Sin embargo, este último permite
más flexibilidad, ya que se pueden definir devoluciones de llamada que deben ejecutarse cuando el nivel de la batería
alcanza un cierto umbral.

Los temas, ya sean temas de Perl o temas de texto sin formato, se construyen a través de 'pasos', que son
definido en una sola línea. En un archivo de configuración de texto sin formato, dicha línea se ve así:

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

Esto define tres pasos. El paso más alto muestra "full.png" loading = "lazy" cuando el nivel de la batería es
entre el 11% y el 100% (inclusive); el segundo paso muestra "low.png" loading = "lazy" cuando el nivel de la batería
está entre el 3% y el 10% (inclusive); y el tercer paso alternará entre "missing.png"
y "low.png" loading = "lazy" en intervalos de tres segundos, cuando la batería está entre 0% y 2%.

Dado que la línea comienza con "descargando", estos pasos se utilizan cuando el sistema está funcionando
con batería. Se podría definir una línea similar de pasos para cuando la batería está
carga:

cargando = 0: carga vacía.png, 10: carga baja.png, 100: carga completa.png

esto mostrará "carga-vacía.png" cargando = "lazy" cuando la batería esté al 0% (exactamente),
"low-charge.png" loading = "lazy" entre el 1% y el 10% (inclusive), y "full-charge.png" loading = "lazy" al 11% y
anterior.

Tenga en cuenta que el orden es importante: los pasos deben definirse de menor a mayor.

Para completar la configuración del tema, debemos agregar algunos elementos más:

[mi tema]
pasos = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
cargando = 0: carga vacía.png, 10: carga baja.png, 100: carga completa.png
descarga = 2: missing.png: low.png, 10: low.png, 100: full.png

Esto define un tema llamado "mytheme" que tiene tres pasos y buscará imágenes en
el directorio "/home/wouter/.fdpowermon/mytheme-icons". No es posible definir un
tema que tiene un número diferente de pasos para la fase de carga que para la
fase de descarga; si lo desea, simplemente defina (un) paso (s) adicional (s) para la fase que desea
quisiera tener menos pasos, que tiene el mismo icono que el paso anterior o inferior.

Tenga en cuenta que el orden también es importante aquí; la línea "pasos" debe aparecer antes de cualquier
líneas de "carga" o "descarga" (este no era el caso en fdpowermon 1.7 o inferior).

Si se configura más de un tema, fdpowermon utilizará, de forma predeterminada, el último tema
definido en la configuración por usuario, o (si no existe un archivo de configuración por usuario) el
último tema definido en la configuración de todo el sistema.

Los archivos de configuración del tema Perl pueden usar fdpowermon :: theme :: make_default para cambiar el valor predeterminado
tema.

PERL API

@ advertencias
La matriz @fdpowermon :: theme :: warnings se puede utilizar para especificar en qué niveles fdpowermon
debería emitir una advertencia estándar. El valor predeterminado es (10, 5, 1), lo que significa emitir una advertencia
a un nivel del 10%, 5% y 1%. Tenga en cuenta que si la batería se agota a una velocidad particularmente rápida
ritmo, es posible que el nivel se haya reducido incluso más que antes de que se emita la advertencia;
Además, fdpowermon emitirá una advertencia inmediatamente cuando se desconecte la energía de la máquina.
y la potencia está por debajo del primer nivel.

Para que fdpowermon siempre emita una advertencia cuando se corta la energía, establezca esto en algo
como (100, 10, 5, 1). Para que fdpowermon emita advertencias al 20%, 10% y 5%, establezca esto en
(20, 10, 5).

Tenga en cuenta que no es posible cambiar el texto de la advertencia. Si quieres eso, mira el
fdpowermon :: theme :: warning sub y use un evento.

$ use_notify
La variable $ fdpowermon :: theme :: use_notify se puede usar para decidir si usar un
libnotify mensaje (si se establece en un valor distinto de cero), o una ventana de diálogo (si se establece en un valor que
evalúa a cero).

El valor predeterminado es usar libnotify si los datos de introspección de libnotify Glib están instalados, o
un cuadro de diálogo si no. Porque los cuadros de diálogo pueden robar el foco y, por lo tanto, causar estragos.
con el trabajo del usuario, el autor recomienda encarecidamente el uso de libnotify.

Tenga en cuenta que si establece la variable en un valor distinto de cero explícitamente, entonces la prueba de si el
Los datos de introspección Glib instalados se ignorarán. Asegúrate de que esté disponible en ese
hogares!

nueva
Cree un nuevo tema fdpowermon. Devuelve una referencia bendecida; p.ej,

mi $ tema = nuevo fdpowermon :: tema;

$ tema-> set_stepcount ($ recuento)
Establezca el número de pasos en el tema. Tenga en cuenta que un tema fdpowermon debe tener un mismo
número de pasos tanto en la dirección de "carga" como en la de "descarga".

Se debe llamar antes de llamar a set_charging, set_discharging o parse_step.

$ tema-> set_dir ($ dir)
Establezca el directorio base utilizado para los nombres de archivos de iconos.

$ tema-> set_charging (\ @ elementos)
Configure los iconos que deben mostrarse cuando la batería se está cargando. El argumento debe ser
creado mediante el método parse_step.

$ tema-> set_discharging (\ @ elementos)
Configure los iconos que deben mostrarse cuando la batería se está descargando. El argumento debe ser
creado mediante el método parse_step.

$ tema-> parse_step ($ defs)
Analiza la cadena dada en algo que se puede pasar a set_charging o
set_discharging. Las definiciones deben estar en el formato de pasos, descrito anteriormente, sin
el primero "cargando =" o "descargando =".

Si bien este método devuelve una referencia de matriz que se puede inspeccionar y (probablemente) modificar,
los temas que quieran ser compatibles con versiones posteriores deben tratarlo como una estructura de datos opaca.

$ tema-> set_event ($ paso, \&llamar de vuelta, 'D')
Actualice el tema para que el sub 'callback' se ejecute cuando estemos descargando y alcancemos
$ paso por primera vez. Para configurar un evento al cargar en su lugar, pase una 'c' como el tercero
argumento.

Tenga en cuenta que los pasos son matrices y, por lo tanto, se basan en 0; los elementos con el número más bajo son
los pasos del nivel más bajo.

Cuando se activa el evento, la rutina de devolución de llamada se pasarán dos argumentos: el primero es
el nivel actual de la batería (en porcentaje); el segundo es un número que indica si el
La batería se está cargando (1) o se está descargando (0). En caso de que el análisis del ACPI
el comando falla, sin embargo, el segundo argumento puede ser indefinido; deberías prepararte para esto
posibilidad. Tenga en cuenta que el propio fdpowermon maneja ese caso asumiendo que la batería está
cargando puede que desee o no hacer lo mismo.

$ tema-> registrarse ($ nombre)
Registra un tema con un nombre de pila. Si un tema ya existe con ese nombre, es
reemplazado.

make_default ($ nombre)
Hace que un tema con un nombre de pila sea el tema predeterminado.

get_theme ($ nombre)
Busca un tema con el nombre de pila; p.ej,

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

advertencia ($ mensaje)
Genere una advertencia, ya sea usando libnotify o usando un cuadro de diálogo:

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

Consulte la documentación sobre $ fdpowermon :: theme :: use_notify anterior para obtener detalles sobre qué
se elige la implementación.

EJEMPLOS

Para ver un ejemplo completo de tema .cfg, mira arriba.

Para construir el mismo tema completamente desde perl, haría algo como esto:

mi $ tema = nuevo fdpowermon :: tema;
$ tema->set_stepcount(3);
$ tema-> set_dir ("/ inicio / wouter / .fdpowermon / mytheme-icons");
$ theme-> set_charging ($ theme-> parse_step ("0: carga-vacía.png, 10: carga baja.png, 100: carga-completa.png"));
$ theme-> set_discharging ($ theme-> parse_step ("2: missing.png: low.png, 10: low.png, 100: full.png"));

(tenga en cuenta que, como tema de Perl, iría en theme.pl, no en theme.cfg; consulte más arriba para ver posibles
ubicaciones para temas de perl)

Sin embargo, a menos que desee crear el tema dinámicamente, hacerlo de esta manera no es
recomendado. En su lugar, crearía el tema a partir de un archivo .cfg y posiblemente lo modificaría
de perl. Supongamos que desea agregar un evento para suspender el sistema cuando se enciende
bajo; en ese caso, harías algo como esto:

sub suspender {
sistema ("sudo pm-suspend");
}

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

Esto llamaría el sub 'suspender' cuando la batería se está descargando y alcanzamos el nivel más bajo
paso (en el ejemplo anterior, sería cuando la batería alcanza el 10%; es posible que desee
haz eso un poco más tarde). Este sub "suspender" simplemente llama al programa "pm-suspend", con
sudo, para suspender el sistema.

Utilice fdpowermon en línea utilizando los servicios de onworks.net