From 2db92d6fed89a74a7e83a876816db8b14c87b1ce Mon Sep 17 00:00:00 2001 From: David Daily Date: Tue, 26 Jan 2021 10:57:13 -0600 Subject: [PATCH] Update 'README.md' --- README.md | 43 ++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 42 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f0a587c..90b29b8 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,44 @@ # luxAHKfor -lets you use the Luxafor API with AHK \ No newline at end of file +## Overview +This AHK script simply interacts with the API, not directly interacting with the flag. + +## Usage +The recommended way to use this is to launch it with command line parameters. I wouldn't advise `#Include`ing it since it contains quite a few `ExitApp`s. + +**[How to launch with command line parameters documentation](https://www.autohotkey.com/docs/Scripts.htm#cmd)** + +**How to do it from within AHK** +`Run %A_AhkPath% "flag.ahk" "param" "param" "param"` + +## Parameter format +[Everything listed here is an option](https://luxafor.helpscoutdocs.com/article/25-webhook-api-basics-and-guidelines) + +### Start with the type of action you want: + +| Action | Parameter | +| --- | --- | +| Solid | `s` | +| Blink | `b` | +| Pattern | `p` | + +### Next do the color: + +| Action | Available Colors | +| --- | --- | +| Solid | `red, green, yellow, blue, white, cyan, magenta, 6 symbol hex color code`| +| Blink | `red, green, yellow, blue, white, cyan, magenta` | +| Pattern | `police, traffic_lights, random (picks one of the following random ones at random), random1, random2, random3, random4, random5`
Additional patterns accepted on Windows only: `rainbow, sea, white_wave, synthetic` | + +### Optional: How long to do that action + +Just specify how long you want it to hold said action in seconds. I haven't tested out decimals, but it isn't that exact anyway, takes a few seconds to turn on the light as is. + +If you don't specify this for solid colors it will just tell it to go to that color and end. If you don't set it for blinking or patterns it goes on for 1000000 seconds (11.57 days, so essentially until the script gets stopped) + +## Examples +`Run %A_AhkPath% "flag.ahk" "b" "red" "10"` + +`Run %A_AhkPath% "flag.ahk" "p" "police"` + +`Run %A_AhkPath% "flag.ahk" "s" "magenta" "35"` \ No newline at end of file