1
0
mirror of https://github.com/node-red/node-red-nodes.git synced 2023-10-10 13:36:58 +02:00
node-red-nodes/README.md

192 lines
11 KiB
Markdown
Raw Normal View History

2013-09-26 23:01:23 +02:00
# Node-RED Nodes
A collection of nodes for [Node-RED](http://nodered.org). See below for a list.
2013-09-26 23:01:23 +02:00
## Installation
2018-05-02 11:11:49 +02:00
All of these nodes are available as individual npm packages. See the list below for the
npm package names, or [search npm](https://www.npmjs.org/search?q=node-red-node-).
2014-09-22 21:00:26 +02:00
2018-05-02 11:11:49 +02:00
This repository acts as an overall store for these nodes - and is not
intended as a way to install them - unless you really do want some development.
To install - either use the manage palette option in the editor, or change to your Node-RED user directory.
2014-09-22 21:00:26 +02:00
cd ~/.node-red
npm install node-red-node-{filename}
2014-09-22 21:00:26 +02:00
To manually install using this repo:
2013-09-26 23:01:23 +02:00
1. cd into the `nodes` directory of Node-RED
2. Either:
- download the zip of the repository and extract it
- run `git clone https://github.com/node-red/node-red-nodes.git`
3. run `npm install` in any of the node subfolders to install individual node's dependencies
2013-09-26 23:01:23 +02:00
## Running Tests
2018-05-02 11:11:49 +02:00
Node.js v6 or newer is required. To run tests on all of the nodes you will need the node-red runtime:
npm i node-red-nodes
npm test
2013-09-26 23:01:23 +02:00
## Contributing
Now that we support npm installation of nodes we recommend people post their own
nodes via [npm](https://www.npmjs.org/). Please read the
[packaging guide notes](http://nodered.org/docs/creating-nodes/packaging.html).
2013-09-26 23:01:23 +02:00
For simple typos and single line fixes please just raise an issue pointing out
our mistakes. If you need to raise a pull request please read our
[contribution guidelines](https://github.com/node-red/node-red/blob/master/CONTRIBUTING.md)
before doing so.
2013-09-26 23:01:23 +02:00
## Copyright and license
2018-05-02 11:11:49 +02:00
Copyright JS Foundation and other contributors, http://js.foundation under [the Apache 2.0 license](LICENSE).
# Extra Node Information
**NPM name** - *File-link* - Description
2014-09-22 21:00:26 +02:00
### Misc
**N/A** - *[99-sample](./)* - A sample node with more comments than most to try to help you get started without any other docs...
### Analysis
2015-04-10 12:56:17 +02:00
**node-red-node-badwords** - *[74-swearfilter](analysis/swearfilter)* - Analyses the payload and tries to filter out any messages containing bad swear words. This only operates on payloads of type string. Everything else is blocked.
2018-05-02 11:11:49 +02:00
**node-red-node-wordpos** - *[72-wordpos](analysis/wordpos)* - Analyses the payload and classifies the part-of-speech of each word. The resulting message has msg.pos added with the results. A word may appear in multiple categories (eg, 'great' is both a noun and an adjective).
2018-05-02 11:11:49 +02:00
### Function
2018-05-02 11:11:49 +02:00
**node-red-node-datagenerater** - *[datagenerator](function/datagenerator)* - A node that can generate dummy data in various formats, names, addresses, emails, numbers, words, etc
**node-red-node-pidcontrol** - *[pidcontrol](function/PID)* - A PID control node for numeric inputs - provides simple contoll loop feedback capability.
**node-red-node-random** - *[random](function/random)* - A simple random number generator - can generate integers for x to y - or floats between x and y.
2018-05-02 11:11:49 +02:00
**node-red-node-rbe** - *[rbe](function/rbe)* - A simple node to provide report by exception and deadband / bandgap capability for simple inputs.
**node-red-node-smooth** - *[17-smooth](function/smooth)* - A simple node to provide various functions across several previous values, including max, min, mean, high and low pass filters.
### Hardware
2018-05-02 11:11:49 +02:00
**node-red-node-arduino** - *[35-arduino](hardware/Arduino)* - A collection of analogue & digital input & output nodes for the Arduino board - uses firmata protocol to talk to the board.
2014-09-22 21:00:26 +02:00
**node-red-node-beaglebone** - *[145-BBB-hardware](hardware/BBB)* - A collection of analogue & digital input & output nodes for the [Beaglebone Black](http://beagleboard.org/black).
2018-05-02 11:11:49 +02:00
**node-red-node-blink1** - *[77-blink1](hardware/blink1)* - Provides support for the [Blink1](http://blink1.thingm.com/) USB LED from ThingM.
2018-05-02 11:11:49 +02:00
**node-red-node-blinkstick** - *[76-blinkstick](hardware/blinkstick)* - Provides support for the [BlinkStick](http://www.blinkstick.com/) USB LED device.
2018-05-02 11:11:49 +02:00
**node-red-node-digirgb** - *[78-digiRGB](hardware/digiRGB)* - Provides support for the DigiSpark RGB USB LED.
2018-05-02 11:11:49 +02:00
**node-red-node-heatmiser** - *[100-heatmiser-in](hardware/heatmiser)* - Read and writes settings for temperature and frost protection to Heatmiser thermostats.
2018-05-02 11:11:49 +02:00
**node-red-node-intel-galileo** - *[mraa-spio](hardware/intel)* - A collection of analogue & digital input & output nodes for the Intel Galileo and Edison.
2018-05-02 11:11:49 +02:00
**node-red-node-ledborg** - *[78-ledborg](hardware/LEDborg)* - A simple driver for the [LEDborg](https://www.piborg.org/ledborg) plug on module for Raspberry Pi.
2018-05-02 11:11:49 +02:00
**node-red-node-makeymakey** - *[42-makey](hardware/makey)* - A Node-RED node to read from a [MakeyMakey](http://www.makeymakey.com/) input device.
2018-05-02 11:11:49 +02:00
**node-red-node-pi-gpiod** - *[pigpiod](hardware/pigpiod)* - An alternative to the default PI GPIO nodes that allows remote access - so a host machine can access a remote Pi (via network) and is better for driving multiple servos.
2018-05-02 11:11:49 +02:00
**node-red-node-pi-mcp3008** - *[pimcp3008](hardware/mcp3008)* - Allows A Raspberry Pi to node to read from MCP300x series Analogue to Digital Converter chips via the SPI bus.
2013-11-10 21:58:36 +01:00
2018-05-02 11:11:49 +02:00
**node-red-node-pi-neopixel** - *[neopixel](hardware/neopixel)* - Allows A Raspberry Pi to drive a strip of NeoPixels directly.
2018-05-02 11:11:49 +02:00
**node-red-node-pi-unicorn-hat** - *[unicorn](hardware/unicorn)* - Lets a Raspbeery Pi control a Pimorini Unicorn HAT 8x8 LED display.
2018-05-02 11:11:49 +02:00
**node-red-node-pibrella** - *[38-rpi-pibrella](hardware/Pibrella)* - Controls a [Pibrella](http://pibrella.com/) add-on board for a Raspberry-Pi.
2018-05-02 11:11:49 +02:00
**node-red-node-piface** - *[37-rpi-piface](hardware/PiFace)* - Adds support for the [PiFace](http://www.piface.org.uk/) interface module for Raspberry Pi.
2018-05-02 11:11:49 +02:00
**node-red-node-piliter** - *[39-rpi-piliter](hardware/PiLiter)* - Controls a Pimorini Pi-LITEr 8 LED add-on board for a Raspberry-Pi.
2015-04-10 12:56:17 +02:00
**node-red-node-sensortag** - *[79-sensorTag](hardware/sensorTag)* - Reads data from the Ti Bluetooh Low Energy (BLE) SensorTag device.
2018-05-02 11:11:49 +02:00
**node-red-node-wemo** - *[60-wemo](hardware/wemo)* - Basic node to drive a [WeMo](http://www.belkin.com/us/Products/home-automation/c/wemo-home-automation/) socket and switch. Does not use discovery.
2014-09-22 21:47:06 +02:00
**N/A** - *[101-scanBLE](hardware/scanBLE)* - Scans for a particular Bluetooth Low Energy (BLE) device.
### I/O
2018-05-02 11:11:49 +02:00
**node-red-node-discovery** - *[mdns](io/mdns)* - discovers other Avahi/Bonjour services on the network.
2018-05-02 11:11:49 +02:00
**node-red-node-emoncms** - *[88-emoncms](io/emoncms)* - Adds node to post to an [Emoncms](http://emoncms.org/) server.
2018-05-02 11:11:49 +02:00
**node-red-node-mqlight** - *[mqlight](io/mqlight)* - Adds nodes to send and receive using MQlight.
2018-05-02 11:11:49 +02:00
**node-red-node-ping** - *[88-ping](io/ping)* - Pings a machine and returns the trip time in mS. Returns false if no response received within 3 seconds, or if the host is unresolveable. Default ping is every 20 seconds but can be configured.
2018-05-02 11:11:49 +02:00
**node-red-node-serialport** - *[25-serial](io/serialport)* - Node to send messages to and receive messages from a physical serial port.
**node-red-node-snmp** - *[snmp](io/snmp)* - Adds simple snmp receivers for single OIDs or OID tables.
2018-05-02 11:11:49 +02:00
**node-red-node-stomp** - *[18-stomp](io/stomp)* - A Node-RED node to publish and subscribe to and from a [STOMP server](https://stomp.github.io/implementations.html#STOMP_Servers).
2018-05-02 11:11:49 +02:00
**node-red-node-wol** - *[39-wol](io/wol)* - Sends a Wake-On-LAN magic packet to the mac address specified. You may instead set msg.mac to dynamically set the target device mac to wake up.
2018-05-02 11:11:49 +02:00
### Parsers
**node-red-node-base64** - *[70-base64.js](parsers/base64)* - Converts a payload to/from base64 encoded format.
**node-red-node-geohash** - *[70-geohash.js](parsers/geohash)* - Converts a lat, lon payload to/from geohash format.
2018-05-02 11:11:49 +02:00
**node-red-node-msgpack** - *[70-msgpack.js](parsers/msgpack)* - Converts a payload to/from msgpack binary packed format.
2018-05-02 11:11:49 +02:00
**node-red-node-what3words** - *[what3words.js](parsers/what3words)* - Encodes or Decodes a lat, lon position into what3words text format.
### Social
2014-09-22 21:47:06 +02:00
**node-red-node-dweetio** - *[55-dweetio](social/dweetio)* - Uses [dweetio](https://dweet.io/) to send/receive messages.
2018-05-02 11:11:49 +02:00
**node-red-node-email** - *[61-email](social/email)* - Sends and receives simple emails from services like gmail or smtp or imap servers.
**node-red-node-feedparser** - *[32-feedparse](social/feedparser)* - Reads messages from an atom or rss feed.
**node-red-node-irc** - *[91-irc](social/irc)* - Connects to an IRC server to send and receive messages.
2014-09-22 21:00:26 +02:00
**node-red-node-nma** - *[57-nma](social/nma)* - Sends alerts to Android devices via the [Notify-My-Android](http://www.notifymyandroid.com/) app.
2014-09-22 21:47:06 +02:00
**node-red-node-notify** - *[57-notify](social/notify)* - Uses [Growl](http://growl.info/) to provide a desktop popup containing the payload. Only useful on the local Apple machine.
2014-09-22 21:00:26 +02:00
**node-red-node-prowl** - *[57-prowl](social/prowl)* - Uses [Prowl](http://www.prowlapp.com/) to push the payload to an Apple device that has the Prowl app installed.
2014-09-22 21:00:26 +02:00
**node-red-node-pushbullet** - *[57-pushbullet](social/pushbullet)* - Uses [PushBullet](https://www.pushbullet.com/) to push the payload to an Android device that has the [PushBullet](https://www.pushbullet.com/) app installed.
2018-05-02 11:11:49 +02:00
**node-red-node-pusher** - *[114-pusher](social/pusher)* - Publish-Subscribe to a [Pusher](http://pusher.com/) channel/event.
2014-09-22 21:00:26 +02:00
**node-red-node-pushover** - *[57-pushover](social/pushover)* - Sends alerts via [Pushover](https://pushover.net/).
2018-05-02 11:11:49 +02:00
**node-red-node-twilio** - *[56-twilio](social/twilio)* - Uses [Twilio](https://www.twilio.com/) service to send/receive text messages.
**node-red-node-twitter** - *[27-twitter](social/twitter)* - Listens to Twitter feeds and can also send tweets. (**NOTE**: this will break soon when Twitter remove their streaming API)
2014-09-22 21:00:26 +02:00
**node-red-node-xmpp** - *[92-xmpp](social/xmpp)* - Connects to an XMPP server to send and receive messages.
### Storage
2014-09-22 21:00:26 +02:00
**node-red-node-leveldb** - *[67-leveldb](storage/leveldb)* - Uses LevelDB for a simple key value pair database.
2014-09-22 21:00:26 +02:00
**node-red-node-mysql** - *[68-mysql](storage/mysql)* - Allows basic access to a MySQL database. This node uses the **query** operation against the configured database. This does allow both INSERTS and DELETES. By it's very nature it allows SQL injection... *so be careful out there...*
2014-09-22 21:00:26 +02:00
**node-red-node-sqlite** - *[sqlite](storage/sqlite)* - Supports read and write to a local sqlite database.
2013-12-09 11:45:15 +01:00
2015-04-10 12:56:17 +02:00
### Time
2018-05-02 11:11:49 +02:00
**node-red-node-suncalc** - *[79-suncalc](time/suncalc)* - Uses the suncalc module to generate an output at sunrise and sunset based on a specified location. Several choices of definition of sunrise and sunset are available.
2015-04-10 12:56:17 +02:00
2018-05-02 11:11:49 +02:00
**node-red-node-timeswitch** - *[timeswitch](time/timeswitch)* - Lets the user set simple repeating timers for example for simple heating control, etc.
2015-04-10 12:56:17 +02:00
2018-05-02 11:11:49 +02:00
### Utility
2015-04-10 12:56:17 +02:00
**node-red-node-daemon** - *[daemon](utility/daemon)* - starts up (calls) a long running system program and pipes STDIN, STDOUT and STDERR to and from that process. Good for monitoring long running command line applications,
2018-05-02 11:11:49 +02:00
**node-red-node-exif** - *[94-exif](utility/exif)* - Extracts GPS and other EXIF information from a passed in jpeg image,