--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/libervia-cli/pipe.rst	Sun Mar 21 18:23:58 2021 +0100
@@ -0,0 +1,43 @@
+==================================================
+pipe: send/receive data stream through shell pipes
+==================================================
+
+``pipe`` commands allow you to send or receive data stream through a Unix shell pipe.
+Salut à Toi will create a network connection (using XMPP and Jingle) between you an your
+contact.
+
+in
+==
+
+Receive data stream. Data will be send to stdout, so it can be piped out or simply print
+to the screen. You can specify bare jids of entities to accept stream for, by default all
+streams are accepted.
+
+example
+-------
+
+Receive a video stream, and redirect it to mpv_ so show the video::
+
+  $ li pipe in | mpv -
+
+.. _mpv: https://mpv.io/
+
+out
+===
+
+Send data stream. Data comes from stdin, so you may use pipe in something or just write
+some text.
+
+The only expected argument is the full jid of the device where the stream must be piped
+out.
+
+example
+-------
+
+Send a video to louise::
+
+ $ li pipe out louise@example.org/sat < some_video.webm
+
+Send output from ``cal`` command to louise::
+
+ $ cal | li pipe out louise@example.org/sat