Application Launcher

An OVOS skill that launches and closes applications on the Linux desktop by voice.

NOTE: This skill works only on Linux desktop environments.

Install

pip install ovos-skill-application-launcher

About

The skill scans the standard directories for .desktop files. It reads application names and execution commands from these files.

Scanned folders:

/usr/share/applications/
/usr/local/share/applications/
~/.local/share/applications/

Examples

"Open Volume Control"
"Launch Firefox"
"Close Firefox"

Multiple instances of the same application

On Wayland systems, window control is not available. The skill closes apps only by ending running processes.

On X systems, the launcher closes windows before ending processes, if wmctrl is on your system.

This gives more granular control. You can manage multiple instances of an application, such as several Firefox windows, individually, even if they share the same PID.

If several processes with different PIDs match an application, the skill closes only the most recent one by default. You can turn on the old behavior, which ends all matching processes instead.

Configuration via `settings.json`

To customize the behavior of the Application Launcher skill, you can modify the following options in the settings.json file:

Option	Type	Default Value	Description
`aliases`	`Dict[str, List[str]]`	`{"kcalc": ["calculator"]}`	Defines application aliases. Use application names from the `.desktop` file as keys and a list of speech-friendly names as values.
`user_commands`	`Dict[str, str]`	`{}`	User-defined application commands. Map application names to their corresponding bash commands.
`thresh`	`float`	`0.85`	The threshold for string matching. Lower values will allow more lenient matches for application names.
`skip_categories`	`List[str]`	`["Settings", "ConsoleOnly", "Building"]`	Categories in desktop files that exclude application from being considered.
`skip_keywords`	`List[str]`	`[]`	Keywords in desktop files that exclude application from being considered.
`target_categories`	`List[str]`	`[]`	Categories in desktop files required for application to be considered.
`target_keywords`	`List[str]`	`[]`	Keywords in desktop files required for application to be considered.
`blacklist`	`List[str]`	`[]`	List of applications to ignore during scanning (application names from the `.desktop` file).
`require_icon`	`bool`	`True`	If set to `True`, only include applications that have an icon defined in their `.desktop` file.
`require_categories`	`bool`	`True`	If set to `True`, only include applications that have at least one category defined in their `.desktop` file.
`terminate_all`	`bool`	`False`	If `True`, will terminate all matching processes when closing applications.
`shell`	`bool`	`False`	If `True`, allows commands to be executed in a shell environment.
`disable_window_manager`	`bool`	`False`	If `True`, ignores `wmctl` and exclusively uses running processes for managing apps

eg.

{
  "aliases": {
    "kcalc": ["calculator"]
  },
  "thresh": 0.85,
  "skip_categories": ["Settings", "ConsoleOnly", "Building"],
  "terminate_all": true
}

License

Apache-2.0

Release files for ovos-skill-application-launcher 0.13.4a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ovos-skill-application-launcher 0.13.4a1
File	Size	Uploaded
ovos_skill_application_launcher-0.13.4a1.tar.gz	31.6 kB	Sep 26, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ovos-skill-application-launcher 0.13.4a1
File	Interpreter	ABI	Platform	Reset
ovos_skill_application_launcher-0.13.4a1-py3-none-any.whl 53.8 kB Sep 26, 2026	Python 3	none	any	Details

Total release size: 85.4 kB

Release files / ovos_skill_application_launcher-0.13.4a1.tar.gz

Download URL	ovos_skill_application_launcher-0.13.4a1.tar.gz
Size	31.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`030e4ce415456553044fdf23fc9f2e5144c6ed67492d152baa3a6720bff9683c`
BLAKE2b-256 checksum How to use checksums	`74dc22bc65d55cd9e8d0a79ac06473829e862153110786e96e35e7c74c015ad0`
Upload date	Sep 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / ovos_skill_application_launcher-0.13.4a1-py3-none-any.whl

Download URL	ovos_skill_application_launcher-0.13.4a1-py3-none-any.whl
Size	53.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2167d553e3ae3cc0d6dc8d1e2a689349b64464b2b9a036373f1aad2b2abd6bee`
BLAKE2b-256 checksum How to use checksums	`fe6ab9c9cf816cea4c064908b34e68d02978112dbf96ad902db7d0cdd4e743de`
Upload date	Sep 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`