1UNOCONV(1) UNOCONV(1)
2
3
4
6 unoconv - convert any document from and to any OpenOffice supported
7 format
8
10 unoconv [options] file [file2 ..]
11
12 unoconv --listener [--server SRV] [--port PRT] [--connections CON]
13
14
16 unoconv is a command line utility that can convert any file format that
17 OpenOffice can import, to any file format that OpenOffice is capable of
18 exporting.
19
20 unoconv uses the OpenOffice’s UNO bindings for non-interactive
21 conversion of documents and therefor needs an OpenOffice instance to
22 communicate with. Therefore if it cannot find one, it will start its
23 own instance for temporary usage. If desired, one can start a
24 “listener” instance to use for subsequent connections or even for
25 remote connections.
26
27
29 -c, --connection
30 UNO connection string to be used by the client to connect to an
31 OpenOffice instance, or used by the listener to make OpenOffice
32 listen.
33
34 Default connection string is "socket,host=localhost,port=2002;urp;StarOffice.ComponentContext"
35
36 -d, --doctype
37 Specify the OpenOffice document type of the backend format.
38 Possible document types are: document, graphics, presentation,
39 spreadsheet.
40
41 Default document type is 'document'.
42
43 -e, --export
44 Set specific export filter options (related to the used
45 OpenOffice filter).
46
47 eg. for the PDF output filter one can specify: -e PageRange=1-2
48
49 -f, --format
50 Specify the output format for the document. You can get a list
51 of possible output formats per document type by using the --show
52 option.
53
54 Default document type is 'pdf'.
55
56 -i, --import
57 Set specific import filters options (related to the used
58 OpenOffice filter).
59
60 eg. for some input filters one can specify: -i utf8
61
62 -l, --listener
63 Start unoconv as listener for unoconv clients to connect to.
64
65 -o, --outputpath
66 Directory to put converted documents.
67
68 --pipe Use a pipe as an alternative connection mechanism to talk to
69 OpenOffice.
70
71 -p, --port
72 Port to listen on (as listener) or to connect to (as client).
73
74 Default port is '2002'.
75
76 -s, --server
77 Server (address) to listen on (as listener) or to connect to (as
78 client).
79
80 Default server is 'localhost'.
81
82 --show List the possible output formats to be used with -f.
83
84 --stdout
85 Print converted output file to stdout.
86
87 -t, --template
88 Specify the template to use for importing styles from. This can
89 be very useful if you have a corporate identity you have to
90 apply to every document you distribute.
91
92 -T, --timeout
93 When unoconv starts its own listener, try to connect to it for
94 an amount of seconds before giving up. Increasing this may help
95 when you receive random errors caused by the listener not being
96 ready to accept conversion jobs.
97
98 -v, --verbose
99 Be more and more and more verbose.
100
102 You can provide one or more files as arguments to convert each of them
103 to the specified output format.
104
105
107 You can use unoconv in standalone mode, this means that in absence of
108 an OpenOffice listener, it will starts its own:
109
110
111 unoconv -f pdf some-document.odt
112 One can use unoconv as a listener (by default localhost:2002) to let
113 other unoconv instances connect to it:
114
115
116 unoconv --listener &
117 unoconv -f pdf some-document.odt
118 unoconv -f doc other-document.odt
119 unoconv -f jpg some-image.png
120 unoconv -f xsl some-spreadsheet.csv
121 kill -15 %-
122 This also works on a remote host:
123
124
125 unoconv --listener --server 1.2.3.4 --port 4567
126 and then connect another system to convert documents:
127
128
129 unoconv --server 1.2.3.4 --port 4567
130
132 unoconv uses the UNO bindings to connect to OpenOffice, in absence of a
133 usable socket, it will start its own OpenOffice instance with the
134 correct parameters.
135
136
137 Note
138 Please see the TODO file for known bugs and future plans.
139
140
142 convert(1), file(1), odt2txt
143
145 unoconv is very useful together with the following tools:
146
147
148 Asciidoc
149 [1]http://www.methods.co.nz/asciidoc/
150
151 docbook2odf
152 [2]http://open.comsultia.com/docbook2odf/ A list of possible
153 import and export formats is available from:
154
155
156 OpenOffice 2.1
157 [3]http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_2_1
158
159 OpenOffice 3.0
160 [4]http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_3_0
161
163 Written by Dag Wieers, <[5]dag@wieers.com>
164
165
167 Main web site: [6]http://dag.wieers.com/home-made/unoconv/
168
169
171 Copyright (C) 2007 Dag Wieers. Free use of this software is granted
172 under the terms of the GNU General Public License (GPL).
173
174
176 Dag Wieers <dag@wieers.com>.
177
179 1. http://www.methods.co.nz/asciidoc/
180 http://www.methods.co.nz/asciidoc/
181
182 2. http://open.comsultia.com/docbook2odf/
183 http://open.comsultia.com/docbook2odf/
184
185 3. http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_2_1
186 http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_2_1
187
188 4. http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_3_0
189 http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_3_0
190
191 5. dag@wieers.com
192 mailto:dag@wieers.com
193
194 6. http://dag.wieers.com/home-made/unoconv/
195 http://dag.wieers.com/home-made/unoconv/
196
197
198
199 0.4 20 october 2010 UNOCONV(1)