Provided by: unoconv_0.4-1_all bug

NAME

       unoconv - convert any document from and to any OpenOffice supported format

SYNOPSIS

       unoconv [options] file [file2 ..]

       unoconv --listener [--server SRV] [--port PRT] [--connections CON]

DESCRIPTION

       unoconv is a command line utility that can convert any file format that OpenOffice can
       import, to any file format that OpenOffice is capable of exporting.

       unoconv uses the OpenOffice’s UNO bindings for non-interactive conversion of documents and
       therefor needs an OpenOffice instance to communicate with. Therefore if it cannot find
       one, it will start its own instance for temporary usage. If desired, one can start a
       “listener” instance to use for subsequent connections or even for remote connections.

OPTIONS

       -c, --connection
              UNO connection string to be used by the client to connect to an OpenOffice
              instance, or used by the listener to make OpenOffice listen.

              Default connection string is "socket,host=localhost,port=2002;urp;StarOffice.ComponentContext"

       -d, --doctype
              Specify the OpenOffice document type of the backend format. Possible document types
              are: document, graphics, presentation, spreadsheet.

              Default document type is 'document'.

       -e, --export
              Set specific export filter options (related to the used OpenOffice filter).

              eg. for the PDF output filter one can specify: -e PageRange=1-2

       -f, --format
              Specify the output format for the document. You can get a list of possible output
              formats per document type by using the --show option.

              Default document type is 'pdf'.

       -i, --import
              Set specific import filters options (related to the used OpenOffice filter).

              eg. for some input filters one can specify: -i utf8

       -l, --listener
              Start unoconv as listener for unoconv clients to connect to.

       -o, --outputpath
              Directory to put converted documents.

       --pipe Use a pipe as an alternative connection mechanism to talk to OpenOffice.

       -p, --port
              Port to listen on (as listener) or to connect to (as client).

              Default port is '2002'.

       -s, --server
              Server (address) to listen on (as listener) or to connect to (as client).

              Default server is 'localhost'.

       --show List the possible output formats to be used with -f.

       --stdout
              Print converted output file to stdout.

       -t, --template
              Specify the template to use for importing styles from. This can be very useful if
              you have a corporate identity you have to apply to every document you distribute.

       -T, --timeout
              When unoconv starts its own listener, try to connect to it for an amount of seconds
              before giving up. Increasing this may help when you receive random errors caused by
              the listener not being ready to accept conversion jobs.

       -v, --verbose
              Be more and more and more verbose.

ARGUMENTS

       You can provide one or more files as arguments to convert each of them to the specified
       output format.

EXAMPLES

       You can use unoconv in standalone mode, this means that in absence of an OpenOffice
       listener, it will starts its own:

       unoconv -f pdf some-document.odt
       One can use unoconv as a listener (by default localhost:2002) to let other unoconv
       instances connect to it:

       unoconv --listener &
       unoconv -f pdf some-document.odt
       unoconv -f doc other-document.odt
       unoconv -f jpg some-image.png
       unoconv -f xsl some-spreadsheet.csv
       kill -15 %-
       This also works on a remote host:

       unoconv --listener --server 1.2.3.4 --port 4567
       and then connect another system to convert documents:

       unoconv --server 1.2.3.4 --port 4567

BUGS

       unoconv uses the UNO bindings to connect to OpenOffice, in absence of a usable socket, it
       will start its own OpenOffice instance with the correct parameters.

       Note
       Please see the TODO file for known bugs and future plans.

SEE ALSO

       convert(1), file(1), odt2txt

REFERENCES

       unoconv is very useful together with the following tools:

       Asciidoc
              [1]http://www.methods.co.nz/asciidoc/

       docbook2odf
              [2]http://open.comsultia.com/docbook2odf/ A list of possible import and export
              formats is available from:

       OpenOffice 2.1
              [3]http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_2_1

       OpenOffice 3.0
              [4]http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_3_0

AUTHOR

       Written by Dag Wieers, <[5]dag@wieers.com>

RESOURCES

       Main web site: [6]http://dag.wieers.com/home-made/unoconv/

COPYING

       Copyright (C) 2007 Dag Wieers. Free use of this software is granted under the terms of the
       GNU General Public License (GPL).

AUTHOR

       Dag Wieers <dag@wieers.com>.

REFERENCES

       1. http://www.methods.co.nz/asciidoc/
          http://www.methods.co.nz/asciidoc/

       2. http://open.comsultia.com/docbook2odf/
          http://open.comsultia.com/docbook2odf/

       3. http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_2_1
          http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_2_1

       4. http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_3_0
          http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_3_0

       5. dag@wieers.com
          mailto:dag@wieers.com

       6. http://dag.wieers.com/home-made/unoconv/
          http://dag.wieers.com/home-made/unoconv/

  0.4                                    20 october 2010                               UNOCONV(1)