Go to file
2022-11-20 21:01:41 +01:00
examples Count number of threads instead of unread messages in gmail example 2022-11-20 21:01:41 +01:00
COPYING Update Licence from GPL v2 to GPL v3. Remove unused stylesheet 2020-05-07 08:50:42 +02:00
dbus.xml Quick update for GNOME 42. There is still some issues with menu. 2022-04-10 14:21:53 +02:00
extension.js Updates for GNOME 43 2022-10-27 17:54:37 +02:00
metadata.json Update metadata.json 2022-10-28 17:20:14 +02:00
README.md Update README 2022-10-28 08:09:34 +02:00

Introduction

This GNOME Shell Extension aims to display information to center box. Using DBUS protocol, any application can add or remove text and icons in the upper bar, right after date & clock.

Installation

Install it from https://extensions.gnome.org/extension/2826/generic-monitor/

OR

Create a symbolic link from your .local directory and enable extension

ln -s $PWD/generic-monitor@gnome-shell-extensions/ ~/.local/share/gnome-shell/extensions/ gnome-extensions enable generic-monitor@gnome-shell-extensions

Restart GNOME

DBUS protocol

All functions read JSON formatted parameters

notify(): { "group": "groupname", "items": [ { "name" : "", "box" : ["left"|"center"|"right"], // Optional : center by default "text" : <text_object>, // Optional "icon" : <icon_object>, // Optional "popup" : <popup_object>, // Optional <signals_description>, // Optional }, ... ] } }

deleteItems(): { "items": ["@", ...] }

deleteGroups(): { "groups": ["", ...] }

openPopup(): { "item": "@" }

closePopup(): { "item": "@" }

togglePopup(): { "item": "@" }

DBUS object

<text_object> is defined as : "text" : { "name" : "" // Optional, used with popup nested element <signals_description>, // Optional, used with popup nested element "text" : "Text to be displayed", "style" : "CSS style to be applied", // Optional }

<icon_object> is defined as : "icon" : { "path" : "Icon path", "style" : "CSS style to be applied", // Optional }

<picture_object> is defined as : "picture" : { "name" : "" // Optional, used with popup nested element <signals_description>, // Optional, used with popup nested element "path" : "Icon path", "width" : XXX, // Optional : Force width in pixels, can be -1 for defaut value "height" : XXX, // Optional : Force height in pixels, can be -1 for defaut value }

<popup_object is defuned as : "popup" : { "items": [<text_objects> and/or <picture_objects>] }

Signals description

Signals can be :

"on-click" : ["signal"|"delete"|"open-popup"|"close-popup"|"toggle-popup"] "on-dblclick" : ["signal"|"delete"|"open-popup"|"close-popup"|"toggle-popup"] "on-rightclick" : ["signal"|"delete"|"open-popup"|"close-popup"|"toggle-popup"] "on-rightdblclick" : ["signal"|"delete"|"open-popup"|"close-popup"|"toggle-popup"] "on-enter" : ["signal"|"delete"|"open-popup"|"close-popup"|"toggle-popup"] "on-leave" : ["signal"|"delete"|"open-popup"|"close-popup"|"toggle-popup"] "on-scroll" : ["signal"|"delete"|"open-popup"|"close-popup"|"toggle-popup"]

Targets :

  • signal : Emit a signal to desktop application
  • delete : Delete item
  • open-popup : Open the popup if there is one
  • close-popup : Close the popup if there is one
  • toggle-popup : Toggle (open/close) the popup if there is one

Signal names emit when action "signal" is specified :

  • onClick
  • onDblClick
  • onRightClick
  • onRightDblClick
  • onEnter
  • onLeave
  • onScrollUp
  • onScrollDown

Each signal is sent with one parameter : "@" For popup nested elements, parameter is "@@" where nestedName can be empty if not defined by user

Other signals are available when extension is activated/deactivated :

  • onActivate
  • onDeactivate

Example

You can test it with command line :

gdbus call --session --dest org.gnome.Shell --object-path /com/soutade/GenericMonitor --method com.soutade.GenericMonitor.notify '{"group":"new","items":[{"name":"first","on-click":"toggle-popup","text":{"text":"Hello","style":"color:green"},"popup":{"items":[{"picture":{"path":"/tmp/cat.jpg"}}]}}]}'

gdbus call --session --dest org.gnome.Shell --object-path /com/soutade/GenericMonitor --method com.soutade.GenericMonitor.deleteGroups '{"groups":["new"]}'

Python examples are available @ https://indefero.soutade.fr/p/genericmonitor/source/tree/master/examples

Development

After doing code update, you can test it within a nested window. In other cases you have to restart GNOME.

dbus-run-session -- gnome-shell --nested [--wayland]

To see log & errors :

journalctl /usr/bin/gnome-shell

Licence

GNU GPL 3