README

   1 Download and decrypt encrypted files uploaded by the Conversations XMPP client
   2 using the mechanism from XEP-0363: HTTP Upload:
   3 (http://xmpp.org/extensions/xep-0363.html)
   4
   5 This is basically a translation in python of ImageDownlaoder:
   6 https://github.com/iNPUTmice/ImageDownloader
   7
   8 However there are some differences:
   9   - The file is saved on local storage instead of being written on the
  10     standard output, this way xdg-open can be used to open it.
  11   - The wrapper script uses xdg-open, this is a more generic approach which
  12     works with different file types.
  13   - The wrapper script downloads the file to a temporary directory, this way
  14     it can be invoked multiple times without the risk of overwriting existing
  15     files.
  16
  17 Some snippets were taken from python-omemo:
  18 https://github.com/omemo/python-omemo/blob/HEAD/src/omemo/aes_gcm_native.py
  19
  20 Example of use:
  21
  22   ./conversations_http_downloader.py http://host.tld/path/to/file.jpg#theivandkey
  23
  24 The open_wrapper.sh script can be used in gajim as a browser command to
  25 download, decrypt, and open the files automatically.
  26
  27
  28 NOTE:
  29
  30 Run make to prepare the wrapper script, this is needed only the first time the
  31 project is downloaded.
  32