libnotify

https://gnome.pages.gitlab.gnome.org/libnotify/
Admin
libnotify is a GNOME library for sending desktop notifications to a notification daemon, enabling...
Tokens:12,873
Snippets:115
Trust Score:10
Update:6 months ago
Show doc for...
Tokens:
Raw
### Initialize libnotify

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.init.html

Initializes libnotify. This must be called before any other functions. Starting from 0.8, if the provided `app_name` is `NULL`, libnotify will try to figure it out from the running application. Before it was not allowed, and was causing libnotify not to be initialized.

```c
gboolean
notify_init (
  const char* app_name
)
```

--------------------------------

### NotifyNotificationget_activation_app_launch_context

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.get_activation_app_launch_context.html

Gets an application launch context for the notification action activation. If an action is currently being activated, this function returns a GAppLaunchContext that can be used to launch applications using the current activation token. This is useful within a NotifyActionCallback if the notification daemon supports it. Available since version 0.8.7.

```APIDOC
## NotifyNotificationget_activation_app_launch_context

### Description
Gets an application launch context for the notification action activation. If an an action is currently being activated, gets a a `GAppLaunchContext` that can be used to launch applications using the current activation token (see `notify_notification_get_activation_token()`). This function is intended to be used in a `NotifyActionCallback` to get the launch context for the activated action, if the notification daemon supports it.

### Method
GET (implied, as it's a getter function)

### Endpoint
N/A (This is a function call within a library, not a REST endpoint)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **GAppLaunchContext** - The `GAppLaunchContext` for the current activation token, or `NULL` if unset. The caller takes ownership and is responsible for freeing it.

#### Response Example
```json
{
  "example": "GAppLaunchContext* context = notify_notification_get_activation_app_launch_context(notification);"
}
```
```

--------------------------------

### Application Information Functions

Source: https://gnome.pages.gitlab.gnome.org/libnotify/index.html

Functions to get and set the application name and icon associated with notifications.

```APIDOC
## get_app_name

### Description
Gets the application name registered.

### Method
`get_app_name`

### Endpoint
N/A (Library function)

## set_app_name

### Description
Sets the application name.

### Method
`set_app_name`

### Endpoint
N/A (Library function)

## get_app_icon

### Description
Gets the application icon registered. since: 0.8.4

### Method
`get_app_icon`

### Endpoint
N/A (Library function)

## set_app_icon

### Description
Sets the application icon. since: 0.8.4

### Method
`set_app_icon`

### Endpoint
N/A (Library function)
```

--------------------------------

### GET notify_get_app_icon

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.get_app_icon.html

Retrieves the application icon that was previously registered using notify_set_app_icon.

```APIDOC
## GET notify_get_app_icon

### Description
Gets the application icon registered for the notification system.

### Return value
- **Type**: const char*
- **Description**: The registered application icon, set via notify_set_app_icon(). The data is owned by the called function and is a NUL terminated UTF-8 string.

### Response Example
{
  "app_icon": "/usr/share/icons/hicolor/48x48/apps/example.png"
}
```

--------------------------------

### Get notification closed reason

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.get_closed_reason.html

Retrieves the closed reason code for a notification. This value is only valid after the NotifyNotification::closed signal has been emitted.

```C
gint
notify_notification_get_closed_reason (
  const NotifyNotification* notification
)
```

--------------------------------

### notify_init

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.init.html

Initializes the libnotify library. This function must be called before any other libnotify functions.

```APIDOC
## notify_init

### Description
Initialized libnotify. This must be called before any other functions. Starting from 0.8, if the provided app_name is NULL, libnotify will try to figure it out from the running application.

### Parameters
#### Path Parameters
- **app_name** (const char*) - Optional - The name of the application initializing libnotify. The value is a NUL terminated UTF-8 string.

### Response
#### Success Response
- **return** (gboolean) - TRUE if successful, or FALSE on error.
```

--------------------------------

### Define Notification Image Path Hint - C

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_IMAGE_PATH.html

Use this macro to define the image path hint for notifications. Requires server support for specification version >= 1.2. The hint expects a string.

```c
#define NOTIFY_NOTIFICATION_HINT_IMAGE_PATH "image-path"
```

--------------------------------

### Libnotify Initialization and Uninitialization

Source: https://gnome.pages.gitlab.gnome.org/libnotify/index.html

Functions for initializing and uninitializing the libnotify library. Initialization must be called before any other libnotify functions.

```APIDOC
## init

### Description
Initialized libnotify. This must be called before any other functions.

### Method
`init`

### Endpoint
N/A (Library function)

## is_initted

### Description
Gets whether or not libnotify is initialized.

### Method
`is_initted`

### Endpoint
N/A (Library function)

## uninit

### Description
Uninitializes libnotify.

### Method
`uninit`

### Endpoint
N/A (Library function)
```

--------------------------------

### Function Macros

Source: https://gnome.pages.gitlab.gnome.org/libnotify/index.html

Convenience macros provided by libnotify.

```APIDOC
## Function Macros

### Description
Convenience macros provided by libnotify.

### Macros List
- **ACTION_CALLBACK** - A convenience macro for casting a function to a `NotifyActionCallback`.
- **CHECK_VERSION** - Check whether a version equal to or greater than `major.minor.micro` is present.
```

--------------------------------

### void notify_uninit (void)

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.uninit.html

Uninitializes the libnotify library. This function should be called when the program no longer requires libnotify, typically before exiting.

```APIDOC
## void notify_uninit (void)

### Description
Uninitializes libnotify. This should be called when the program no longer needs libnotify for the rest of its lifecycle, typically just before exiting.

### Method
N/A (C Function)

### Endpoint
notify_uninit
```

--------------------------------

### Server Information and Capabilities

Source: https://gnome.pages.gitlab.gnome.org/libnotify/index.html

Functions to query the notification server for its capabilities and general information.

```APIDOC
## get_server_caps

### Description
Queries the server capabilities.

### Method
`get_server_caps`

### Endpoint
N/A (Library function)

## get_server_info

### Description
Queries the server for information.

### Method
`get_server_info`

### Endpoint
N/A (Library function)
```

