Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Application Launcher

Application Launcher

NOTE: this skill only works on Linux desktop environments!

About

Launch applications on the Linux desktop

The standard directories will be scanned for .desktop files, application names and execution commands will be parsed from there

Scanned folders:

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

Examples

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

Multiple instances of same Application

In Wayland systems window control is not available and apps are closed exclusively by terminating running processes

In X systems, the launcher prioritizes closing windows over terminating processes if wmctrl is available in your system

This provides a more granular control, allowing multiple instances of applications (such as several Firefox windows) to be managed individually. Even if they share the same PID

If multiple processes with different PIDs match a specific application, it will only close the most recent one by default. However, users can opt for the old behavior, which allows the option to kill all matching processes.

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
}

Category

Productivity

Tags

#desktop #desktop-launch #desktop-launcher

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ovos_skill_application_launcher-0.6.0a3.tar.gz (22.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file ovos_skill_application_launcher-0.6.0a3.tar.gz.

File metadata

File hashes

Hashes for ovos_skill_application_launcher-0.6.0a3.tar.gz
Algorithm Hash digest
SHA256 219bf7bc1589375c9b2235d232d776ce43be5dac8d91ee4c15e899f5310afb90
MD5 a5b1164544651e7d2a282b20b287be78
BLAKE2b-256 cebe876d3130eae66e0bfdacd56a6ac7576163ba578e441478a9f16c7aefdc1b

See more details on using hashes here.

File details

Details for the file ovos_skill_application_launcher-0.6.0a3-py3-none-any.whl.

File metadata

File hashes

Hashes for ovos_skill_application_launcher-0.6.0a3-py3-none-any.whl
Algorithm Hash digest
SHA256 c2d5955a15c59e3b2e2a1dfea35cd5aef6a31bfdc73d50d3e63e0fafdf9f0377
MD5 48e919b69fdca022b527fef9882d69e2
BLAKE2b-256 0acba07ce68940ae82cb66d33fd8d70ed16829ac8a369d2b93b773b1c52b2220

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.6.0a3 This release

2 files

0.5.14

2 files

0.5.13

2 files

0.5.12

2 files

0.5.11

2 files

0.5.10

2 files

0.5.9

2 files

0.5.8

2 files

0.5.7

2 files

0.5.6

2 files

0.5.5

2 files

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.0

2 files

0.3.4

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.1

2 files

0.1.0

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page