Brown Dog Command-Line Interface (BD-CLI)
=========================================

bd [OPTION] [FILE/DIRECTORY]
-----------------------------

Command line interface to Brown Dog services. Use to convert files between formats and extract various derived products
from file contents (e.g. tags, metadata, signatures, previews).

-b set the BD URL (e.g. https://bd-api.ncsa.illinois.edu)

-t set the token

-v verbose output

-w set wait time for conversions/extractions

-h display help

-o set output format

--outputs list the available output formats for the given file

--extractors list the available extractors for the given file

--find search current directory for a file similar to the given file

--bigdata use this flag if the file is large enough and it needs to be processed locally rather than using remote
 Brown Dog services

 **Examples:**

List available output formats for given file:

		bd --outputs image.pcd

Convert the given Kodak Photo CD image to a JPEG image.  Produces file image.jpg:

		bd -o jpg image.pcd

Convert a directory of images into the JPEG format:

		bd -o jpg images/

List available extractors for given file:

		bd --extractors image.jpg

Extract data from files contents (e.g. tags, previews, analysis, and other derived products).  Produces file image.json:

		bd image.jpg

Chain conversion and extraction.  Equivalent to the previous two examples:

		bd -o jpg image.pcd | bd

Index files within a directory:

		bd images/

Search for a similar file within a directory that has already been indexed:

		bd --find /path/image.jpg

Read input filename from a text file. This feature can be used to integrate BD-CLI with other programs by passing
filename around. Here input.txt can contain one input filename:

		bd < input.txt
		bd -o jpg < input.txt