--------------------------------

### NOTIFY_NOTIFICATION_HINT_ACTION_ICONS

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_ACTION_ICONS.html

Constant definition for the action-icons hint.

```APIDOC
## NOTIFY_NOTIFICATION_HINT_ACTION_ICONS

### Description
When set, a server that has the “action-icons” capability will attempt to interpret any action identifier as a named icon. The localized display name will be used to annotate the icon for accessibility purposes. The icon name should be compliant with the Freedesktop.org Icon Naming Specification.

### Requirements
Requires server supporting specification version >= 1.2.

### Hint GVariantType
GLib.VARIANT_TYPE_BOOLEAN (b)

### Declaration
#define NOTIFY_NOTIFICATION_HINT_ACTION_ICONS "action-icons"
```

--------------------------------

### Define NOTIFY_NOTIFICATION_HINT_IMAGE_PATH_LEGACY

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_IMAGE_PATH_LEGACY.html

Use this constant to specify the image path hint for notifications. Requires server support for specification version 1.1 or higher.

```c
#define NOTIFY_NOTIFICATION_HINT_IMAGE_PATH_LEGACY "image_path"
```

--------------------------------

### notify_get_server_info

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.get_server_info.html

Synchronously queries the notification server for its information, including name, vendor, version, and specification version.

```APIDOC
## notify_get_server_info

### Description
Queries the server for information. Synchronously queries the server for its information, specifically, the name, vendor, server version, and the version of the notifications specification that it is compliant with.

### Parameters
- **ret_name** (char**) - Optional - A location to store the server name.
- **ret_vendor** (char**) - Optional - A location to store the server vendor.
- **ret_version** (char**) - Optional - A location to store the server version.
- **ret_spec_version** (char**) - Optional - A location to store the version the service is compliant with.

### Response
- **Return value** (gboolean) - TRUE if successful, FALSE on error. The returned strings must be freed with g_free.
```

--------------------------------

### Define NOTIFY_NOTIFICATION_HINT_DESKTOP_ENTRY

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_DESKTOP_ENTRY.html

The constant used to specify the desktop entry hint for notifications.

```c
#define NOTIFY_NOTIFICATION_HINT_DESKTOP_ENTRY "desktop-entry"
```

--------------------------------

### Check Libnotify Initialization

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.is_initted.html

This function checks if the libnotify library has been initialized.

```APIDOC
## notify_is_initted

### Description
Gets whether or not libnotify is initialized.

### Method
GET

### Endpoint
/

### Return value
#### Success Response (200)
- **gboolean** (boolean) - TRUE if libnotify is initialized, or FALSE otherwise.
```

--------------------------------

### Define NOTIFY_NOTIFICATION_HINT_ACTION_ICONS

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_ACTION_ICONS.html

Constant used to enable action icon interpretation in notification servers.

```c
#define NOTIFY_NOTIFICATION_HINT_ACTION_ICONS "action-icons"
```

--------------------------------

### Define NotifyNotification Hint Sound File

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_SOUND_FILE.html

Defines the string constant used for the 'sound-file' hint. This hint specifies the path to a sound file to be played when a notification appears. The expected GVariantType is GLib.VARIANT_TYPE_STRING.

```c
#define NOTIFY_NOTIFICATION_HINT_SOUND_FILE "sound-file"
```

--------------------------------

### Check library version with NOTIFY_CHECK_VERSION

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.CHECK_VERSION.html

Use this macro to verify that the library version is at least the specified major, minor, and micro version. This macro is not accessible via language bindings.

```c
#define NOTIFY_CHECK_VERSION (
  major,
  minor,
  micro
)
```

--------------------------------

### Define NOTIFY_NOTIFICATION_HINT_IMAGE_DATA

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_IMAGE_DATA.html

Constant representing the image-data hint key for notifications.

```c
#define NOTIFY_NOTIFICATION_HINT_IMAGE_DATA "image-data"
```

--------------------------------

### Notifyget_server_caps

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.get_server_caps.html

Queries the server for its capabilities.

```APIDOC
## Notifyget_server_caps

### Description
Synchronously queries the server for its capabilities and returns them in a list.

### Method
GET (Conceptual - this is a function call, not a direct HTTP endpoint)

### Endpoint
N/A (Function call)

### Parameters
None

### Request Example
N/A (Function call)

### Response
#### Success Response
- **Return value** (GList*) - A list of server capability strings (utf8).

### Response Example
```
{
  "capabilities": [
    "actions",
    "image-path",
    "sound"
  ]
}
```

--- 
Each element is a NUL terminated UTF-8 string. The caller of the function takes ownership of the data, and is responsible for freeing it.
```

--------------------------------

### NOTIFY_NOTIFICATION_HINT_SOUND_NAME

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_SOUND_NAME.html

Documentation for the sound-name notification hint constant.

```APIDOC
## NOTIFY_NOTIFICATION_HINT_SOUND_NAME

### Description
A themeable named sound from the freedesktop.org sound naming specification to play when the notification pops up. Similar to icon-name, only for sounds. An example would be “message-new-instant”.

### Declaration
#define NOTIFY_NOTIFICATION_HINT_SOUND_NAME "sound-name"

### Hint GVariantType
GLib.VARIANT_TYPE_STRING ('s')
```

--------------------------------

### NOTIFY_NOTIFICATION_HINT_IMAGE_DATA_LEGACY

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_IMAGE_DATA_LEGACY.html

Constant definition for legacy raw image data hints in notifications.

```APIDOC
## Constant: NOTIFY_NOTIFICATION_HINT_IMAGE_DATA_LEGACY

### Description
This is a raw data image format which describes the width, height, rowstride, has alpha, bits per sample, channels and image data respectively. Requires server supporting specification version >= 1.1.

### Declaration
#define NOTIFY_NOTIFICATION_HINT_IMAGE_DATA_LEGACY "image_data"

### GVariantType
(iiibiiay)
```

