mirror of
https://github.com/opelly27/streetmerchant.git
synced 2026-05-20 06:27:38 +00:00
feat(docs): add mkdocs
This commit is contained in:
@@ -0,0 +1,29 @@
|
||||
# Application
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `AUTO_ADD_TO_CART` | Enable auto add to cart on support stores, default: `true` |
|
||||
| `BROWSER_TRUSTED` | Skip Chromium Sandbox. Useful for containerized environments, default: `false` |
|
||||
| `HEADLESS` | Puppeteer to run headless or not. Debugging related, default: `true` |
|
||||
| `INCOGNITO` | Puppeteer to run incognito or not. Debugging related, default: `false` |
|
||||
| `IN_STOCK_WAIT_TIME` | Time to wait between requests to the same link if it has that card in stock. In seconds, default: `0` |
|
||||
| `LOG_LEVEL` | [Logging levels](https://github.com/winstonjs/winston#logging-levels). Debugging related, default: `info` |
|
||||
| `LOW_BANDWIDTH` | Blocks images/fonts to reduce traffic. Disables ad blocker, default: `false` |
|
||||
| `OPEN_BROWSER` | Toggle for whether or not the browser should open when item is found. Default: `true` |
|
||||
| `PAGE_BACKOFF_MIN` | Minimum backoff time between retrying requests for the same store when a forbidden response is received. Default: `10000` |
|
||||
| `PAGE_BACKOFF_MAX` | Maximum backoff time between retrying requests for the same store when a forbidden response is received. Default: `3600000` |
|
||||
| `PAGE_SLEEP_MIN` | Minimum sleep time between queries of the same product page. In milliseconds, default: `5000` |
|
||||
| `PAGE_SLEEP_MAX` | Maximum sleep time between queries of the same product page. In milliseconds, default: `10000` |
|
||||
| `PAGE_TIMEOUT` | Navigation Timeout in milliseconds. `0` for infinite, default: `30000` |
|
||||
| `PROXY_PROTOCOL` | protocol of proxy server, such as `socks5`. Default: `http` |
|
||||
| `PROXY_ADDRESS` | IP Address or fqdn of proxy server |
|
||||
| `PROXY_PORT` | TCP Port number on which the proxy is listening for connections. Default: `80` |
|
||||
| `SCREENSHOT` | Capture screenshot of page if a card is found. Default: `true` |
|
||||
| `USER_AGENT` | Custom User-Agents headers for HTTP requests. Newline separated, e.g.: `USER_AGENT_STRING1 \n USER_AGENT_STRING2`. Default: `Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.108 Safari/537.36` |
|
||||
| `WEB_PORT` | Starts a webserver to be able to control the bot while it is running. Setting this value starts this service. Default: `` |
|
||||
|
||||
???+ note
|
||||
You can find your computer's user agent by [searching google for "my user agent"](http://google.com/search?q=my+user+agent)
|
||||
|
||||
???+ tip
|
||||
Data usage is [known to be high](https://github.com/jef/streetmerchant/issues?q=is%3Aissue+sort%3Aupdated-desc+bandwidth). This is expected as the program scrapes many websites in parallel 24/7. To help reduce this, use `LOW_BANDWIDTH="true"`. We are looking into other solutions as well, but is low priority.
|
||||
@@ -0,0 +1,203 @@
|
||||
# Filter
|
||||
|
||||
| Environment variable | Description | Notes |
|
||||
|:---:|---|---|
|
||||
| `COUNTRY` | [Supported country](#supported-countries) you want to be scraped | Only used with `nvidia-api`, default: `usa` |
|
||||
| `MAX_PRICE_SERIES_3060TI` | Maximum price allowed for a match, applies 3060 Ti series cards (does not apply to these sites: Nvidia, Asus, EVGA) | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: `1234` - Cards above `1234` will be skipped. |
|
||||
| `MAX_PRICE_SERIES_3070` | Maximum price allowed for a match, applies 3070 series cards (does not apply to these sites: Nvidia, Asus, EVGA) | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: `1234` - Cards above `1234` will be skipped. |
|
||||
| `MAX_PRICE_SERIES_3080` | Maximum price allowed for a match, applies 3080 series cards (does not apply to these sites: Nvidia, Asus, EVGA) | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: `1234` - Cards above `1234` will be skipped. |
|
||||
| `MAX_PRICE_SERIES_3090` | Maximum price allowed for a match, applies 3090 series cards (does not apply to these sites: Nvidia, Asus, EVGA) | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: `1234` - Cards above `1234` will be skipped. |
|
||||
| `MAX_PRICE_SERIES_CORSAIR_SF` | Maximum price allowed for a match, applies to Corsair PSUs | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: `1234` - PSUs above `1234` will be skipped. |
|
||||
| `MAX_PRICE_SERIES_RYZEN5600` | Maximum price allowed for a match, applies AMD 5600 series cpus | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: `1234` - CPUs above `1234` will be skipped. |
|
||||
| `MAX_PRICE_SERIES_RYZEN5800` | Maximum price allowed for a match, applies AMD 5800 series cpus | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: `1234` - CPUs above `1234` will be skipped. |
|
||||
| `MAX_PRICE_SERIES_RYZEN5900` | Maximum price allowed for a match, applies AMD 5900 series cpus | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: `1234` - CPUs above `1234` will be skipped. |
|
||||
| `MAX_PRICE_SERIES_RYZEN5950` | Maximum price allowed for a match, applies AMD 5950 series cpus | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: `1234` - CPUs above `1234` will be skipped. |
|
||||
| `MAX_PRICE_SERIES_SONYPS5C` | Maximum price allowed for a match, applies PS5 console | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: `1234` - PS5 above `1234` will be skipped. |
|
||||
| `MAX_PRICE_SERIES_SONYPS5DE` | Maximum price allowed for a match, applies PS5 digital edition | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: `1234` - PS5 above `1234` will be skipped. |
|
||||
| `MAX_PRICE_SERIES_TEST` | Maximum price allowed for a match, applies `test:series` | Default: leave empty for no limit, otherwise enter a price (enter whole dollar amounts only, avoid use of: dollar symbols, commas, and periods.) e.g.: `1234` - PS5 above `1234` will be skipped. |
|
||||
| `MICROCENTER_LOCATION` | Specific MicroCenter location(s) to search | Comma separated, e.g.: `marietta,duluth`, default: `web` |
|
||||
| `NVIDIA_ADD_TO_CART_ATTEMPTS` | The maximum number of times the `nvidia-api` add to cart feature will be attempted before failing | Default: `10` |
|
||||
| `NVIDIA_SESSION_TTL` | The time in milliseconds to keep the cart active while using `nvidia-api` | Default: `60000` |
|
||||
| `SHOW_ONLY_BRANDS` | Filter to show specified brands | Comma separated, e.g.: `evga,zotac` |
|
||||
| `SHOW_ONLY_MODELS` | Filter to show specified models | Both supported formats are comma separated <br/><br/>1. Standard E.g.: `founders edition,rog strix` <br/><br/> 2. Advanced E.g: `MODEL:SERIES`, E.g: `founders edition:3090,rog strix` |
|
||||
| `SHOW_ONLY_SERIES` | Filter to show specified series | Comma separated, e.g.: `3080,ryzen5900` |
|
||||
| `STORES` | [Supported stores](#supported-stores) you want to be scraped | Both supported formats are comma separated <br/><br/>1. Standard E.g.: `"nvidia"` <br/><br/> 2. Advanced E.g: `STORE:PAGE_SLEEP_MIN:PAGE_SLEEP_MAX`, E.g: `nvidia:10000:30000` <br/><br/>Default: `nvidia` |
|
||||
|
||||
## Supported stores
|
||||
|
||||
Used with the `STORES` variable.
|
||||
|
||||
| Stores | Environment variable |
|
||||
|:---:|:---:|
|
||||
| Adorama | `adorama`|
|
||||
| Alternate (DE) | `alternate`|
|
||||
| Alternate (NL) | `alternate-nl`|
|
||||
| Amazon | `amazon`|
|
||||
| Amazon (CA) | `amazon-ca`|
|
||||
| Amazon (DE) | `amazon-de`|
|
||||
| Amazon (DE) Warehouse | `amazon-de-warehouse`|
|
||||
| Amazon (ES) | `amazon-es`|
|
||||
| Amazon (FR) | `amazon-fr`|
|
||||
| Amazon (IT) | `amazon-it`|
|
||||
| Amazon (NL) | `amazon-nl`|
|
||||
| Amazon (UK) | `amazon-uk`|
|
||||
| AMD | `amd`|
|
||||
| AMD (CA) | `amd-ca`|
|
||||
| AMD (DE) | `amd-de`|
|
||||
| AMD (IT) | `amd-it`|
|
||||
| AntOnline | `antonline`|
|
||||
| Argos (UK) | `argos`|
|
||||
| Aria PC (UK) | `aria`|
|
||||
| ARLT (DE) | `arlt`|
|
||||
| ASUS | `asus` |
|
||||
| ASUS (DE) | `asus-de` |
|
||||
| Azerty (NL) | `azerty`|
|
||||
| B&H | `bandh`|
|
||||
| Best Buy | `bestbuy`|
|
||||
| Best Buy (CA) | `bestbuy-ca`|
|
||||
| Box (UK) | `box`|
|
||||
| CanadaComputers (CA) | `canadacomputers` |
|
||||
| Caseking (DE) | `caseking`|
|
||||
| CCL (UK) | `ccl`|
|
||||
| Comet (IT) | `comet`|
|
||||
| Computeruniverse (DE) | `computeruniverse` |
|
||||
| Coolblue (NL) | `coolblue`|
|
||||
| Coolmod (ES) | `coolmod`|
|
||||
| Corsair | `corsair`|
|
||||
| Currys (UK) | `currys`|
|
||||
| Cyberport (DE) | `cyberport` |
|
||||
| eBuyer (UK) | `ebuyer`|
|
||||
| El Corte Inglés | `elcorteingles`|
|
||||
| ePrice (IT) | `eprice`|
|
||||
| Euronics (IT) | `euronics`|
|
||||
| Euronics (DE) | `euronics-de`|
|
||||
| EVGA | `evga`|
|
||||
| EVGA (EU) | `evga-eu`|
|
||||
| Expert | `expert`|
|
||||
| Galaxus (DE) | `galaxus`|
|
||||
| Game (UK) | `game`|
|
||||
| Gamestop | `gamestop`|
|
||||
| Gamestop (DE) | `gamestop-de`|
|
||||
| Kabum (BR) | `kabum`|
|
||||
| Mediamarkt (DE) | `mediamarkt`|
|
||||
| Medimax | `medimax`|
|
||||
| MemoryExpress (CA) | `memoryexpress`|
|
||||
| Micro Center | `microcenter`|
|
||||
| Mindfactory (DE) | `mindfactory` |
|
||||
| Newegg | `newegg`|
|
||||
| Newegg (CA) | `newegg-ca`|
|
||||
| Notebooksbilliger (DE) |`notebooksbilliger`|
|
||||
| Novatech (UK) | `novatech`|
|
||||
| Nvidia | `nvidia`|
|
||||
| Nvidia (API) | `nvidia-api`|
|
||||
| Office Depot | `officedepot`|
|
||||
| Otto | `otto`|
|
||||
| Overclockers (UK) | `overclockers`|
|
||||
| PCComponentes (ES) | `pccomponentes`|
|
||||
| PlayStation | `playstation`|
|
||||
| PNY | `pny`|
|
||||
| Proshop (DE) | `proshop-de`|
|
||||
| Proshop (DK) | `proshop-dk`|
|
||||
| Saturn (DE) | `saturn`|
|
||||
| Scan (UK) | `scan`|
|
||||
| Smyths Toys (UK) | `smythstoys`|
|
||||
| Spielegrotte | `spielegrotte`|
|
||||
| Target | `target`|
|
||||
| Unieuro (IT) | `unieuro`|
|
||||
| Very (UK) | `very`|
|
||||
| Walmart | `walmart`|
|
||||
| Wipoid | `wipoid`|
|
||||
| Zotac | `zotac`|
|
||||
| TopAchat | `topachat`|
|
||||
|
||||
### Micro Center stores
|
||||
|
||||
Used with the `MICROCENTER_LOCATION` variable.
|
||||
|
||||
???+ note
|
||||
Before using `web`, please review [this issue comment](https://github.com/jef/streetmerchant/issues/442#issuecomment-703297393).
|
||||
|
||||
| | | | |
|
||||
|---|---|---|---|
|
||||
| `brooklyn` | `brentwood` | `cambridge` | `chicago` |
|
||||
| `columbus` | `dallas` | `denver` | `duluth` |
|
||||
| `fairfax` | `flushing` | `houston` | `madison-heights` |
|
||||
| `marietta` | `mayfield-heights` | `north-jersey` | `overland-park` |
|
||||
| `parkville` | `rockville` | `sharonville` | `st-davids` |
|
||||
| `st-louis-park` | `tustin` | `westbury` | `westmont` |
|
||||
| `yonkers` |
|
||||
|
||||
## Supported brands and models
|
||||
|
||||
Used with the `SHOW_ONLY_BRANDS` and `SHOW_ONLY_MODELS` variables.
|
||||
|
||||
| Brand | Model |
|
||||
|:---:|---|
|
||||
| `amd` | `5600x`, `5800x`, `5900x`, `5950x`, `amd reference` |
|
||||
| `asus` | `dual`, `dual oc`, `strix`, `strix oc`, `tuf`, `tuf oc` |
|
||||
| `corsair` | `750 platinum`, `600 platinum` |
|
||||
| `evga` | `ftw3`, `ftw3 ultra`, `xc3`, `xc3 black`, `xc3 ultra` |
|
||||
| `gainward` | `phantom gs`, `phoenix`, `phoenix gs`, `phoenix gs oc` |
|
||||
| `gigabyte` | `aorus master`, `aorus xtreme`, `eagle`, `eagle oc`, `gaming`, `gaming oc`, `turbo`, `vision`, `vision oc` |
|
||||
| `inno3d` | `gaming x3`, `ichill x3`, `ichill x4`, `twin x2 oc` |
|
||||
| `kfa2` | `sg`, `sg oc` |
|
||||
| `microsoft` | `xbox series x`, `xbox series s` |
|
||||
| `msi` | `gaming x trio`, `ventus 2x oc`, `ventus 3x`, `ventus 3x oc` |
|
||||
| `nvidia` | `founders edition` |
|
||||
| `palit` | `gamerock oc`, `gaming pro`, `gaming pro oc` |
|
||||
| `pny` | `dual fan`, `xlr8 revel`, `xlr8 uprising` |
|
||||
| `sony` | `ps5 console`, `ps5 digital` |
|
||||
| `xfx` | `merc`, `amd reference` |
|
||||
| `zotac` | `amp holo`, `amp extreme holo`, `trinity`, `trinity oc`, `twin edge`, `twin edge oc` |
|
||||
|
||||
## Supported series
|
||||
|
||||
Used with the `SHOW_ONLY_SERIES` variable.
|
||||
|
||||
| Series | Environment variable |
|
||||
|:---:|:---:|
|
||||
| `AMD Ryzen 5600x` | `ryzen5600` |
|
||||
| `AMD Ryzen 5800x` | `ryzen5800` |
|
||||
| `AMD Ryzen 5900x` | `ryzen5900` |
|
||||
| `AMD Ryzen 5950x` | `ryzen5950` |
|
||||
| `AMD RX 6800` | `rx6800` |
|
||||
| `AMD RX 6800XT` | `rx6800xt` |
|
||||
| `AMD RX 6900XT` | `rx6900xt` |
|
||||
| `Nvidia RTX 3060 Ti` | `3060ti` |
|
||||
| `Nvidia RTX 3070` | `3070` |
|
||||
| `Nvidia RTX 3080` | `3080` |
|
||||
| `Nvidia RTX 3090` | `3090` |
|
||||
| `Corsair SFX PSU` | `sf` |
|
||||
| `Sony PS5` | `sonyps5c` |
|
||||
| `Sony PS5 Digital Edition` | `sonyps5de` |
|
||||
| `Xbox Series S` | `xboxss` |
|
||||
| `Xbox Series X` | `xboxsx` |
|
||||
|
||||
## Supported countries
|
||||
|
||||
Used with the `COUNTRY` variable.
|
||||
|
||||
???+ attention
|
||||
Used _only_ with `nvidia` and `nvidia-api`.
|
||||
|
||||
| Country | 3080 FE | 3090 FE | Test Card | Notes |
|
||||
|:---:|:---:|:---:|:---:|:---:|
|
||||
| austria | `✔` | `✔` | `✔` | |
|
||||
| belgium | `✔` | `✔` | `✔` | |
|
||||
| canada | `✔` | `✔` | `✔` | |
|
||||
| czechia | `✔` | `✔` | `✔` | |
|
||||
| denmark | `✔` | | `✔` | Missing RTX 3090 |
|
||||
| finland | `✔` | | `✔` | Missing RTX 3090 |
|
||||
| france | `✔` | `✔` | `✔` | |
|
||||
| germany | `✔` | `✔` | `✔` | |
|
||||
| great_britain | `✔` | `✔` | `✔` | |
|
||||
| ireland | `✔` | `✔` | `✔` | |
|
||||
| italy | `✔` | `✔` | `✔` | |
|
||||
| luxembourg | `✔` | `✔` | `✔` | |
|
||||
| netherlands | `✔` | `✔` | `✔` | |
|
||||
| norway | `✔` | `✔` | `✔` | |
|
||||
| poland | `✔` | `✔` | `✔` | |
|
||||
| portugal | `✔` | | | RTX 3080 only |
|
||||
| spain | `✔` | `✔` | `✔` | |
|
||||
| sweden | `✔` | `✔` | `✔` | |
|
||||
| usa | `✔` | `✔` | `✔` | |
|
||||
@@ -0,0 +1,170 @@
|
||||
# Notification
|
||||
|
||||
You can test your notification configuration by running `npm run test:notification`.
|
||||
|
||||
## Desktop
|
||||
|
||||
| Environment variable | Description |
|
||||
|---|---|
|
||||
| `DESKTOP_NOTIFICATIONS` | Display desktop notifications using [node-notifier](https://www.npmjs.com/package/node-notifier). |
|
||||
| `PLAY_SOUND` | Play this sound notification if a product is found. Relative path accepted, valid formats: wav, mp3, flac, E.g.: `path/to/notification.wav`, [free sounds available](https://notificationsounds.com/) |
|
||||
|
||||
???+ attention
|
||||
If you're on Windows, you must have the proper library to run.
|
||||
|
||||
## Discord
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `DISCORD_NOTIFY_GROUP` | Discord group you would like to notify. Can be comma separated |
|
||||
| `DISCORD_WEB_HOOK` | Discord Web Hook URL. Can be comma separated. Use whole webhook URL |
|
||||
|
||||
???+ note
|
||||
- If you're using a role, please use `<@&2834729847239842>`
|
||||
- If you're using a user, please use `<@2834729847239842>`
|
||||
|
||||
## Email and SMS
|
||||
|
||||
Default provider is Gmail. If you use a different email provider, you must provide SMTP settings.
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `EMAIL_PASSWORD` | Email password. (See below for Gmail MFA users) |
|
||||
| `EMAIL_TO` | Destination Email. Defaults to username if not set. Can be comma separated |
|
||||
| `EMAIL_USERNAME` | Email address |
|
||||
| `PHONE_CARRIER` | [Supported carriers](#supported-carriers) for SMS. E.g.: `att` or `att,verizon,google`, email configuration required. If multiple phone numbers are listed, enter a carrier for each phone number |
|
||||
| `PHONE_NUMBER` | 10 digit phone number(s). E.g.: `1234567890` or `1234567890,0987654321,11112223333`, email configuration required |
|
||||
| `SMTP_ADDRESS` | IP Address or FQDN of SMTP server |
|
||||
| `SMTP_PORT` | TCP Port number on which the smtp server is listening for connections. Default: `25` |
|
||||
|
||||
???+ attention
|
||||
If you use Gmail and have multi-factor authentication (MFA), you will need to create an [app password](https://myaccount.google.com/apppasswords) and use this instead of your Gmail password.
|
||||
|
||||
### Supported carriers
|
||||
|
||||
| Carrier | Environment variable |
|
||||
|:---:|:---:|
|
||||
| AT&T | `att` |
|
||||
| AT&T Prepaid | `attgo` |
|
||||
| Bell | `bell` |
|
||||
| Fido | `fido` |
|
||||
| Google | `google`|
|
||||
| Koodo | `koodo` |
|
||||
| Mint | `mint`|
|
||||
| Rogers | `rogers` |
|
||||
| Sprint | `sprint`|
|
||||
| Telus | `telus`|
|
||||
| T-Mobile | `tmobile`|
|
||||
| Verizon | `verizon`|
|
||||
| Virgin | `virgin`|
|
||||
| Virgin (CA) | `virgin-ca`|
|
||||
| Visible | `visible`|
|
||||
|
||||
## MQTT
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `MQTT_BROKER_ADDRESS` | IP address or URL of MQTT Broker, e.g.: `192.168.1.xxx` or `broker.hivemq.com` |
|
||||
| `MQTT_BROKER_PORT` | Network port of MQTT Broker. Default: `1883` |
|
||||
| `MQTT_CLIENT_ID` | Unique Client ID (only if required by MQTT Broker), typically not required when only publishing alerts |
|
||||
| `MQTT_PASSWORD` | MQTT password - only use with MQTT brokers on private networks, if required. Will not be sent over public networks for safety |
|
||||
| `MQTT_QOS` | QoS level for published alerts to broker (https://www.npmjs.com/package/mqtt#about-qos). Default: `0`, Can be `0`, `1`, or `2` |
|
||||
| `MQTT_TOPIC` | Topic to publish alerts to. Can include `%store%`, `%series%`, `%brand%`, `%model%` for dynamic topics. Default: `streetmerchant/alert`. E.g.: `nv-alert/%store%/%series%/%brand%/%model%/alert` |
|
||||
| `MQTT_USERNAME` | MQTT username - (only if required by MQTT Broker) |
|
||||
|
||||
## PagerDuty
|
||||
|
||||
Obtained in PagerDuty - <Service you want to use> - Integrations
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `PAGERDUTY_INTEGRATION_KEY` | PagerDuty Events API v2 Integration Key. |
|
||||
| `PAGERDUTY_SEVERITY` | Severity of PagerDuty events |
|
||||
|
||||
## Philips Hue
|
||||
|
||||
Generate required keys using [instructions](https://developers.meethue.com/develop/get-started-2/). This will be used for both LAN and cloud access over the official Remote Hue API.
|
||||
|
||||
For cloud only usage, instructions to generate are located [here](https://developers.meethue.com/develop/hue-api/remote-authentication/).
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `PHILIPS_HUE_API_KEY` | Hue Bridge API Key |
|
||||
| `PHILIPS_HUE_LAN_BRIDGE_IP` | LAN IP Address of your Hue Bridge. LAN only, e.g. `192.168.x.x` |
|
||||
| `PHILIPS_HUE_LIGHT_IDS` | Light IDs. All lights if not supplied. Can be comma separated, e.g.: `1,2`. See Hue App -> About for IDs |
|
||||
| `PHILIPS_HUE_LIGHT_COLOR` | Color in RGB Format. Nvidia green if not supplied. Can be comma separated, e.g.: `255,255,255` |
|
||||
| `PHILIPS_HUE_LIGHT_PATTERN` | Lights will flash for 30 seconds if `blink` is given |
|
||||
| `PHILIPS_HUE_CLOUD_ACCESS_TOKEN` | Cloud Access Token. Cloud only |
|
||||
| `PHILIPS_HUE_CLOUD_REFRESH_TOKEN` | Cloud Refresh Token. Cloud only |
|
||||
| `PHILIPS_HUE_CLOUD_CLIENT_ID` | Cloud Client ID. Cloud only |
|
||||
| `PHILIPS_HUE_CLOUD_CLIENT_SECRET` | Cloud Client Secret. Cloud only |
|
||||
|
||||
> :point_right: Here's a [video demonstration](https://vimeo.com/476083242).
|
||||
|
||||
## Pushbullet
|
||||
|
||||
Generate token at https://www.pushbullet.com/#settings/account.
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `PUSHBULLET` | PushBullet API key |
|
||||
|
||||
## Pushover
|
||||
|
||||
Generate token at https://pushover.net/apps/build.
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `PUSHOVER_TOKEN` | Pushover access token |
|
||||
| `PUSHOVER_USER` | Pushover username |
|
||||
| `PUSHOVER_PRIORITY` | Pushover message priority |
|
||||
|
||||
## Slack
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `SLACK_CHANNEL` | Slack channel for posting |
|
||||
| `SLACK_TOKEN` | Slack API token |
|
||||
|
||||
## Telegram
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `TELEGRAM_ACCESS_TOKEN` | Telegram access token |
|
||||
| `TELEGRAM_CHAT_ID` | Telegram chat ID. Can be comma separated, e.g.: `123456789,987654321` |
|
||||
|
||||
## Twilio
|
||||
|
||||
Token generation can be found at https://twilio.com/console.
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `TWILIO_ACCOUNT_SID` | Twilio Account SID |
|
||||
| `TWILIO_AUTH_TOKEN` | Twilio Auth Token |
|
||||
| `TWILIO_FROM_NUMBER` | Twilio provided phone number to send messages from |
|
||||
| `TWILIO_TO_NUMBER` | Mobile number to send SMS to |
|
||||
|
||||
???+ note
|
||||
Include country codes in phone numbers. Example: `+4401234567890`
|
||||
|
||||
## Twitter
|
||||
|
||||
Generate all Twitter keys at: https://developer.twitter.com/
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `TWITTER_ACCESS_TOKEN_KEY` | Twitter Token Key |
|
||||
| `TWITTER_ACCESS_TOKEN_SECRET` | Twitter Token Secret |
|
||||
| `TWITTER_CONSUMER_KEY` | Twitter Consumer Key |
|
||||
| `TWITTER_CONSUMER_SECRET` | Twitter Consumer Secret |
|
||||
| `TWITTER_TWEET_TAGS` | List of hashtags to append to the tweet message, e.g.: `#nvidia #nvidiastock` |
|
||||
|
||||
## Twitch
|
||||
|
||||
| Environment variable | Description |
|
||||
|:---:|---|
|
||||
| `TWITCH_CLIENT_ID` | Twitch client ID |
|
||||
| `TWITCH_CLIENT_SECRET`| Twitch client secret |
|
||||
| `TWITCH_ACCESS_TOKEN` | Twitch access token |
|
||||
| `TWITCH_REFRESH_TOKEN` | Twitch refresh token |
|
||||
| `TWITCH_CHANNEL` | Twitch channel |
|
||||
Reference in New Issue
Block a user