Universal Office Converter (unoconv)

Revision as of 07:11, 18 May 2016 by Damyon Wiese (talk | contribs) (Installing unoconv on Windows)

Jump to: navigation, search

Installing unoconv

"unoconv" is a command line program that is used to convert between different office document file formats. It uses an instance of LibreOffice to do the conversion and is used by the assignment module to convert documents to pdf so that they can be annotated. If unoconv is not installed - the only impact is that the assignment module will only allow annotations when students upload a pdf document.

The steps required to install unoconv are different depending on the operating system that you have installed Moodle on.

Installing unoconv on Linux

The required version of unoconv is at least 0.7. Depending on your flavour of linux, this may be available in your package manager and you can install it directly with:

(Ubuntu 16.04 LTS)

apt-get install unoconv

If your package manager contains an older version of the package, you will have to find a newer version and install it manually (Debian Testing). Unoconv itself is just a python script, so it has few dependencies.

Installing unoconv on OS X


Installing unoconv on Windows

Step 1. Download and install LibreOffice for windows.

Step 2. Download the latest version of the unoconv script from https://github.com/dagwieers/unoconv/releases.

Step 3. Rename the downloaded script to C:\unoconv\unoconv.py

Step 4. Create a batch file C:\unoconv\unoconv.bat with these contents:

echo off
cd "C:\unoconv"
"C:\Program Files\LibreOffice 5\program\python-core-3.3.0\bin\python.exe" unoconv.py %* 

Step 5. Set paths in Moodle. Login as admin and go to Site administration ► Server ► System paths Set pathtogs setting to your ghostscript installation binary, (C:\gs\bin\gswin32.exe) Set pathtounoconv to the batch file created above (C:\unoconv\unoconv.bat) Step 6. Test ghostscript and unoconv are working correctly in the admin test pages Site administration ► Plugins ► Activity modules ► Assignment ► Feedback plugins ► Annotate PDF.

Run a unoconv listener

unoconv utilises a client/server process when converting documents. By default, when there is no running server process - each time unoconv runs it will start a server process, send it's request and shutdown the server process when the request is complete. The drawback of this mode is that if 2 requests are submitted simultaneously - this can cause the first request to shutdown the server process when the second request is still in progress - and the second conversion request fails. A more robust way to configure unoconv is to start a server process at boot time, and run a script to monitor it and restart it if it crashes.

To start a unoconv listener at boot time on linux - you need a start up script. Different linux distributions use different startup scripts - but here is an example of an init.d script for debian systems.

Init script for Debian

Offload processing to a different server

Processing office documents can put increased load on your webserver, which may impact on the responsiveness of your site. If you are installing unoconv on a large site you may want to consider running unoconv on a server that is not also serving web requests.

How to do this:


Additional Resources

The unoconv documentation site has additional information on installation of unoconv and troubleshooting tips.