--------------------------------

### Define NOTIFY_NOTIFICATION_HINT_CATEGORY

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_CATEGORY.html

This constant defines the hint key for the notification category. Use this hint to specify the type of notification.

```c
#define NOTIFY_NOTIFICATION_HINT_CATEGORY "category"
```

--------------------------------

### NotifyNotificationHintImagePath

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_IMAGE_PATH.html

Defines the hint for specifying an image path for notifications. This is an alternative method for setting the notification image and requires server support for specification version 1.2 or higher. The hint expects a string value.

```APIDOC
## Constant: NOTIFY_NOTIFICATION_HINT_IMAGE_PATH

### Description
Alternative way to define the notification image. Requires server supporting specification version >= 1.2. Hint `GVariantType`: GLib.VARIANT_TYPE_STRING (`s`).

### Declaration
```c
#define NOTIFY_NOTIFICATION_HINT_IMAGE_PATH "image-path"
```
```

--------------------------------

### Define NOTIFY_NOTIFICATION_HINT_X

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_X.html

Constant used to specify the X location on the screen for a notification. Requires the corresponding y hint to be set.

```c
#define NOTIFY_NOTIFICATION_HINT_X "x"
```

--------------------------------

### NotifyNotificationHintDesktopEntry

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_DESKTOP_ENTRY.html

Specifies the name of the desktop filename representing the calling program.

```APIDOC
## Constant NotifyNotificationHintDesktopEntry

### Description
This specifies the name of the desktop filename representing the calling program. This should be the same as the prefix used for the application’s .desktop file. An example would be “rhythmbox” from “rhythmbox.desktop”. This can be used by the daemon to retrieve the correct icon for the application, for logging purposes, etc.
Hint `GVariantType`: GLib.VARIANT_TYPE_STRING (`s`).

### Declaration
```c
#define NOTIFY_NOTIFICATION_HINT_DESKTOP_ENTRY "desktop-entry"
```
```

--------------------------------

### Uninitialize libnotify

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.uninit.html

Call this function when the program no longer requires libnotify, typically before exiting.

```C
void
notify_uninit (
  void
)
```

--------------------------------

### Define NotifyNotification Hint Image Data Legacy

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_IMAGE_DATA_LEGACY.html

Defines the constant for raw image data hints. Requires server supporting specification version >= 1.1. The GVariantType is (iiibiiay).

```c
#define NOTIFY_NOTIFICATION_HINT_IMAGE_DATA_LEGACY "image_data"
```

--------------------------------

### NOTIFY_NOTIFICATION_HINT_SOUND_FILE

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_SOUND_FILE.html

The NOTIFY_NOTIFICATION_HINT_SOUND_FILE hint specifies the path to a sound file that should be played when a notification appears.

```APIDOC
## Constant: NOTIFY_NOTIFICATION_HINT_SOUND_FILE

### Description
The path to a sound file to play when the notification pops up. Hint `GVariantType`: GLib.VARIANT_TYPE_STRING (`s`).

### Declaration
```c
#define NOTIFY_NOTIFICATION_HINT_SOUND_FILE "sound-file"
```
```

--------------------------------

### Define NotifyNotification Hint Transient

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_TRANSIENT.html

Defines the transient hint for notifications. Use this when the server should bypass persistence capabilities. Requires server supporting specification version >= 1.2. Hint type is GLib.VARIANT_TYPE_BOOLEAN.

```c
#define NOTIFY_NOTIFICATION_HINT_TRANSIENT "transient"
```

--------------------------------

### notify_get_app_name

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.get_app_name.html

Retrieves the application name that was previously registered with notify_init().

```APIDOC
## notify_get_app_name

### Description
Gets the application name registered with the library.

### Return value
- **Type**: const char*
- **Description**: The registered application name, passed to notify_init(). The data is owned by the called function and is a NUL terminated UTF-8 string.
```

--------------------------------

### Define NOTIFY_NOTIFICATION_HINT_SOUND_NAME

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_SOUND_NAME.html

The constant used to specify a themeable sound hint for notifications.

```c
#define NOTIFY_NOTIFICATION_HINT_SOUND_NAME "sound-name"
```

--------------------------------

### Enumerations

Source: https://gnome.pages.gitlab.gnome.org/libnotify/index.html

Enumerations used within the libnotify library.

```APIDOC
## Enumerations

### Description
Enumerations used within the libnotify library.

### Enumerations List
- **ClosedReason** (enum) - since: 0.8.0
- **Urgency** (enum) - The urgency level of the notification.
```

--------------------------------

### Callbacks

Source: https://gnome.pages.gitlab.gnome.org/libnotify/index.html

Callback function types used by libnotify.

```APIDOC
## Callbacks

### Description
Callback function types used by libnotify.

### Callbacks List
- **ActionCallback** (function pointer) - An action callback function.
```

--------------------------------

### notify_notification_new

Source: https://gnome.pages.gitlab.gnome.org/libnotify/ctor.Notification.new.html

Creates a new NotifyNotification instance with the specified summary, body, and icon.

```APIDOC
## notify_notification_new

### Description
Creates a new NotifyNotification. The summary text is required, but all other parameters are optional.

### Parameters
- **summary** (const char*) - Required - The required summary text.
- **body** (const char*) - Optional - The optional body text.
- **icon** (const char*) - Optional - The optional icon theme icon name or filename.

### Response
- **NotifyNotification** (object) - The new NotifyNotification instance. The caller takes ownership of the data.
```

--------------------------------

### Define NotifyNotification Hint Y

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_Y.html

Defines the constant for the Y screen position hint. Use this hint along with the 'x' hint to specify the notification's pointing location on the screen. The expected type is GLib.VARIANT_TYPE_INT32.

```c
#define NOTIFY_NOTIFICATION_HINT_Y "y"
```

--------------------------------

### NotifyNotificationHintImagePathLegacy

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_IMAGE_PATH_LEGACY.html

