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.
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"
Specify the OpenOffice document type of the backend format. Possible document types are:
Default document type is 'document'.
Set specific export filter options (related to the used OpenOffice filter).
eg. for the PDF output filter one can specify: -e PageRange=1-2
Specify the output format for the document. You can get a list of possible output formats per document type by using the
Default document type is 'pdf'.
Set specific import filters options (related to the used OpenOffice filter).
eg. for some input filters one can specify: -i utf8
Start unoconv as listener for unoconv clients to connect to.
Directory to put converted documents.
Use a pipe as an alternative connection mechanism to talk to OpenOffice.
Port to listen on (as listener) or to connect to (as client).
Default port is '2002'.
Server (address) to listen on (as listener) or to connect to (as client).
Default server is 'localhost'.
List the possible output formats to be used with
Print converted output file to stdout.
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.
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.
Be more and more and more verbose.
You can provide one or more files as arguments to convert each of them to the specified output format.
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: