https://github.com/bilelmoussaoui/sni-qt

Patched version of sni-qt
https://github.com/bilelmoussaoui/sni-qt

Last synced: about 1 month ago
JSON representation

Patched version of sni-qt

• Host: GitHub
• URL: https://github.com/bilelmoussaoui/sni-qt
• Owner: bilelmoussaoui
• License: other
• Archived: true
• Created: 2016-12-11T02:56:50.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2017-09-04T04:05:39.000Z (over 7 years ago)
• Last Synced: 2024-08-04T01:09:51.828Z (5 months ago)
• Language: C++
• Size: 72.3 KB
• Stars: 7
• Watchers: 4
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

        
[![Build Status](https://travis-ci.org/bil-elmoussaoui/sni-qt.svg?branch=master)](https://travis-ci.org/bil-elmoussaoui/sni-qt)

# Summary

This plugin makes Qt applications use the StatusNotifierItem (SNI) protocol for

their system tray icons. It does so by turning system tray icons created with

the QSystemTrayIcon class into StatusNotifierItems.

This plugin only works when used together with the

"qsystemtrayicon-plugin-system-4.7" Qt branch. This branch is available from

this repository: http://gitorious.org/~agateau/qt/agateau-qt.

For convenience, the patch for Qt 4.7.4 is available in the patches/ dir.

# SNI category support

QSystemTrayIcon has no concept of categories, so sni-qt will create SNI in the

ApplicationStatus category by default. Application developers can override this

by setting the "_sni_qt_category" property on their QSystemTrayIcon instance.

Valid values for the properties are:

- "ApplicationStatus" (the default)

- "Communications"

- "SystemServices"

- "Hardware"

So for example to create a "Hardware" SNI, one would write:

    QSystemTrayIcon* icon = new QSystemTrayIcon();

    ...

    icon->setProperty("_sni_qt_category", "Hardware");

    ...

# QSystemTrayIcon::Trigger support

When sni-qt receives the StatusNotifierItem::Activate() call, it simulates a

left-click on the QSystemTrayIcon and emits

QSystemTrayIcon::activated(QSystemTrayIcon::Trigger)

Some implementations of the SNI protocol call StatusNotifierItem::Activate() on

left click and show the context menu on right click. KDE behaves like this.

Other implementations (Unity for example), only supports the context menu. This

means the action which is normally triggered by left-clicking the icon must also

be available in the context menu, otherwise it is not possible for the user to

trigger it.

In case an application does not provide an entry in its context menu to trigger

the same action as left-clicking on the icon, you can tell sni-qt to add an

"Activate" action at the top of the menu. This is configured in a file named

'sni-qt.conf'. sni-qt will look for it in '$HOME/.config' and '/etc/xdg'.

This file should look like this:

    [need-activate-action]

    foo=1

    bar=1

Where 'foo' and 'bar' are the binary names of the applications which needs an

"Activate" action. Setting the value to '0' will disable the action again (so

you can override the system-wide file)

# Debug

In the configuration file, add:

    [general]

    debug=1

To activate debug output to stderr.

# Author

Canonical DX Team

Maintainer: Renato Filho 

Former maintainer: Aurélien Gâteau