Defines the legacy hint for specifying an image path in notifications. This is an alternative way to define the notification image and requires server support for specification version 1.1 or higher. The hint type is GLib.VARIANT_TYPE_STRING ('s').

```APIDOC
## Constant: NOTIFY_NOTIFICATION_HINT_IMAGE_PATH_LEGACY

### Description
Alternative way to define the notification image. Requires server supporting specification version >= 1.1.
Hint `GVariantType`: GLib.VARIANT_TYPE_STRING (`s`).

### Value
`"image_path"`
```

--------------------------------

### NOTIFY_NOTIFICATION_HINT_X Constant

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_X.html

Defines the hint constant for specifying the X coordinate of a notification.

```APIDOC
## Constant: NOTIFY_NOTIFICATION_HINT_X

### Description
Specifies the X location on the screen that the notification should point to. The “y” hint must also be specified.

### Declaration
#define NOTIFY_NOTIFICATION_HINT_X "x"

### Hint Type
- **GVariantType**: GLib.VARIANT_TYPE_INT32 ('i')
```

--------------------------------

### NOTIFY_NOTIFICATION_HINT_RESIDENT

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_RESIDENT.html

Constant definition for the resident notification hint.

```APIDOC
## NOTIFY_NOTIFICATION_HINT_RESIDENT

### Description
When set, the server will not automatically remove the notification when an action has been invoked. The notification will remain resident in the server until it is explicitly removed by the user or by the sender. This hint is likely only useful when the server has the “persistence” capability.

### Requirements
- Requires server supporting specification version >= 1.2.

### Hint Details
- **GVariantType**: GLib.VARIANT_TYPE_BOOLEAN (b)

### Definition
#define NOTIFY_NOTIFICATION_HINT_RESIDENT "resident"
```

--------------------------------

### Notification Constants

Source: https://gnome.pages.gitlab.gnome.org/libnotify/index.html

Defines constants related to notification behavior, hints, and versioning.

```APIDOC
## Constants

### Description
Constants related to notification behavior, hints, and versioning.

### Constants List
- **EXPIRES_DEFAULT** (int) - The default expiration time on a notification.
- **EXPIRES_NEVER** (int) - The notification never expires.
- **NOTIFICATION_HINT_ACTION_ICONS** (string) - When set, a server that has the “action-icons” capability will attempt to interpret any action identifier as a named icon. The localized display name will be used to annotate the icon for accessibility purposes. The icon name should be compliant with the Freedesktop.org Icon Naming Specification.
- **NOTIFICATION_HINT_CATEGORY** (string) - The type of notification this is.
- **NOTIFICATION_HINT_DESKTOP_ENTRY** (string) - This specifies the name of the desktop filename representing the calling program. This should be the same as the prefix used for the application’s .desktop file. An example would be “rhythmbox” from “rhythmbox.desktop”. This can be used by the daemon to retrieve the correct icon for the application, for logging purposes, etc.
- **NOTIFICATION_HINT_IMAGE_DATA** (string) - This is a raw data image format which describes the width, height, rowstride, has alpha, bits per sample, channels and image data respectively.
- **NOTIFICATION_HINT_IMAGE_DATA_LEGACY** (string) - This is a raw data image format which describes the width, height, rowstride, has alpha, bits per sample, channels and image data respectively.
- **NOTIFICATION_HINT_IMAGE_PATH** (string) - Alternative way to define the notification image.
- **NOTIFICATION_HINT_IMAGE_PATH_LEGACY** (string) - Alternative way to define the notification image.
- **NOTIFICATION_HINT_RESIDENT** (string) - When set the server will not automatically remove the notification when an action has been invoked. The notification will remain resident in the server until it is explicitly removed by the user or by the sender. This hint is likely only useful when the server has the “persistence” capability.
- **NOTIFICATION_HINT_SOUND_FILE** (string) - The path to a sound file to play when the notification pops up.
- **NOTIFICATION_HINT_SOUND_NAME** (string) - A themeable named sound from the freedesktop.org sound naming specification to play when the notification pops up. Similar to icon-name, only for sounds. An example would be “message-new-instant”.
- **NOTIFICATION_HINT_SUPPRESS_SOUND** (string) - Causes the server to suppress playing any sounds, if it has that ability. This is usually set when the client itself is going to play its own sound.
- **NOTIFICATION_HINT_TRANSIENT** (string) - When set the server will treat the notification as transient and by-pass the server’s persistence capability, if it should exist.
- **NOTIFICATION_HINT_URGENCY** (string) - The urgency level.
- **NOTIFICATION_HINT_X** (string) - Specifies the X location on the screen that the notification should point to. The “y” hint must also be specified.
- **NOTIFICATION_HINT_Y** (string) - Specifies the Y location on the screen that the notification should point to. The “x” hint must also be specified.
- **VERSION_MAJOR** (int) - Notify major version component (e.g. 1 if the version is 1.2.3).
- **VERSION_MICRO** (int) - Notify micro version component (e.g. 3 if the version is 1.2.3).
- **VERSION_MINOR** (int) - Notify minor version component (e.g. 2 if the version is 1.2.3).
```

--------------------------------

### NOTIFY_NOTIFICATION_HINT_TRANSIENT

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_TRANSIENT.html

The 'transient' hint, when set, instructs the notification server to treat the notification as transient, bypassing any persistence mechanisms. This requires the server to support specification version 1.2 or higher. The hint expects a boolean value.

```APIDOC
## Constant: NOTIFY_NOTIFICATION_HINT_TRANSIENT

### Description
When set the server will treat the notification as transient and by-pass the server’s persistence capability, if it should exist. Requires server supporting specification version >= 1.2.

### Hint Details
- **Name**: "transient"
- **Type**: GLib.VARIANT_TYPE_BOOLEAN (`b`)

### Usage Example (Conceptual)
```c
// Assuming 'notification' is a valid NotifyNotification object
// and 'connection' is a valid NotifyConnection object

// To set the transient hint to true:
notify_notification_set_hint(notification, "transient", g_variant_new_boolean(TRUE));

