PyGlossary is a tool for converting dictionary files aka glossaries, from/to various formats used by different dictionary applications

Linux - Gtk3-based interface

Windows - Tkinter-based interface

Linux - command line interface

Legend:

• 📁 Directory
• 📝 Text file
• 📦 Package/archive file
• 🔢 Binary file
• ✔ Supported
• ❌ Will not be supported

PyGlossary requires Python 3.6 or higher, and works in practically all modern operating systems. While primarilly designed for GNU/Linux, it works on Windows, Mac OS X and other Unix-based operating systems as well.

As shown in the screenshots, there are multiple User Interface types, ie. multiple ways to use the program.

• Gtk3-based interface, uses PyGI (Python Gobject Introspection) You can install it on:

  • Debian/Ubuntu: apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0
  • openSUSE: zypper install python3-gobject gtk3
  • Fedora: dnf install pygobject3 python3-gobject gtk3
  • Archlinux:
    • pacman -S python-gobject gtk3
    • https://aur.archlinux.org/packages/pyglossary/
  • Mac OS X: brew install pygobject3 gtk+3
  • Nix / NixOS: nix-shell -p gnome3.gobjectIntrospection python37Packages.pygobject3 python37Packages.pycairo

• Tkinter-based interface, works in the lack of Gtk. Specially on Windows where Tkinter library is installed with the Python itself. You can also install it on:

  • Debian/Ubuntu: apt-get install python3-tk tix
  • openSUSE: zypper install python3-tk tix
  • Fedora: yum install python3-tkinter tix
  • Mac OS X: read https://www.python.org/download/mac/tcltk/
  • Nix / NixOS: nix-shell -p python37Packages.tkinter tix

• Command-line interface, works in all operating systems without any specific requirements, just type:

  python3 main.py --help

When you run the program without any command line arguments or options, PyGlossary tries to find PyGI, if it's installed, opens the Gtk3-based interface, if it's not, tries to find Tkinter and open the Tkinter-based interface. And exits with an error if neither are installed.

But you can explicitly determine the user interface type using --ui, for example:

python3 main.py --ui=gtk

Or

python3 main.py --ui=tk

• Using --remove-html-all flag

  sudo pip3 install lxml beautifulsoup4

• Reading from FreeDict or XDXF

  sudo pip3 install lxml

• Reading from Babylon BGL: Python 3.6 to 3.7 is recommended

• Reading from CC-CEDICT

  sudo pip3 install jinja2

• Reading from Octopus Mdict (MDX)

  • python-lzo, required for some MDX glossaries

    • First try converting your MDX file, and if failed (AssertionError probably), then you may need to install LZO library and Python binding:

    • On Linux, make sure liblzo2-dev or liblzo2-devel is installed and then run sudo pip3 install python-lzo

    • On Windows:

      • Open this page: https://www.lfd.uci.edu/~gohlke/pythonlibs/#python-lzo
      • If you are using Python 3.7 (32 bit) for example, click on python_lzo‑1.12‑cp37‑cp37m‑win32.whl
      • Open Start -> type Command -> right-click on Command Prompt -> Run as administrator
      • Run pip install C:\....\python_lzo‑1.12‑cp37‑cp37m‑win32.whl command, giving the path of downloaded file

• Reading or writing Aard 2 (.slob) files

  sudo pip3 install PyICU

• Writing to Kobo E-Reader Dictionary

  sudo pip3 install marisa-trie

If you want to add your own plugin without adding it to source code directory, or you want to use a plugin that has been removed from repository, you can place it in this directory:

• Linux: ~/.pyglossary/plugins/
• Mac: ~/Library/Preferences/PyGlossary/plugins
• Windows: C:\Users\USERNAME\AppData\Roaming\PyGlossary\plugins

See doc/apple.md for AppleDict requirements and instructions.