libunique

About

Unique is a library for writing single instance application. If you launch a single instance application twice, the second instance will either just quit or will send a message to the running instance.

Unique makes it easy to write this kind of applications, by providing a base class, taking care of all the IPC machinery needed to send messages to a running instance, and also handling the startup notification side.

Unique aims to replace the BaconMessageConnection code that has been copied by many projects and the code using Bonobo and D-Bus.

As of GNOME 2.26, Unique is a GNOME blessed external dependency.

As of GNOME 2.28, these are the projects using LibUnique.

Features

• simple API, easy to subclass
• custom commands
• bidirectional communication channel
• signal based
• commodity API for sending raw data, plain text and URI lists
• multiple backends (changeable at runtime)
• released under LGPLv2.1
• fully documented

Development

• main git repository available: git clone git://git.gnome.org/unique (Browse Online)

• Bugzilla: Enter a new bug for LibUnique, or Browse the bug list

Releases

• Latest release: 1.1.6 (download)

Example Code

• /Example - Simple example code showing how to create a single instance application using LibUnique