77 lines
1.7 KiB
Markdown
77 lines
1.7 KiB
Markdown
|
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
|
||
|
|
------------
|
||
|
|
|
||
|
|
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",
|
||
|
|
// style and icon-style are optional
|
||
|
|
// item can have text and/or icon
|
||
|
|
"items": [
|
||
|
|
{
|
||
|
|
"name":"",
|
||
|
|
"text":"",
|
||
|
|
"style":"",
|
||
|
|
"icon-style":"",
|
||
|
|
"icon":"",
|
||
|
|
}, ...
|
||
|
|
]
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
deleteItems():
|
||
|
|
{
|
||
|
|
"items": ["<itemName>@<groupName>", ...]
|
||
|
|
}
|
||
|
|
|
||
|
|
deleteGroups():
|
||
|
|
{
|
||
|
|
"groups": ["<groupName>", ...]
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
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","text":"Hello","style":"color:green"}]}'
|
||
|
|
gdbus call --session --dest org.gnome.Shell --object-path /com/soutade/GenericMonitor --method com.soutade.GenericMonitor.deleteGroups '{"groups":["new"]}'
|
||
|
|
|
||
|
|
Python example is available
|
||
|
|
|
||
|
|
|
||
|
|
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
|