node-red-contrib-awtrix-epl-live 0.4.4 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -16,27 +16,24 @@ default is no icon
16
16
 
17
17
  Double-click the node and set:
18
18
 
19
- - **Tracked teams** - a JSON array of team names,
20
- matching ESPN's `displayName` exactly (case-insensitive).
21
-
19
+ - **Tracked teams**
20
+ A JSON array of team names (case-insensitive).
22
21
  ```json
23
- ["Liverpool", "Manchester City", "Chelsea"]
22
+ ["Liverpool", "Manchester City", "Crystal Palace", "Aston Villa"]
24
23
  ```
25
24
 
26
- If a name doesn't match anything ESPN returns for the EPL,
27
- a warning is logged to the debug sidebar and that team is skipped -
28
- check spelling against ESPN's own team names if a team isn't being
29
- tracked as expected.
30
- Examples of _valid_ teams names that are normally abbreiviated::
31
- > ```Wolverhampton Wanderers, Tottenham Hotspur, Brighton & Hove Albion```
25
+ Team names have been relaxed and more common names are also accepted
26
+ ```json
27
+ ["lfc", "man city", "palace", "villa"]
28
+ ```
32
29
 
33
- - **Additional competitions**
30
+ * **Additional competitions**<br>
34
31
  True / False in the dialog options will include or exclude team tracking
35
32
  for UEFA competitions.
36
33
 
37
- - `Champions League`
38
- - `Europa League`
39
- - `Europa Conference League`
34
+ * `Champions League`.
35
+ * `Europa League`.
36
+ * `Europa Conference League`.
40
37
 
41
38
  - **Goals icon** (`goalsIcon`) - icon ID used for goal, penalty goal, own
42
39
  goal, and disallowed goal notifications. `0` (default) means no icon is
@@ -57,17 +54,11 @@ Double-click the node and set:
57
54
  | `43844` | red card |
58
55
 
59
56
 
60
- - **Minimum brightness**
61
- Your Awtrix device brightness has a direct effect on how visible certain text
62
- colours are to read and darker palette colours can also be difficult to
63
- view on the display.
64
- The `minimum brightness` dialogue setting is a 'perceived colour' brightness
65
- value used to determine if a team colour will be readable on your Awtrix display.
66
- All teamname colours are evaluated against this setting, primary and alternate
67
- colours are tested in order, if they fall below this threshold and fail the test
68
- the team name colour falls back to '#FFFFFF'
69
- The default value for this setting is `30`, if you find text colours difficult
70
- to read or too many teams names displayed in white then increase this number.
57
+ - **Minimum brightness**<br>
58
+ Your Awtrix device brightness has a direct effect on how readable certain text colours are and darker palette colours can be difficult to view on the display.<br>
59
+ The `minimum brightness` dialogue setting is a 'perceived colour' brightness value used to determine if a team colour will be readable on your Awtrix display.<br>
60
+ All team name colours are evaluated against this value, primary and alternate colours are tested in order, if they fall below this threshold and fail the test the team name colour falls back to '#FFFFFF'.<br>
61
+ The default value for this setting is `30`. If you find text colours difficult to read or too many team names displayed in white, increase this number.
71
62
 
72
63
  ## Outputs
73
64
 
@@ -78,15 +69,14 @@ This node has three outputs, wire your own downstream nodes to these
78
69
  `msg.payload` is one of: `"goal"`, `"disallowed goal"`, `"red card"`,
79
70
  or `"full time"`. Penalties and own goals are also reported as `"goal"`
80
71
  on this output. The distinction between `goal` events is only reported
81
- by pin #2 & pin #3..
72
+ by pin #2 & pin #3.
82
73
 
83
74
  Wire a `switch` node off this output to route each event type to your
84
75
  own desired trigger.
85
76
 
86
- Here is an **Alexa Ready** audio clip you can use for **"GOAL"** events to get you started
87
- ```
88
- "<audio src='https://nr-alexa-sounds.s3.eu-west-2.amazonaws.com/goal.mp3'/>"
89
- ```
77
+ Here is an **Alexa Ready** audio clip you can use for **"GOAL"** events to get you started<br>
78
+ ```"<audio src='https://nr-alexa-sounds.s3.eu-west-2.amazonaws.com/goal.mp3'/>"```
79
+
90
80
 
91
81
  **Output pin #2 - AWTRIX 3 payload**
92
82
 
@@ -101,35 +91,20 @@ Wire this pin straight to one or more `mqtt out` nodes pointed at your AWTRIX 3
101
91
 
102
92
  ## internally
103
93
 
104
- - **Tracked team colours**
94
+ - **Tracked team colours**<br>
95
+ Primary & secondary team colours are assessed independently.<br>
96
+ Home team first to determine if the primary colour is deemed too dark or not viable for AWTRIX (see **Minimum brightness**).<br>
97
+ Away team colours are assessed in the same manner and checked against the home team resolved colour to avoid the two clashing.
105
98
 
106
- Primary & secondary team colours are assessed independently.
107
- Home team is assessed first:
108
- If the primary colour is deemed too dark or not viable for
109
- AWTRIX (see **Minimum brightness** above), the alternate is
110
- used, if that fails the fallback is to default to `#FFFFFF`.
111
- Away team colours:
112
- Also assessed in the same manner and also checked against
113
- the home teams resolved colour to avoid the two clashing.
114
-
115
- - **Node Status**
116
-
117
- The node will show any upcoming matches for tracked teams:
99
+ - **Node Status**<br>
100
+ The node will show any upcoming matches for tracked teams only:
118
101
 
119
102
  - **"nothing upcoming"** - none of your tracked teams have any immediate matches.
120
- - **"next match xxxx-xx-xx"** - date of the next match from your tracked teams.
103
+ - **"next match xxxx-xx-xx"** - date of the next match from your tracked teams list.
121
104
  - **"kick off shortly"** - a match is about to begin.
122
105
  - **"live - in play"** - match underway and actively polling for live data.
123
- <br>
124
- - **Block event dispatch queue**
125
-
126
- block delivery of payloads, designed so multiple
127
- events don't overwrite each other.
128
-
129
- finished matches are removed 60+ minutes after fulltime
130
106
 
131
107
  ## Known limitations
132
108
 
133
109
  **Currently** team names are *ONLY* resolved against the Premier League.
134
110
  Non EPL teams cannot currently be added to Tracked Teams by name.
135
-
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "node-red-contrib-awtrix-epl-live",
3
- "version": "0.4.4",
3
+ "version": "0.5.0",
4
4
  "description": "awtrix live football",
5
5
  "author": "evans.l",
6
6
  "license": "MIT",