#LDOCE5 Viewer

The LDOCE5 Viewer is an alternative dictionary viewer for the Longman Dictionary of Contemporary English 5th Edition (LDOCE 5).

Website: http://hakidame.net/ldoce5viewer/

It runs on Linux, Mac OS X and Microsoft Windows.

This software is free and open source software licensed under the terms of GPLv3.

##Prerequisites

• Longman Dictionary of Contemporary English 5th Edition (DVD-ROM)

• Python 2.7 or 2.6 (or 3.x)

• Development tools for PyQt4

  • pyqt4-dev-tools (Ubuntu/Mint/Debian), pyqt4-dev-tools (Arch Linux)

• lxml

  • python-lxml (Ubuntu/Mint/Debian), python-lxml (Arch Linux)

• Whoosh 2.x

  • python-whoosh (Ubuntu/Mint/Debian), python-whoosh in AUR (Arch Linux)

  • If you are on Ubuntu 15+, the default python-whoosh to be installed is 2.7.0+, which may cause error with the application during index. Therefore,you have 2 options :

    • Use pip to install python whoosh 2.5.python-pip pip install whoosh==2.5.7

    • Install .deb file from here to grab the old version (2.5.7) of python-whoosh.

• [On Linux] Python bindings for Gstreamer

  • python-gst0.10 (Ubuntu/Mint/Debian), gstreamer0.10-python (Arch Linux)

• [On Linux] Gstreamer plugins for MP3 audio playback

  • gstreamer0.10-plugins-good & gstreamer0.10-plugins-ugly (Ubuntu/Mint/Debian), gstreamer0.10-good-plugins & gstreamer0.10-ugly-plugins (Arch Linux)

If you're using Ubuntu 15.x, you should install python-qt4-phonon to pronunce words and sentences correctly: - python-qt4-phonon

##Installation

###Linux

####Packages

For Arch Linux, two packages ldoce5viewer and ldoce5viewer-git exist on AUR.

####Manually

1. Enter the following commands in the terminal:

   $ make build
   $ sudo make install

2. Copy the 'ldoce5.data' directory from the LDOCE5 DVD-ROM to an arbitrary location in your HDD or SSD.

3. Start the LDOCE5 Viewer.

4. The application will ask you the location where you put 'ldoce5.data'.

###Mac OS X

(for advanced users)

Homebrew:

$ brew install pyqt
$ pip install lxml pyobjc-core pyobjc-framework-Cocoa whoosh py2app
$ # inside ldoce5viewer directory
$ sudo DISTUTILS_DEBUG=1 python setup.py py2app
$ open dist/LDOCE5\ Viewer.app/

Or if you are using MacPorts:

1. Install the following ports:

   • python27 (or python3x)
   • py27-pyqt4
   • py27-lxml
   • py27-whoosh
   • py27-pyobjc-cocoa

2. Run the LDOCE5 Viewer