goldendict-ng/README.md

6.8 KiB
Raw Blame History

Codacy Badge Windows Ubuntu macos

GoldenDict

A feature-rich dictionary lookup program, supporting multiple dictionary formats (StarDict/Babylon/Lingvo/Dictd/AARD/MDict/SDict) and online dictionaries, featuring perfect article rendering with the complete markup, illustrations and other content retained, and allowing you to type in words without any accents or correct case.

Installation

Windows and macOS

Download latest stable version or daily pre-release builds.

.exe for Windows users and .dmg for macOS users.

Linux

The download links above includes .Appimage for Linux users.

Archlinux users can also use community maintained goldendict-webengine-git.

Debian packages are available in Debian 12 or later.

Ubuntu packages are available in Ubuntu 23.04 or later.

openSUSE ships an old version of this fork.

Helps are needed to deliver this fork to other distros!

Build from source

Dependencies

  • C++17 compiler
  • Qt 5.15 or latest QT version 6.X
  • Various libraries on Linux, see below
  • On Mac and Windows all the libraries are included in the repository
  • Qt Creator is recommended for development

Steps below are using qt5, and you may use qt6 by replacing 5 with 6.

Ubuntu

sudo apt-get install git pkg-config build-essential qt5-qmake \
        libvorbis-dev zlib1g-dev libhunspell-dev x11proto-record-dev \
        qtdeclarative5-dev libxtst-dev liblzo2-dev libbz2-dev \
        libavutil-dev libavformat-dev libtiff5-dev libeb16-dev \
        libqt5svg5-dev libqt5x11extras5-dev qttools5-dev \
        qttools5-dev-tools qtmultimedia5-dev libqt5multimedia5-plugins libqt5webchannel5-dev qtwebengine5-dev

Fedora 35

sudo dnf install git pkg-config libzstd-devel opencc-devel xz-devel xz-lzma-compat\
     libvorbis-devel zlib-devel hunspell-devel lzo-devel bzip2-devel \
     ffmpeg-devel libtiff-devel eb-devel qt5-qtx11extras-devel libXtst-devel \
     libxkbcommon-devel qt5-qtbase qt5-qttools qt5-qtsvg-devl qt5-qtwebengine-devel qt5-qtmultimedia-devel

Build steps

Clone this repository:

git clone https://github.com/xiaoyifang/goldendict.git

Linux build

cd goldendict && qmake-qt5 && make

macOS build

brew install qt # or use official offline installer
qmake CONFIG+=release CONFIG+=zim_support   CONFIG+=chinese_conversion_support QMAKE_APPLE_DEVICE_ARCHS="x86_64 arm64"
make 
make install

Windows build

the source code has offered precompile x64 windows libs on winlibs/lib/msvc. you can build your own version either.

To build with Visual Studio. check this how to build with visual studio

Alternatively, you might want to load goldendict.pro file from within Qt Creator.

Build Configurations

Notice: All additional configs for qmake that must be combined in one of pass config options to qmake:

qmake-qt5 "CONFIG+=release" "CONFIG+=zim_support" "CONFIG+=chinese_conversion_support"

To ensure the changes applied, you may want to use make clean before make.

Building with Chinese conversion support

To add Chinese conversion support you need at first install libopencc-dev package, then pass "CONFIG+=chinese_conversion_support" to qmake.

sudo apt-get install libopencc-dev

Building with Zim dictionaries support

To add Zim and Slob formats support you need at first install lzma-dev and zstd-dev packages, then pass "CONFIG+=zim_support" to qmake

sudo apt-get install liblzma-dev libzstd-dev

Building without extra tiff handler( DEPRECATED )

deprecated: qt has offered b/w tiff support which means this options should always enabled. intend to remove in the future.

If you have problem building with libtiff5-dev package, you can pass "CONFIG+=no_extra_tiff_handler" to qmake in order to disable extra tiff support (without such extra support some b/w tiff images will not be displayed):

Building without Epwing format support

If you have problem building with libeb-dev package, you can pass "CONFIG+=no_epwing_support" to qmake in order to disable Epwing format support

Building without internal audio players

If you have problem building with FFmpeg (for example, very old linux distro), you can pass "CONFIG+=no_ffmpeg_player" to qmake in order to disable FFmpeg internal audio player back end.

If you have problem building with Qt5 Multimedia or experience GStreamer run-time errors (for example, Ubuntu 14.04), you can pass "CONFIG+=no_qtmultimedia_player" to qmake in order to disable Qt Multimedia internal audio player back end.

Building with xapian

build xapian from source, download and extract the xapian-core source code.

./configure
make 
make install

On Windows,follow the instructions in the xapian-core/INSTALL Visual Studio parts.xapian does not support to use the Debug lib in Windows. have to debug in release version mode using xapian's release lib. A precompiled version of xapian lib has provided in winlibs

use CONFIG+=use_xapian to enable this feature. when enabled ,xapian will be used to support as the the fulltext's backend engine.

qmake "CONFIG+=use_xapian"

Contributing

All kinds of help like answering questions, bug reporting, testing translation and coding are welcomed.

To start coding, the easiest way is load the goldendict.pro file to Qt Creator, make some changes then press the run button.

Support

Bug reporting: GoldenDict issue tracker

General discussions: discussions

License

This project is licensed under the GNU GPLv3+ license, a copy of which can be found in the LICENSE.txt file.

History

The original project was developed at http://goldendict.org/ and https://github.com/goldendict/goldendict.