// To set the transient hint to false (or not set it):
// notify_notification_set_hint(notification, "transient", g_variant_new_boolean(FALSE));
// or simply do not call set_hint for "transient"
```
```

--------------------------------

### NOTIFY_VERSION_MINOR Constant

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.VERSION_MINOR.html

Documentation for the NOTIFY_VERSION_MINOR constant which represents the minor version component of the library.

```APIDOC
## NOTIFY_VERSION_MINOR

### Description
Notify minor version component (e.g. 2 if the version is 1.2.3).

### Declaration
#define NOTIFY_VERSION_MINOR 8
```

--------------------------------

### Define Notify Version Micro

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.VERSION_MICRO.html

Defines the micro version component of the Notify library. Use this when checking for specific micro version compatibility.

```c
#define NOTIFY_VERSION_MICRO 8
```

--------------------------------

### notify_notification_set_hint

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_hint.html

Sets a hint for a specific key on a notification object.

```APIDOC
## notify_notification_set_hint

### Description
Sets a hint for `key` with value `value`. If `value` is `NULL`, a previously set hint for `key` is unset. If `value` is floating, it is consumed.

### Parameters
- **notification** (NotifyNotification*) - Required - The notification object.
- **key** (const char*) - Required - The hint key (NUL terminated UTF-8 string).
- **value** (GVariant*) - Optional - The hint value.
```

--------------------------------

### NotifyNotificationset_hint_uint32

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_hint_uint32.html

Sets a hint with an unsigned 32-bit integer value. Deprecated since 0.6. Use notify_notification_set_hint() instead.

```APIDOC
## void notify_notification_set_hint_uint32

### Description
Sets a hint with an unsigned 32-bit integer value.
Deprecated since: 0.6.
Use `notify_notification_set_hint()` instead.

### Method
void

### Endpoint
N/A (This is a function signature, not a REST endpoint)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (void)
This function does not return a value.

#### Response Example
None
```

--------------------------------

### Define NOTIFY_NOTIFICATION_HINT_URGENCY

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_URGENCY.html

Constant used to specify the urgency level hint for a notification.

```c
#define NOTIFY_NOTIFICATION_HINT_URGENCY "urgency"
```

--------------------------------

### NOTIFY_NOTIFICATION_HINT_IMAGE_DATA Constant

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_IMAGE_DATA.html

This constant is used to specify raw image data as a hint for notifications. The data is expected in a specific GVariant format.

```APIDOC
## Constant: NOTIFY_NOTIFICATION_HINT_IMAGE_DATA

### Description
This is a raw data image format which describes the width, height, rowstride, has alpha, bits per sample, channels and image data respectively. Requires server supporting specification version >= 1.2.

### GVariant Type
`(iiibiiay)`

### Usage
This hint is used to embed raw image data directly within a notification. The format of the data is defined by the `GVariantType` specified.
```

--------------------------------

### NotifyNotificationShow Declaration

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.show.html

This is the C function declaration for notify_notification_show. It takes a NotifyNotification pointer and a GError pointer as arguments. Returns TRUE on success, FALSE on error.

```c
gboolean
notify_notification_show (
  NotifyNotification* notification
  GError** error
)

```

--------------------------------

### NOTIFY_VERSION_MICRO Constant

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.VERSION_MICRO.html

Defines the micro version component of the Libnotify library.

```APIDOC
## Constant: NOTIFY_VERSION_MICRO

### Description
Notify micro version component (e.g. 3 if the version is 1.2.3).

### Declaration
#define NOTIFY_VERSION_MICRO 8
```

--------------------------------

### Set a 32-bit unsigned integer hint

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_hint_uint32.html

Sets a hint with an unsigned 32-bit integer value. This method is deprecated since version 0.6; use notify_notification_set_hint instead.

```c
void
notify_notification_set_hint_uint32 (
  NotifyNotification* notification,
  const char* key,
  guint value
)
```

--------------------------------

### Set Application Icon

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.set_app_icon.html

Sets the application icon for notifications. This function is available since version 0.8.4.

```APIDOC
## Function notify_set_app_icon

### Description
Sets the application icon. Available since: 0.8.4

### Parameters
#### Path Parameters
* None

#### Query Parameters
* None

#### Request Body
* None

### Method
Not applicable (this is a function call, not an HTTP endpoint)

### Endpoint
Not applicable (this is a function call, not an HTTP endpoint)

### Function Signature
```c
void notify_set_app_icon (const char* app_icon)
```

### Parameters
#### `app_icon`
* **Type:** `const char*`
* **Description:** The optional icon theme icon name or filename. The argument can be `NULL`. The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string.
* **Required:** Optional
```

--------------------------------

### NOTIFY_NOTIFICATION_HINT_CATEGORY

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_CATEGORY.html

Defines the constant for notification categories.

```APIDOC
## NOTIFY_NOTIFICATION_HINT_CATEGORY

### Description
The type of notification this is. This hint uses a GVariantType of GLib.VARIANT_TYPE_STRING ('s').

### Declaration
#define NOTIFY_NOTIFICATION_HINT_CATEGORY "category"
```

--------------------------------

### Define Notify Major Version

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.VERSION_MAJOR.html

Defines the major version component of the Notify library. Use this to check compatibility or identify major releases.

```c
#define NOTIFY_VERSION_MAJOR 0
```

--------------------------------

### NotifyNotification Class Methods

Source: https://gnome.pages.gitlab.gnome.org/libnotify/class.Notification.html

Methods for managing the lifecycle and content of a notification object.

```APIDOC
## notify_notification_new

### Description
Creates a new NotifyNotification object.

## notify_notification_show

### Description
Tells the notification server to display the notification on the screen.

## notify_notification_close

### Description
Synchronously tells the notification server to hide the notification on the screen.

## notify_notification_update

### Description
Updates the notification text and icon.

## notify_notification_add_action

### Description
Adds an action to a notification.
```

--------------------------------

### NotifyNotificationShow

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.show.html

Displays a notification on the screen.

