shell-app-usage: Shell Reference Manual

Go to page content
Go to main menu
Go to the search field

shell-app-usage

shell-app-usage — Track application usage/state data

Functions

ShellAppUsage *	shell_app_usage_get_default ()
GSList *	shell_app_usage_get_most_used ()
int	shell_app_usage_compare ()

Types and Values

#define	SHELL_TYPE_APP_USAGE
	ShellAppUsage

Object Hierarchy

    GObject
    ╰── ShellAppUsage

Description

This class maintains some usage and state statistics for applications by keeping track of the approximate time an application's windows are focused, as well as the last workspace it was seen on. This time tracking is implemented by watching for focus notifications, and computing a time delta between them. Also we watch the GNOME Session "StatusChanged" signal which by default is emitted after 5 minutes to signify idle.

Functions

shell_app_usage_get_default ()

ShellAppUsage *
shell_app_usage_get_default (void);

Returns

The global ShellAppUsage instance.

[transfer none]

shell_app_usage_get_most_used ()

GSList *
shell_app_usage_get_most_used (ShellAppUsage *usage,
                               const char *context);

Get a list of most popular applications for a given context.

Parameters

usage	the usage instance to request
context	Activity identifier

Returns

List of applications.

[element-type ShellApp][transfer full]

shell_app_usage_compare ()

int
shell_app_usage_compare (ShellAppUsage *self,
                         const char *context,
                         const char *id_a,
                         const char *id_b);

Compare id_a and id_b based on frequency of use.

Parameters

self	the usage instance to request
context	Activity identifier
id_a	ID of first app
id_b	ID of second app

Returns

-1 if id_a ranks higher than id_b , 1 if id_b ranks higher than id_a , and 0 if both rank equally.

Types and Values

SHELL_TYPE_APP_USAGE

#define SHELL_TYPE_APP_USAGE              (shell_app_usage_get_type ())

ShellAppUsage

typedef struct _ShellAppUsage ShellAppUsage;