15. GlossaryΒΆ

The Catalog is the name of the internal database of Keypirinha where all the items are indexed to allow a quick search.
The class name of an item.

The Console window gives access to the output of application’s log. It should be your first destination in case of error or unexpected behavior to check if a plugin emitted a informational/warning/error message.

It also gives you an interactive access to the embedded Python interpreter.

|project|'s Console

Keypirinha allows the code source of its packages to be modified at runtime by automatically reloading them every time a modification is done.

The InstanceID number is an unsigned integer internally managed by the application and assigned at runtime to each package, each time they are (re)loaded.

It is also used to ensure only the latest instance of a given package has write access to its section of the Catalog.

Read Overview for more information.

An item is the data unit of the Catalog (Keypirinha‘s internal database). It is a simple data structure, created by the plugins, that has some properties like a display name (label), a category (File, URL, Command Line, ...), a reference to the parent plugin, etc...

The L(a)unchBox is Keypirinha‘s main dialog window, from which you can make a search and launch the selected item. It can be opened by pressing the Ctrl+Win+K combination (by default).

More info in the First steps chapter.

|project|'s LaunchBox

A Package is a container of one or several plugins and that represents a unique feature visible to the user.

This container holds the source code of its plugins, their dependencies, a default configuration file, if any, and optionally some documentation.

Its content can be stored in a directory or packed in an archive to ease its redistribution (i.e. a *.keypirinha-package file, which is actually a regular zip archive).

Read Packages Structure for more information.

In the context of Keypirinha, a Plugin is a software component written in Python3 that extends the base features of the application. It is always encapsulated in a package.
A Repository is a directory dedicated to the storage of packages. It also defines the way Packages are stored (i.e.: loose files or packed in a single archive).