```APIDOC
## NotifyNotificationShow

### Description
Tells the notification server to display the notification on the screen.

### Method
`gboolean` (return type)

### Endpoint
N/A (This is a function call, not an HTTP endpoint)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```c
// Example usage within a C program:
NotifyNotification* notification = notify_notification_new("Summary", "Body", "icon_name");
GError *error = NULL;
if (notify_notification_show(notification, &error)) {
    // Notification shown successfully
} else {
    // Handle error: g_error("%s", error->message);
    // g_error_free(error);
}
```

### Response
#### Success Response (TRUE)
- **gboolean** (boolean) - `TRUE` if successful.

#### Error Response (FALSE)
- **GError** (error) - If an error occurs, this will be set and the function will return `FALSE`.

#### Response Example
```json
{
  "success": true
}
```

#### Error Response Example
```json
{
  "success": false,
  "error": {
    "message": "Failed to show notification: ..."
  }
}
```
```

--------------------------------

### Define NOTIFY_ACTION_CALLBACK macro

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.ACTION_CALLBACK.html

A convenience macro for casting a function to a NotifyActionCallback. This macro is not available to language bindings.

```c
#define NOTIFY_ACTION_CALLBACK (
  func
)
```

--------------------------------

### NotifyActionCallback

Source: https://gnome.pages.gitlab.gnome.org/libnotify/callback.ActionCallback.html

Defines the signature for an action callback function triggered by a notification.

```APIDOC
## NotifyActionCallback

### Description
An action callback function triggered when a notification action is activated.

### Parameters
- **notification** (NotifyNotification) - Required - A NotifyNotification object. The data is owned by the caller.
- **action** (char*) - Required - The activated action name. A NUL terminated UTF-8 string. The data is owned by the caller.
- **user_data** (gpointer) - Optional - User provided data. Can be NULL. The data is owned by the caller.
```

--------------------------------

### Virtual Method: NotifyNotification::closed

Source: https://gnome.pages.gitlab.gnome.org/libnotify/vfunc.Notification.closed.html

Documentation for the closed virtual method of the NotifyNotification object.

```APIDOC
## Virtual Method: NotifyNotification::closed

### Description
This virtual method is triggered when a notification is closed.

### Declaration
void closed (NotifyNotification* notification)
```

--------------------------------

### Define NOTIFY_VERSION_MINOR

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.VERSION_MINOR.html

This macro defines the minor version number for the libnotify library. It is used to specify the minor component of the library's version.

```c
#define NOTIFY_VERSION_MINOR 8
```

--------------------------------

### notify_notification_set_image_from_pixbuf

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_image_from_pixbuf.html

Sets the image in the notification from a GdkPixbuf.

```APIDOC
## notify_notification_set_image_from_pixbuf

### Description
Sets the image in the notification from a GdkPixbuf. Available since: 0.5.

### Parameters
- **notification** (NotifyNotification*) - Required - The notification object.
- **pixbuf** (GdkPixbuf*) - Required - The image to set. The data is owned by the caller of the method.
```

--------------------------------

### Set Notification Hint (Byte)

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_hint_byte.html

Sets a hint with a byte value for a notification. Deprecated since 0.6. Use `notify_notification_set_hint()` instead.

```c
void
notify_notification_set_hint_byte (
  NotifyNotification* notification,
  const char* key,
  guchar value
)

```

--------------------------------

### NotifyNotificationset_hint_byte_array

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_hint_byte_array.html

Sets a hint with a byte array value. Deprecated since 0.6. Use `notify_notification_set_hint()` instead.

```APIDOC
## void notify_notification_set_hint_byte_array

### Description
Sets a hint with a byte array value.
The length of `value` must be passed as `len`.
Deprecated since: 0.6.
Use `notify_notification_set_hint()` instead.

### Method
void

### Endpoint
N/A

### Parameters
#### Path Parameters
N/A

#### Query Parameters
N/A

#### Request Body
N/A

### Request Example
N/A

### Response
#### Success Response (200)
N/A

#### Response Example
N/A

### Parameters
- **notification** (NotifyNotification*) - The notification.
- **key** (const char*) - The hint. The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string.
- **value** (guchar*) - The hint’s value. The length of the array is specified in the `len` argument. The data is owned by the caller of the method.
- **len** (gsize) - The length of the byte array.
```

--------------------------------

### NotifyNotification: Set String Hint

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_hint_string.html

Sets a hint with a string value for a notification. This function is deprecated and `notify_notification_set_hint` should be used instead.

```APIDOC
## void notify_notification_set_hint_string

### Description
Sets a hint with a string value.
Deprecated since: 0.6. Use `notify_notification_set_hint()` instead.

### Method
void

### Endpoint
N/A (This is a function call, not a REST endpoint)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (void)
None

#### Response Example
None

### Parameters
- **notification** (*NotifyNotification*) - The notification to set the hint on.
- **key** (*const char*) - Required - The hint key. The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string.
- **value** (*const char*) - Required - The hint’s value. The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string.
```

--------------------------------

### NOTIFY_ACTION_CALLBACK Macro

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.ACTION_CALLBACK.html

A convenience macro for casting a function to a NotifyActionCallback, similar to G_CALLBACK().

```APIDOC
## NOTIFY_ACTION_CALLBACK

### Description
A convenience macro for casting a function to a `NotifyActionCallback`. This is much like `G_CALLBACK()`. This function is not directly available to language bindings.

### Parameters
- **func** (-) - Required - The function to cast.
```

--------------------------------

### NotifyNotification Properties

Source: https://gnome.pages.gitlab.gnome.org/libnotify/class.Notification.html

Available properties for the NotifyNotification class.

```APIDOC
## Properties
- **app-icon** (string) - The icon of the application for the notification (since 0.8.4)
- **app-name** (string) - The name of the application for the notification (since 0.7.3)
- **body** (string) - The body of the notification
- **closed-reason** (int) - The closed reason of the notification
- **icon-name** (string) - The icon-name of the icon to be displayed on the notification
- **id** (int) - The Id of the notification
- **summary** (string) - The summary of the notification
```

