Skip to content

Commit

Permalink
Update readme to point to new documentation website (#63)
Browse files Browse the repository at this point in the history
Fixes #57
  • Loading branch information
neilenns authored Jan 6, 2025
1 parent a4d7182 commit 9515608
Show file tree
Hide file tree
Showing 10 changed files with 3 additions and 69 deletions.
70 changes: 2 additions & 68 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,72 +8,6 @@
This Stream Deck plugin provides actions to interact with [vATIS](https://vatis.app/) running on your local machine.
[Download the plugin from the releases page](https://github.com/neilenns/streamdeck-vatis/releases/latest).

Do you use TrackAudio when controlling? Check out the companion [Stream Deck actions for TrackAudio](https://marketplace.elgato.com/product/trackaudio-e913a0ca-4c12-411d-a5a6-acf5f6c4bdea).

## Action descriptions

| Action | Description |
| ------------ | -------------------------------------------------------------------- |
| ATIS letter | Shows the current ATIS letter and altimeter for a specific station. |
| vATIS status | Shows the current state of the connection to vATIS from Stream Deck. |

After installation the plugin actions are available under the vATIS category:

![Screenshot of the Stream Deck profile UI with the vATIS category open](docs/images/streamdeck-category.png)

## Configuring an ATIS letter action

The ATIS letter action displays the station name, current AITS letter, and current altimeter
for a single station in vATIS.

Pressing the action clears the new ATIS indicator in vATIS and on the action. A long press of the action clears the new ATIS indicator on all stations in vATIS.

By default the pressure displays in white. For pressure reported in inches of mercury,
if the value falls below 29.92 the value will show in red as a reminder that FL180 (or FL190,
depending on the altimeter value) are be unusable.

For example, if you have published a combined ATIS at KLMT in vATIS you can configure an action
like this to display the information on your Stream Deck:

![Screnshot of an ATIS letter action configuration, with the title and callsign set to KPDX and the type set to Combined.](docs/images/atis-letter.png)
[Read the documentation](https://projects.neilenns.com/docs/streamdeck-vatis) for information on how to set up actions and examples of common configurations.

### ATIS letter settings <!-- omit from toc -->

| Setting | Description | Default |
| ----------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Title | The title to show on the action. Optional. | Blank |
| Station | The name of the station you want to display status for. Required. | |
| Type | The type of the station. | Combined |
| Current | The image to display when the ATIS letter shown is current. Optional. | ![Black background, white text](docs/images/atis-connected.png) ![Black background, white text, red text for pressure](docs/images/atis-warning.png) |
| Unavailable | The image to display when there is no connection to vATIS. Optional. | ![Black background, "ATIS" for letter, grey text](docs/images/atis-notconnected.png) |
| Updated | The image to display when the ATIS letter updated to a new one. Optional. | ![Orange background, white text](docs/images/atis-updated.png) |

The default display automatically includes the station name, ATIS letter, and altimeter. When specifying
custom images the following advanced settings can be used to display text on the action:

| Setting | Description | Default |
| -------------- | ---------------------------------- | ------- |
| Show altimeter | Shows the altimeter on the action. | false |
| Show letter | Shows the letter on the action. | false |
| Show title | Shows the title on the action. | false |
| Show wind | Shows the wind on the action. | false |

## Configuring a vATIS status action

The vATIS status action shows the status of the connection between Stream Deck and vATIS.
A long press of the action will force a refresh of all the Stream Deck vATIS actions.

## vATIS status action settings <!-- omit from toc -->

| Setting | Description | Default |
| ------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| Title | The title to show on the action. Optional. | Blank |
| Connected | The image to display when connected to vATIS. Optional. | ![Orange sun with grey cloud, black background](docs/images/vatis-connected.png) |
| Not connected | The image to display when not connected to vATIS. Optional. | ![Cloud and sun outlined in grey, black background](docs/images/vatis-notconnected.png) |
| Show title | Shows the title on the action. | false |

## SVG templates

All image properties support SVG templates using [Handlebars](https://handlebarsjs.com/). This enables using a single SVG image across multiple
actions that respond to state changes. For more information on the available template variables see the
[documentation on the wiki](https://github.com/neilenns/streamdeck-vatis/wiki/SVG-templates).
Do you use TrackAudio when controlling? Check out the companion [Stream Deck actions for TrackAudio](https://marketplace.elgato.com/product/trackaudio-e913a0ca-4c12-411d-a5a6-acf5f6c4bdea).
2 changes: 1 addition & 1 deletion com.neil-enns.vatis.sdPlugin/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@
"Description": "Provides actions for displaying current ATIS information from vATIS.",
"Icon": "images/plugin/pluginIcon",
"SDKVersion": 2,
"URL": "https://github.com/neilenns/streamdeck-vatis",
"URL": "https://projects.neilenns.com/docs/streamdeck-vatis/",
"Software": {
"MinimumVersion": "6.4"
},
Expand Down
Binary file removed docs/images/atis-connected.png
Binary file not shown.
Binary file removed docs/images/atis-letter.png
Binary file not shown.
Binary file removed docs/images/atis-notconnected.png
Binary file not shown.
Binary file removed docs/images/atis-updated.png
Binary file not shown.
Binary file removed docs/images/atis-warning.png
Binary file not shown.
Binary file removed docs/images/streamdeck-category.png
Binary file not shown.
Binary file removed docs/images/vatis-connected.png
Binary file not shown.
Binary file removed docs/images/vatis-notconnected.png
Binary file not shown.

0 comments on commit 9515608

Please sign in to comment.