Metadata-Version: 2.1
Name: plover-per-application-state
Version: 1.2.1
Summary: Plover plugin to make translation state function per application window and tab
Home-page: https://github.com/Pipatooa/plover-per-application-state
Author: Pipatooa
Author-email: pipatooa@pipatooa.co.uk
Keywords: plover plover_plugin
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# Plover Per-Application State
Plover plugin to make translation state function per application window and tab.

> **DISCLAIMER:** This plugin is still WIP and *will* cause Plover to function incorrectly under some circumstances.

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

- > Run: `<exe_name> -s plover_plugins install -e plover-per-application-state`

    The [plover-application-controls](https://github.com/Pipatooa/plover-application-controls) plugin should be installed automatically as a dependency.


- Restart Plover.

- Configure > Plugins > Enable both `application_controls` and `per_application_state`.

To disable the plugin at any point, disable `per_application_state`.

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

## Commands:

The `{PLOVER:per_application_state}` command can be used to control state management. It takes a subcommand as its first argument,
with further arguments separated by `:`.

For example, `{PLOVER:per_application_state:clear_all}` will clear all state.

| Window Command | Description                                                                    | Arguments | 
|----------------|--------------------------------------------------------------------------------|-----------|
| clear          | Clear the translation state for the current window tab                         |           |
| clear_all      | Clears the current and stored translation states for all windows               |           |
| clear_window   | Clears the current and stored translation states for the current active window |           |