--------------------------------

### NotifyNotificationadd_action

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.add_action.html

Adds an action to a notification. When the action is invoked, the specified callback function will be called, along with the value passed to user_data.

```APIDOC
## POST /notify_notification_add_action

### Description
Adds an action to a notification. When the action is invoked, the specified callback function will be called, along with the value passed to user_data.

### Method
POST

### Endpoint
/notify_notification_add_action

### Parameters
#### Path Parameters
- **notification** (NotifyNotification*) - Required - The notification to add the action to.

#### Query Parameters
- **action** (const char*) - Required - The action ID. The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string.
- **label** (const char*) - Required - The human-readable action label. The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string.
- **callback** (NotifyActionCallback) - Required - The action’s callback function.
- **user_data** (gpointer) - Optional - Optional custom data to pass to callback. The argument can be NULL. The data is owned by the caller of the method.
- **free_func** (GDestroyNotify) - Optional - An optional function to free user_data when the notification is destroyed.

### Request Example
{
  "notification": "NotifyNotification*",
  "action": "string",
  "label": "string",
  "callback": "NotifyActionCallback",
  "user_data": "gpointer",
  "free_func": "GDestroyNotify"
}

### Response
#### Success Response (200)
- **void** (void) - This function does not return a value.

#### Response Example
{
  "message": "Action added successfully"
}
```

--------------------------------

### NOTIFY_NOTIFICATION_HINT_URGENCY Constant

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_URGENCY.html

Defines the constant used to specify the urgency level of a notification.

```APIDOC
## Constant: NOTIFY_NOTIFICATION_HINT_URGENCY

### Description
The urgency level hint for a notification.

### Declaration
#define NOTIFY_NOTIFICATION_HINT_URGENCY "urgency"

### Hint Details
- **GVariantType**: GLib.VARIANT_TYPE_BYTE ('y')
```

--------------------------------

### NOTIFY_VERSION_MAJOR Constant

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.VERSION_MAJOR.html

Defines the major version component of the libnotify library.

```APIDOC
## NOTIFY_VERSION_MAJOR

### Description
Represents the major version component of the libnotify library (e.g., 1 if the version is 1.2.3).

### Declaration
#define NOTIFY_VERSION_MAJOR 0
```

--------------------------------

### Define NOTIFY_NOTIFICATION_HINT_SUPPRESS_SOUND

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_SUPPRESS_SOUND.html

Constant used to suppress sound in notifications. Requires a boolean GVariantType.

```c
#define NOTIFY_NOTIFICATION_HINT_SUPPRESS_SOUND "suppress-sound"
```

--------------------------------

### NotifyNotification:app-icon Property

Source: https://gnome.pages.gitlab.gnome.org/libnotify/property.Notification.app-icon.html

Details regarding the app-icon property used to set the application icon for a notification.

```APIDOC
## Property: app-icon

### Description
The icon of the application for the notification.

### Declaration
`property app-icon: utf8 [ read, write ]`

### Details
- **Type**: gchar*
- **Since**: 0.8.4
- **Default Value**: NULL
- **Setter Method**: notify_notification_set_app_icon()

### Flags
- **Readable**: yes
- **Writable**: yes
- **Construct**: no
- **Construct only**: no
```

--------------------------------

### NotifyNotificationset_hint_byte

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_hint_byte.html

Sets a hint with a byte value. This function is deprecated and notify_notification_set_hint() should be used instead.

```APIDOC
## void notify_notification_set_hint_byte ( NotifyNotification* notification, const char* key, guchar value )

### Description
Sets a hint with a byte value.
Deprecated since: 0.6.
Use `notify_notification_set_hint()` instead.

### Method
void

### Endpoint
N/A (Function signature)

### Parameters
#### Path Parameters
N/A

#### Query Parameters
N/A

#### Request Body
N/A

### Request Example
N/A

### Response
#### Success Response (200)
N/A

#### Response Example
N/A

### Parameters
- **notification** (NotifyNotification*) - The notification to set the hint on.
- **key** (const char*) - The hint key. The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string.
- **value** (guchar) - The hint's value.
```

--------------------------------

### NotifyNotification:summary Property

Source: https://gnome.pages.gitlab.gnome.org/libnotify/property.Notification.summary.html

The summary property represents the summary of the notification.

```APIDOC
## NotifyNotification:summary Property

### Description
The summary of the notification.

### Type
gchar*

### Flags
- Readable: yes
- Writable: yes
- Construct: yes
- Construct only: no

### Default Value
NULL
```

--------------------------------

### Set Double Hint for Notification

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_hint_double.html

Sets a hint with a double value on a notification. Deprecated since 0.6. Use notify_notification_set_hint() instead.

```c
void
notify_notification_set_hint_double (
  NotifyNotification* notification,
  const char* key,
  gdouble value
)

```

--------------------------------

### Define NOTIFY_NOTIFICATION_HINT_RESIDENT

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_RESIDENT.html

Constant used to indicate that a notification should remain resident after an action is invoked.

```c
#define NOTIFY_NOTIFICATION_HINT_RESIDENT "resident"
```

--------------------------------

### NOTIFY_NOTIFICATION_HINT_SUPPRESS_SOUND

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_SUPPRESS_SOUND.html

This hint can be used to request that the notification server suppress any associated sounds. It is typically used when the application itself will play a custom sound.

```APIDOC
## Constant: NOTIFY_NOTIFICATION_HINT_SUPPRESS_SOUND

### Description
Causes the server to suppress playing any sounds, if it has that ability. This is usually set when the client itself is going to play its own sound.
Hint `GVariantType`: GLib.VARIANT_TYPE_BOOLEAN (`b`).

### Declaration
```c
#define NOTIFY_NOTIFICATION_HINT_SUPPRESS_SOUND "suppress-sound"
```
```

--------------------------------

### Macro NOTIFY_CHECK_VERSION

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.CHECK_VERSION.html

Checks if the current libnotify version is equal to or greater than the specified major, minor, and micro version numbers.

```APIDOC
## NOTIFY_CHECK_VERSION

### Description
Check whether a version equal to or greater than `major.minor.micro` is present. This function is not directly available to language bindings.

### Parameters
- **major** (integer) - Required - Required major version.
- **minor** (integer) - Required - Required minor version.
- **micro** (integer) - Required - Required micro version.
```

--------------------------------

### notify_set_app_name

Source: https://gnome.pages.gitlab.gnome.org/libnotify/func.set_app_name.html

Sets the application name for libnotify notifications.

```APIDOC
## notify_set_app_name

### Description
Sets the application name.

### Parameters
- **app_name** (const char*) - Required - The name of the application. The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string.
```

--------------------------------

### void notify_notification_set_icon_from_pixbuf

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_icon_from_pixbuf.html

Sets the icon in the notification from a GdkPixbuf. This method is deprecated since 0.5.

```APIDOC
## void notify_notification_set_icon_from_pixbuf

### Description
Sets the icon in the notification from a GdkPixbuf. This method is deprecated since 0.5. Use notify_notification_set_image_from_pixbuf() instead.

### Parameters
- **notification** (NotifyNotification*) - Required - The notification object.
- **icon** (GdkPixbuf*) - Required - The icon to set. The data is owned by the caller of the method.
```

--------------------------------

### NOTIFY_NOTIFICATION_HINT_Y

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.NOTIFICATION_HINT_Y.html

Defines the Y-coordinate hint for notification positioning.

```APIDOC
## NOTIFY_NOTIFICATION_HINT_Y

### Description
Specifies the Y location on the screen that the notification should point to. The “x” hint must also be specified.

### Declaration
#define NOTIFY_NOTIFICATION_HINT_Y "y"

### Hint Type
- **GVariantType**: GLib.VARIANT_TYPE_INT32 ('i')
```

--------------------------------

### NotifyNotificationSetAppIcon

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_app_icon.html

Sets the application icon for a notification. If not called or if app_icon is NULL, the icon is set from notify_set_app_icon().

```APIDOC
## void notify_notification_set_app_icon ( NotifyNotification* notification, const char* app_icon )

### Description
Sets the application icon for the notification. If this function is not called or if `app_icon` is `NULL`, the application icon will be set from the value set via `notify_set_app_icon()`.
Available since: 0.8.4
Sets property| `Notify.Notification:app-icon`

### Method
void

### Endpoint
N/A (Function Signature)

### Parameters
#### Path Parameters
N/A

#### Query Parameters
N/A

#### Request Body
N/A

### Request Example
N/A

### Response
#### Success Response (200)
N/A

#### Response Example
N/A

### Parameters
- **notification** (*NotifyNotification*) - Description: Pointer to the NotifyNotification object.
- **app_icon** (*const char*) - Required/Optional - Description: The optional icon theme icon name or filename. The argument can be `NULL`. The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string.
```

--------------------------------

### notify_notification_set_app_name

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_app_name.html

Sets the application name for the notification. If not called, the name defaults to the value set in notify_init() or notify_set_app_name().

```APIDOC
## notify_notification_set_app_name

### Description
Sets the application name for the notification. If this function is not called or if app_name is NULL, the application name will be set from the value used in notify_init() or overridden with notify_set_app_name().

### Parameters
- **notification** (NotifyNotification*) - Required - The notification object.
- **app_name** (const char*) - Optional - The localised application name. Can be NULL.
```

--------------------------------

### NotifyEXPIRES_DEFAULT Macro Definition

Source: https://gnome.pages.gitlab.gnome.org/libnotify/const.EXPIRES_DEFAULT.html

Defines the default expiration time for notifications. A value of -1 indicates the system's default behavior.

```c
#define NOTIFY_EXPIRES_DEFAULT -1
```

--------------------------------

### notify_notification_get_activation_token

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.get_activation_token.html

Retrieves the activation token associated with a notification, typically used within a NotifyActionCallback.

```APIDOC
## notify_notification_get_activation_token

### Description
Gets the activation token of the notification. If an action is currently being activated, it returns the activation token. This function is intended to be used in a NotifyActionCallback to get the activation token for the activated action, if the notification daemon supports it.

### Parameters
- **notification** (NotifyNotification*) - Required - The notification instance.

### Return Value
- **Type**: const char*
- **Description**: The current activation token, or NULL if none. The returned data is owned by the instance. The value is a NUL terminated UTF-8 string.
```

--------------------------------

### NotifyNotification:icon-name Property

Source: https://gnome.pages.gitlab.gnome.org/libnotify/property.Notification.icon-name.html

Details regarding the icon-name property used to set the icon displayed on a notification.

```APIDOC
## Property: icon-name

### Description
The icon-name of the icon to be displayed on the notification.

### Declaration
property icon-name: utf8 [ read, write, construct ]

### Details
- **Type**: gchar*
- **Default value**: NULL
- **Readable**: yes
- **Writable**: yes
- **Construct**: yes
- **Construct only**: no
```

--------------------------------

### NotifyNotification::closed Signal Declaration

Source: https://gnome.pages.gitlab.gnome.org/libnotify/signal.Notification.closed.html

The signature for the closed signal callback function.

```C
void
closed (
  NotifyNotification* self,
  gpointer user_data
)
```

--------------------------------

### notify_notification_set_hint_int32

Source: https://gnome.pages.gitlab.gnome.org/libnotify/method.Notification.set_hint_int32.html

Sets a 32-bit integer hint for a notification. Note that this function is deprecated since version 0.6.

```APIDOC
## notify_notification_set_hint_int32

### Description
Sets a hint with a 32-bit integer value. This function is deprecated since 0.6; use notify_notification_set_hint() instead.

### Parameters
- **notification** (NotifyNotification*) - Required - The notification object.
- **key** (const char*) - Required - The hint key. The data is owned by the caller and must be a NUL terminated UTF-8 string.
- **value** (gint) - Required - The 32-bit integer value for the hint.
```
Tokens:
Raw