{"id":21081760,"url":"https://github.com/openvoiceos/ovos-skill-application-launcher","last_synced_at":"2025-05-16T09:31:03.031Z","repository":{"id":114495692,"uuid":"438040578","full_name":"OpenVoiceOS/ovos-skill-application-launcher","owner":"OpenVoiceOS","description":"launch applications by voice","archived":false,"fork":false,"pushed_at":"2024-10-19T11:03:09.000Z","size":85,"stargazers_count":2,"open_issues_count":3,"forks_count":2,"subscribers_count":7,"default_branch":"dev","last_synced_at":"2024-10-21T05:22:42.579Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenVoiceOS.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-13T22:13:24.000Z","updated_at":"2024-10-19T11:03:00.000Z","dependencies_parsed_at":"2024-03-14T21:55:45.471Z","dependency_job_id":"bec40bbf-468b-40e7-9a8e-c496a635ceb5","html_url":"https://github.com/OpenVoiceOS/ovos-skill-application-launcher","commit_stats":null,"previous_names":["openvoiceos/skill-ovos-application-launcher"],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-skill-application-launcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-skill-application-launcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-skill-application-launcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-skill-application-launcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenVoiceOS","download_url":"https://codeload.github.com/OpenVoiceOS/ovos-skill-application-launcher/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225419610,"owners_count":17471434,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-19T20:10:50.804Z","updated_at":"2024-11-19T20:10:51.348Z","avatar_url":"https://github.com/OpenVoiceOS.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src='https://rawgithub.com/FortAwesome/Font-Awesome/master/svgs/solid/spinner.svg' card_color='#22a7f0' width='50' height='50' style='vertical-align:bottom'/\u003e Application Launcher\n\nApplication Launcher\n\n\u003e **NOTE**: this skill only works on Linux desktop environments!\n\n## About\n\nLaunch applications on the Linux desktop\n\nThe standard directories will be scanned for [.desktop files](https://wiki.archlinux.org/title/desktop_entries),\napplication names and execution commands will be parsed from there\n\nScanned folders:\n\n- /usr/share/applications/\n- /usr/local/share/applications/\n- ~/.local/share/applications/\n\n## Examples\n\n* \"Open Volume Control\"\n* \"Launch Firefox\"\n* \"Close Firefox\"\n\n### Multiple instances of same Application\n\nIn Wayland systems window control is not available and apps are closed exclusively by terminating running processes\n\nIn X systems, the launcher prioritizes closing windows over terminating processes if `wmctrl` is available in your system\n\nThis 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\n\nIf 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.\n\n## Configuration via `settings.json`\n\nTo customize the behavior of the Application Launcher skill, you can modify the following options in the `settings.json` file:\n\n| Option                   | Type                   | Default Value                             | Description                                                                                                                        |\n|--------------------------|------------------------|-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|\n| `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. |\n| `user_commands`          | `Dict[str, str]`       | `{}`                                      | User-defined application commands. Map application names to their corresponding bash commands.                                     |\n| `thresh`                 | `float`                | `0.85`                                    | The threshold for string matching. Lower values will allow more lenient matches for application names.                             |\n| `skip_categories`        | `List[str]`            | `[\"Settings\", \"ConsoleOnly\", \"Building\"]` | Categories in desktop files that exclude application from being considered.                                                        |\n| `skip_keywords`          | `List[str]`            | `[]`                                      | Keywords in desktop files that exclude application from being considered.                                                          |\n| `target_categories`      | `List[str]`            | `[]`                                      | Categories in desktop files required for application to be considered.                                                             |\n| `target_keywords`        | `List[str]`            | `[]`                                      | Keywords in desktop files required for application to be considered.                                                               |\n| `blacklist`              | `List[str]`            | `[]`                                      | List of applications to ignore during scanning (application names from the `.desktop` file).                                       |\n| `require_icon`           | `bool`                 | `True`                                    | If set to `True`, only include applications that have an icon defined in their `.desktop` file.                                    |\n| `require_categories`     | `bool`                 | `True`                                    | If set to `True`, only include applications that have at least one category defined in their `.desktop` file.                      |\n| `terminate_all`          | `bool`                 | `False`                                   | If `True`, will terminate all matching processes when closing applications.                                                        |\n| `shell`                  | `bool`                 | `False`                                   | If `True`, allows commands to be executed in a shell environment.                                                                  |\n| `disable_window_manager` | `bool`                 | `False`                                   | If `True`, ignores `wmctl` and exclusively uses running processes for managing apps                                                |\n\neg.\n\n```json\n{\n  \"aliases\": {\n    \"kcalc\": [\"calculator\"]\n  },\n  \"thresh\": 0.85,\n  \"skip_categories\": [\"Settings\", \"ConsoleOnly\", \"Building\"],\n  \"terminate_all\": true\n}\n```\n\n## Category\n\n**Productivity**\n\n## Tags\n\n#desktop\n#desktop-launch\n#desktop-launcher\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenvoiceos%2Fovos-skill-application-launcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenvoiceos%2Fovos-skill-application-launcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenvoiceos%2Fovos-skill-application-launcher/lists"}