Convert Between any Document Format – Unoconv
UNOCONV(1) UNOCONV(1)
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)
The floowing list of all file formats currently availabe:
jerry@jerry-P5Q-office:~$ unoconv --show The following list of document formats are currently available: bib - BibTeX [.bib] doc - Microsoft Word 97/2000/XP [.doc] doc6 - Microsoft Word 6.0 [.doc] doc95 - Microsoft Word 95 [.doc] docbook - DocBook [.xml] html - HTML Document (OpenOffice.org Writer) [.html] odt - ODF Text Document [.odt] ott - Open Document Text [.ott] ooxml - Microsoft Office Open XML [.xml] pdf - Portable Document Format [.pdf] rtf - Rich Text Format [.rtf] latex - LaTeX 2e [.ltx] sdw - StarWriter 5.0 [.sdw] sdw4 - StarWriter 4.0 [.sdw] sdw3 - StarWriter 3.0 [.sdw] stw - Open Office.org 1.0 Text Document Template [.stw] sxw - Open Office.org 1.0 Text Document [.sxw] text - Text Encoded [.txt] mediawiki - MediaWiki [.txt] txt - Text [.txt] uot - Unified Office Format text [.uot] vor - StarWriter 5.0 Template [.vor] vor4 - StarWriter 4.0 Template [.vor] vor3 - StarWriter 3.0 Template [.vor] xhtml - XHTML Document [.html] The following list of graphics formats are currently available: bmp - Windows Bitmap [.bmp] emf - Enhanced Metafile [.emf] eps - Encapsulated PostScript [.eps] gif - Graphics Interchange Format [.gif] html - HTML Document (OpenOffice.org Draw) [.html] jpg - Joint Photographic Experts Group [.jpg] met - OS/2 Metafile [.met] odd - OpenDocument Drawing [.odd] otg - OpenDocument Drawing Template [.otg] pbm - Portable Bitmap [.pbm] pct - Mac Pict [.pct] pdf - Portable Document Format [.pdf] pgm - Portable Graymap [.pgm] png - Portable Network Graphic [.png] ppm - Portable Pixelmap [.ppm] ras - Sun Raster Image [.ras] std - OpenOffice.org 1.0 Drawing Template [.std] svg - Scalable Vector Graphics [.svg] svm - StarView Metafile [.svm] swf - Macromedia Flash (SWF) [.swf] sxd - OpenOffice.org 1.0 Drawing [.sxd] sxd3 - StarDraw 3.0 [.sxd] sxd5 - StarDraw 5.0 [.sxd] tiff - Tagged Image File Format [.tiff] vor - StarDraw 5.0 Template [.vor] vor3 - StarDraw 3.0 Template [.vor] wmf - Windows Metafile [.wmf] xhtml - XHTML [.xhtml] xpm - X PixMap [.xpm] The following list of presentation formats are currently available: bmp - Windows Bitmap [.bmp] emf - Enhanced Metafile [.emf] eps - Encapsulated PostScript [.eps] gif - Graphics Interchange Format [.gif] html - HTML Document (OpenOffice.org Impress) [.html] jpg - Joint Photographic Experts Group [.jpg] met - OS/2 Metafile [.met] odg - ODF Drawing (Impress) [.odg] odp - ODF Presentation [.odp] otp - ODF Presentation Template [.otp] pbm - Portable Bitmap [.pbm] pct - Mac Pict [.pct] pdf - Portable Document Format [.pdf] pgm - Portable Graymap [.pgm] png - Portable Network Graphic [.png] pot - Microsoft PowerPoint 97/2000/XP Template [.pot] ppm - Portable Pixelmap [.ppm] ppt - Microsoft PowerPoint 97/2000/XP [.ppt] pwp - PlaceWare [.pwp] ras - Sun Raster Image [.ras] sda - StarDraw 5.0 (OpenOffice.org Impress) [.sda] sdd - StarImpress 5.0 [.sdd] sdd3 - StarDraw 3.0 (OpenOffice.org Impress) [.sdd] sdd4 - StarImpress 4.0 [.sdd] sxd - OpenOffice.org 1.0 Drawing (OpenOffice.org Impress) [.sxd] sti - OpenOffice.org 1.0 Presentation Template [.sti] svg - Scalable Vector Graphics [.svg] svm - StarView Metafile [.svm] swf - Macromedia Flash (SWF) [.swf] sxi - OpenOffice.org 1.0 Presentation [.sxi] tiff - Tagged Image File Format [.tiff] uop - Unified Office Format presentation [.uop] vor - StarImpress 5.0 Template [.vor] vor3 - StarDraw 3.0 Template (OpenOffice.org Impress) [.vor] vor4 - StarImpress 4.0 Template [.vor] vor5 - StarDraw 5.0 Template (OpenOffice.org Impress) [.vor] wmf - Windows Metafile [.wmf] xhtml - XHTML [.xml] xpm - X PixMap [.xpm] The following list of spreadsheet formats are currently available: csv - Text CSV [.csv] dbf - dBASE [.dbf] dif - Data Interchange Format [.dif] html - HTML Document (OpenOffice.org Calc) [.html] ods - ODF Spreadsheet [.ods] ooxml - Microsoft Excel 2003 XML [.xml] ots - ODF Spreadsheet Template [.ots] pdf - Portable Document Format [.pdf] sdc - StarCalc 5.0 [.sdc] sdc4 - StarCalc 4.0 [.sdc] sdc3 - StarCalc 3.0 [.sdc] slk - SYLK [.slk] stc - OpenOffice.org 1.0 Spreadsheet Template [.stc] sxc - OpenOffice.org 1.0 Spreadsheet [.sxc] uos - Unified Office Format spreadsheet [.uos] vor3 - StarCalc 3.0 Template [.vor] vor4 - StarCalc 4.0 Template [.vor] vor - StarCalc 5.0 Template [.vor] xhtml - XHTML [.xhtml] xls - Microsoft Excel 97/2000/XP [.xls] xls5 - Microsoft Excel 5.0 [.xls] xls95 - Microsoft Excel 95 [.xls] xlt - Microsoft Excel 97/2000/XP Template [.xlt] xlt5 - Microsoft Excel 5.0 Template [.xlt] xlt95 - Microsoft Excel 95 Template [.xlt]
Jerry-Yang's Log 