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 +27 -52
- package/images/awtrix-epl.png +0 -0
- package/package.json +1 -1
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**
|
|
20
|
-
|
|
21
|
-
|
|
19
|
+
- **Tracked teams**
|
|
20
|
+
A JSON array of team names (case-insensitive).
|
|
22
21
|
```json
|
|
23
|
-
["Liverpool", "Manchester City", "
|
|
22
|
+
["Liverpool", "Manchester City", "Crystal Palace", "Aston Villa"]
|
|
24
23
|
```
|
|
25
24
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
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
|
-
|
|
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
|
-
|
|
38
|
-
|
|
39
|
-
|
|
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
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
The
|
|
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
|
-
|
|
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
|
-
|
|
107
|
-
|
|
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
|
-
|
package/images/awtrix-epl.png
CHANGED
|
Binary file
|