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.0a2.tar.gz (22.3 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.0a2.tar.gz.

File metadata

File hashes

Hashes for ovos_skill_application_launcher-0.6.0a2.tar.gz
Algorithm Hash digest
SHA256 44642c663a66667f4df751b33367db1151966306caf3161c8a896ad277509ec3
MD5 094f793676573ac93ada0b17bea0d943
BLAKE2b-256 8514df1e22fe098fbd7b1a696beb947f50e19cbe62213f7a0aedd31ab4b746a0

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for ovos_skill_application_launcher-0.6.0a2-py3-none-any.whl
Algorithm Hash digest
SHA256 415efff7c0361d1b58a8be5d09ed6c364c19c5107e383ed933eb2f76c42fe402
MD5 787a6051bb6c5d0659a806d99667acb3
BLAKE2b-256 5a38d72d038f829007a6a8d130ce2819ce72e6c04c29436dcd6f68467e14d231

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.6.0a2 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