Pology — The Study of PO

Pology is a Python library and collection of command-line tools for in-depth processing of PO files, the translation file format of the GNU Gettext software translation system. Pology functionality ranges from precision operations on individual PO messages, to cross-file operations on large collections of PO files.

A distinguishing aspect of Pology is that no attempt is made to handle arbitrary translation file formats, as is typical of many translation tools. Pology can thus take advantage not only of all technical aspects of the PO format, but also of the established conventions and workflows revolving around it and Gettext in general. This focus is present on all levels, from the end-user commands to the library file format abstractions.


Some of the prominent elements of Pology functionality include:


Latest release can be downloaded from here:


Older releases can be found in the release/ directory.

Latest development code can be obtained from a Git repository:

git clone https://invent.kde.org/sdk/pology.git

or browsed through a web interface.

Pology has been mostly tested on GNU/Linux-based operating systems. The software which Pology depends on, as well as most of the optional software for additional functionality, is already packaged on these platforms. Pology has been reported to run on contemporary Windows systems, albeit from the source tree only and likely with some reduction in functionality.

Pology is distributed under the terms of GNU GPL, version 3.


The user manual is contained in the Pology distribution, and it will be built from the source if all documentation-generation dependencies are satisfied. The user manual for latest Pology release is available on-line:

HTML — one page per chapter

HTML — everything on single page

There are separate user manuals describing language-specific functionality in Pology (written in corresponding languages). They are available on-line as follows: Serbian by chapter/single page.

For programming with Pology, the API reference is included in the distribution. The online version for the latest Pology release is here:

HTML — one page per node


At the moment, all communication should be directed to the Pology mailing list. This includes questions about usage, development discussion, and bug reports. You do not need to be subscribed to post to the list, but expect some moderation delay in that case.

Pology maintainer can also be reached directly at: Chusslove Illich <caslav.ilic@gmx.net>.