https://github.com/pipatooa/plover-application-dictionary

Plover dictionary entries based on the current focussed application
https://github.com/pipatooa/plover-application-dictionary

plover plover-dictionary plover-plugins

Last synced: about 10 hours ago
JSON representation

Plover dictionary entries based on the current focussed application

• Host: GitHub
• URL: https://github.com/pipatooa/plover-application-dictionary
• Owner: Pipatooa
• License: gpl-3.0
• Created: 2023-02-10T08:20:46.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-02-21T23:08:04.000Z (over 1 year ago)
• Last Synced: 2024-09-23T18:05:22.971Z (4 days ago)
• Topics: plover, plover-dictionary, plover-plugins
• Language: Python
• Homepage: https://pypi.org/project/plover-application-dictionary/
• Size: 25.4 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Plover Application Dictionary

Plover dictionary entries based on the current focussed application.

This plugin has two dictionary types `.ad` and `.mad`, for defining single or multiple application dictionaries 

respectively. The first is not readonly, allowing for entries to be added through Plover, but `.mad` dictionaries are

readonly. Both have to be edited to change which applications the entries within the dictionary 

## Installation

- Navigate to the installation directory for Plover and open a terminal / command prompt.

- > Run: ` -s plover_plugins install -e plover-application-dictionary`

    The [plover-application-controls](https://github.com/Pipatooa/plover-application-controls) plugin should be 

    installed automatically as a dependency.

- Restart Plover.

- Configure > Plugins > Enable `application_controls`.

Disabling `application_controls` will prevent the plugin from being able to detect the currently active window.

## Dictionaries:

Dictionaries can match applications using three properties, `app`, `class` and `title`. `title` *should* be consistent

between platforms, whereas `class` and `app` will depend across platforms and specific user installations. To find an

application's `app` or `class`, see

[plover-application-controls meta actions](https://github.com/Pipatooa/plover-application-controls#meta-actions). 

`class` is only available on some Linux systems.

Matching supports full Regex. An empty string will match anything.

The following is an example dictionary which only activates when Discord or Firefox is active. Implementation from

system to system may vary.

#### Example.ad:

```json

{

  "app": "",

  "class": "discord|Navigator",

  "title": "",

  "entries": {

    ...

  }

}

```

The following is an example dictionary which defines separate entries depending on the user being messaged on Discord.

#### Example.mad:

```json

[

  {

    "app": "",

    "class": "discord",

    "title": "@User1 - Discord",

    "entries": {

      ...

    }

  },

  {

    "app": "",

    "class": "discord",

    "title": "@User2 - Discord",

    "entries": {

      ...

    }

  }

]

```