Man Linux: Main Page and Category List

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’.

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

              Default document type is ’pdf’.

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

       -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.

       -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. However, OpenOffice requires a working DISPLAY
       (even with -headless option) and therefor you cannot run it in a true
       console, you need X.

       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
              http://www.methods.co.nz/asciidoc/

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

AUTHOR

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

RESOURCES

       Main web site: [2]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).

REFERENCES

       1. dag@wieers.com
          mailto:dag@wieers.com

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

                                  09/01/2007