PYGLOSSARY(1)

✨ NAME ✨

PyGlossary — a tool for converting dictionary files 💖

---

🌈 DESCRIPTION 🌈

Okay so bestie, listen: PyGlossary is a tool for working with dictionary databases (glossaries). That's the whole vibe. It's giving "I hold your word lists and I convert them, no cap." 👑

🎀 Basic Usage 🎀

🫶 PyGI (Gtk3) Interface:

To open the PyGI window:

pyglossary

PyGI is the default interface, so you literally never need to use --ui=gtk. And if PyGI wasn't found (not installed), then PyGlossary will fallback to the Tkinter interface. Iconic behaviour honestly. ✨

🦋 Tkinter Interface:

To open the PyGlossary window:

pyglossary --ui=tk

Usually good for Windows and Mac OS X 💅

🧚 Command Line Interface:

To show this help:

pyglossary --help

To show program version:

pyglossary --version

To Convert:

pyglossary INPUT_FILE OUTPUT_FILE

To Reverse:

pyglossary INPUT_FILE OUTPUT_FILE.txt --reverse

Input and output file formats will be detected from the extensions. Except when you explicitly specify the input or output format — for example:

pyglossary mydic.utf8 mydic.ifo --read-format=tabfile
pyglossary mydic.utf8 mydic.ifo --read-format tabfile
pyglossary mydic.ifo mydic.utf8 --write-format=tabfile
pyglossary mydic.ifo mydic.utf8 --write-format tabfile

💜 General Options 💜

🌸 Verbosity:

• -v0 or --verbosity 0 — critical errors only 🚨
• -v1 or --verbosity 1 — errors only
• -v2 or --verbosity 2 — errors and warnings
• -v3 or --verbosity 3 — errors, warnings and info
• -v4 or --verbosity 4 — debug mode 🐛 (main character energy, it tells you everything)

⭐ Appearance:

• --no-progress-bar and --no-color — useful for Windows (non-Unix) command line 🪟

🔥 Full Convert Usage 🔥

pyglossary INPUT_FILE OUTPUT_FILE [-vN] [--read-format=FORMAT]
[--write-format=FORMAT]

[--sort|--no-sort] [--direct|--indirect] [--sort-cache-size=2000]
[--utf8-check|--no-utf8-check] [--lower|--no-lower]
[--read-options=READ_OPTIONS] [--write-options=WRITE_OPTIONS]

Command line arguments and options (and arguments for options) are parsed with the GNU getopt method. iykyk 😌

You can also just type the extension of the output file instead of the full path, if you want to create it with the same input file name but another extension. For example:

pyglossary mydic.ifo txt

instead of:

pyglossary mydic.ifo mydic.txt

Compressing with gz, bz2 and zip is supported — just append these extensions to the file name, for example:

pyglossary mydic.ifo mydic.txt.gz

or

pyglossary mydic.ifo txt.gz

And if the input file has these extensions (gz, bz2, zip), it will be extracted before loading. Unzip and slay 💅

---

🍓 Supported input formats 🍓

• BabylonBgl — Babylon (bgl) — extensions: .bgl
• CC-CEDICT — CC-CEDICT — extensions: .u8
• Csv — CSV — extensions: .csv
• Dicformids — DictionaryForMIDs — extensions: .mids
• DictOrg — DICT.org file format (.index) — extensions: .index
• ABBYYLingvoDSL — ABBYY Lingvo DSL (dsl) — extensions: .dsl
• Edlin — Editable Linked List of Entries — extensions: .edlin
• GettextPo — Gettext Source (po) — extensions: .po
• LingoesLDF — Lingoes Source (LDF) — extensions: .ldf
• OctopusMdict — Octopus MDict — extensions: .mdx
• OctopusMdictSource — Octopus MDict Source — extensions: .mtxt
• Sdict — Sdictionary Binary(dct) — extensions: .dct
• Stardict — StarDict (ifo) — extensions: .ifo
• Tabfile — Tabfile (txt, dic) — extensions: .txt .tab .dic
• WikipediaDump — Wikipedia Dump(Static HTML) — extensions: .wiki
• Xdxf — XDXF — extensions: .xdxf .xml

🦄 Supported output formats 🦄

• AppleDict — AppleDict Source (xml) — extensions: .xml
• BabylonSource — Babylon Source (gls) — extensions: .gls .babylon
• Csv — CSV — extensions: .csv
• Dicformids — DictionaryForMIDs — extensions: .mids
• DictOrg — DICT.org file format (.index) — extensions: .index
• Edlin — Editable Linked List of Entries — extensions: .edlin
• Freedict — FreeDict (tei) — extensions: .tei
• GettextPo — Gettext Source (po) — extensions: .po
• LingoesLDF — Lingoes Source (LDF) — extensions: .ldf
• OctopusMdictSource — Octopus MDict Source — extensions: .mtxt
• Omnidic — Omnidic — extensions: .omni .omnidic
• SdictSource — Sdictionary Source (sdct) — extensions: .sdct
• Sql — SQL — extensions: .sql
• Stardict — StarDict (ifo) — extensions: .ifo
• Tabfile — Tabfile (txt, dic) — extensions: .txt .tab .dic
• Treedict — TreeDict — extensions: .tree .treedict

---

That's the whole page bestie, go convert something and be iconic 💖

And that's a wrap on PyGlossary 3.2.1, dated December 2019 — literally vintage, still eating 🎀✨🦋