Editing Flaschen Taschen (section)

=== Network protocol and Utilities to send content ===

The network protocol is quite simple: essentially send a PPM picture (P6) in a UDP packet to ft.noise:1337.

For instance, try the following all in the comfort of you shell (in bash, to be precise, that conveniently provides the /dev/udp pseudo-path):

  bash$ jpegtopnm myimage.jpg | stdbuf -o64k pnmscale -xysize 45 35 > /dev/udp/ft.noise/1337

Flaschen Taschen accepts a footer that defines an offset in x,y space as well as a layer z index. To write images which cover the default demo visualization, you can send a higher -index by appending this footer after your sends. We still need to make sure to send everything in one packet, so on the shell this is a bit awkward as we first have to store the full content temporarily in a file. For instance, to position the image at (x=0 y=0, z=5):

  bash$ ( jpegtopnm myimage.jpg | pnmscale -xysize 45 35; echo "0 0 5" ) > /tmp/tmp-out ; cat /tmp/tmp-out > /dev/udp/ft.noise/1337

There are [https://github.com/hzeller/flaschen-taschen/tree/master/client#flaschen-taschen-clients utilities in the repository] to send and scroll arbitrary images (including animated gifs), videos or text, so the above, sending an image to layer 5, would be as simple as:
  
  bash:flaschen-taschen/client$ ./send-image -l5 myimage.jpg

There is a C++ and Python client library that you can use right away to send images to Flaschen Taschen including a couple of examples.
It is simple to write your own client in any language that supports networking (See [https://github.com/hzeller/flaschen-taschen/blob/master/doc/protocols.md#protocols protocols section] in documentation). There is also a Node.js module flaschenode in the npm registry (https://www.npmjs.com/package/flaschenode). Or you can clone it from github or help hack on it if somehow you have node working but don't like npm (https://github.com/mpmckenna8/flashenode).

'''See all the details here:''' https://github.com/hzeller/flaschen-taschen