Skip to main content

Translate Toolkit

Released version https://readthedocs.org/projects/translate-toolkit/badge/ Supported Python versions License

The Translate Toolkit is an essential toolkit for localization engineers. It contains tools and documentation to help localizers convert, count, manipulate, review and debug localization files with less repetitive work.

The software includes programs to convert localization formats to the common PO and XLIFF formats. There are also programs to check and manage PO and XLIFF files. The Toolkit is part of the Translate project, hosted at <https://github.com/translate/translate>.

At its core the software contains Python classes for handling localization storage formats such as DTD, properties, OpenOffice.org GSI/SDF, CSV, MO, Qt .ts, TMX, TBX, WordFast txt, Gettext .mo, Windows RC, PO and XLIFF. It also provides scripts to convert between these formats.

Features

  • Format converters for localization, translation and software formats, so translators can work in standard translation formats.

  • Quality assurance tools for pattern searches, language-aware checks, terminology extraction and other review tasks.

  • Python APIs that can be expanded with new formats, project types, localization tests and language modules.

Project goals

The vision of the Translate Project is to be a meta project for localizers built on the premise that your language deserves to be a project on its own right not a poor cousin of the main project.

Most projects are inattentive to the needs and difficulties experienced by localizers. To that end the aim is to work towards creating tools and documentation that allows localizers to focus on what they do best: translating software.

Requirements

The recommended installation is using uv or pip in a virtual environment:

uv pip install translate-toolkit

or:

pip install translate-toolkit

You can also download a stable released version from <https://github.com/translate/translate/releases> and install it manually.

The Toolkit requires Python 3.11 or newer. The required runtime dependencies are lxml>=6.1.0,<7.0 and unicode-segmentation-rs>=0.2.0,<0.3.

There are several optional dependencies for format-specific features and speed ups. They can be requested as extras during installation:

# Install all optional dependencies
pip install translate-toolkit[all]

# Install selected optional dependencies
pip install translate-toolkit[markdown,ini,ical,subtitles,yaml,spellcheck]

Available extras include chardet, fluent, ical, ini, levenshtein, markdown, php, rc, spellcheck, subtitles, toml and yaml. Please check pyproject.toml for the current dependency versions.

Program overview

Use --help to find the syntax and options for all programs.

  • Converters:

    oo2po    - convert between OpenOffice.org GSI files and PO
    oo2xliff - convert between OpenOffice.org GSI files and XLIFF
    moz2po   - convert between Mozilla files and PO
    csv2po   - convert PO format to CSV for editing in a spreadsheet program
    php2po   - PHP localisable string arrays converter.
    ts2po    - convert Qt Linguist (.ts) files to PO
    txt2po   - convert simple text files to PO
    html2po  - convert HTML to PO (beta)
    md2po    - convert Markdown to PO
    xliff2po - XLIFF (XML Localisation Interchange File Format) converter
    prop2po  - convert Java .properties files to PO
    po2wordfast - Wordfast Translation Memory converter
    po2tmx   - TMX (Translation Memory Exchange) converter
    pot2po   - PO file initialiser
    csv2tbx  - Create TBX (TermBase eXchange) files from Comma Separated
               Value (CSV) files
    ini2po   - convert .ini files to PO
    ical2po  - Convert iCalendar files (*.ics) to PO
    sub2po   - Convert many subtitle files to PO
    rc2po    - convert Windows Resource .rc files to PO
    resx2po  - convert .Net Resource (.resx) files to PO
  • Tools (Quality Assurance):

    pofilter - run any of the 40+ checks on your PO files
    pomerge  - merge corrected translations from pofilter back into
               your existing PO files.
    poconflicts - identify conflicting use of terms
    porestructure - restructures po files according to poconflict directives
    pogrep   - find words in PO files
  • Tools (Other):

    pocompile - create a Gettext MO files from PO or XLIFF files
    pocount   - count translatable file formats (PO, XLIFF)
    podebug   - Create comment in your PO files' msgstr which can
                then be used to quickly track down mistranslations
                as the comments appear in the application.
    posegment - Break a PO or XLIFF files into sentence segments,
                useful for creating a segmented translation memory.
    poswap    - uses a translation of another language that you
                would rather use than English as source language
    poterminology - analyse PO or POT files to build a list of
                    frequently occurring words and phrases

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

translate_toolkit-3.19.19.tar.gz (628.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

translate_toolkit-3.19.19-py3-none-any.whl (858.1 kB view details)

Uploaded Python 3

File details

Details for the file translate_toolkit-3.19.19.tar.gz.

File metadata

  • Download URL: translate_toolkit-3.19.19.tar.gz
  • Upload date:
  • Size: 628.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for translate_toolkit-3.19.19.tar.gz
Algorithm Hash digest
SHA256 f8099801886845f46f63457ceb312284421b76711e76e9053b9c1ae50b2faf16
MD5 7c61122e5e592d431d78822a5137e569
BLAKE2b-256 a36572c1346001fc92f3b2f69d126918f5f7ef96c9ad439256b05a614ca7df1c

See more details on using hashes here.

Provenance

The following attestation bundles were made for translate_toolkit-3.19.19.tar.gz:

Publisher: setup.yml on translate/translate

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file translate_toolkit-3.19.19-py3-none-any.whl.

File metadata

File hashes

Hashes for translate_toolkit-3.19.19-py3-none-any.whl
Algorithm Hash digest
SHA256 6fb0dd92fc1214a1dc1a5632dfbc22409a18747ccf565708b4f29b53146c0650
MD5 0acf4b99635f85657b6ff0cf64eb0a8e
BLAKE2b-256 0bf4f0c67b05b331eaea68bdb065491bbf02ac32009e3edd2797fe5d2663ed17

See more details on using hashes here.

Provenance

The following attestation bundles were made for translate_toolkit-3.19.19-py3-none-any.whl:

Publisher: setup.yml on translate/translate

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

3.20.0

2 files

This release

3.19.19 This release

2 files

3.19.18

2 files

3.19.17

2 files

3.19.16

2 files

3.19.15

2 files

3.19.14

2 files

3.19.13

2 files

3.19.12

2 files

3.19.11

2 files

3.19.10

2 files

3.19.9

2 files

3.19.8

2 files

3.19.7

2 files

3.19.6

2 files

3.19.5

2 files

3.19.4

2 files

3.19.3

2 files

3.19.2

2 files

3.19.1

2 files

3.19.0

2 files

3.18.1

2 files

3.18.0

2 files

3.17.5

2 files

3.17.4

2 files

3.17.3

2 files

3.17.2

2 files

3.17.1

2 files

3.17.0

2 files

3.16.3

2 files

3.16.2

2 files

3.16.1

2 files

3.16.0

2 files

3.15.6

2 files

3.15.5

2 files

3.15.4

2 files

3.15.3

2 files

3.15.2

2 files

3.15.1

2 files

3.15.0

2 files

3.14.8

2 files

3.14.7

2 files

3.14.6

2 files

3.14.5

2 files

3.14.4

2 files

3.14.3

2 files

3.14.2

2 files

3.14.1

2 files

3.14.0

2 files

3.13.5

2 files

3.13.4

2 files

3.13.3

2 files

3.13.2

2 files

3.13.1

2 files

3.13.0

2 files

3.12.2

2 files

3.12.1

2 files

3.12.0

2 files

3.11.1

2 files

3.11.0

2 files

3.10.1

2 files

3.10.0

2 files

3.9.2

2 files

3.9.1

2 files

3.9.0

2 files

3.8.6

2 files

3.8.5

2 files

3.8.4

2 files

3.8.3

2 files

3.8.2

2 files

3.8.1

2 files

3.8.0

2 files

3.7.4

2 files

3.7.3

2 files

3.7.2

2 files

3.7.1

2 files

3.7.0

2 files

3.6.2

1 file

3.6.1

1 file

3.6.0

1 file

3.5.3

1 file

3.5.2

1 file

3.5.1

1 file

3.5.0

1 file

3.4.1

1 file

3.4.0

1 file

3.3.6

1 file

3.3.5

1 file

3.3.4

1 file

3.3.3

1 file

3.3.2

1 file

3.3.1

1 file

3.3.0

1 file

3.2.0

1 file

3.1.1

1 file

3.1.0

1 file

3.0.0

1 file

2.5.1

1 file

2.5.0

1 file

2.4.0

1 file

2.3.1

1 file

2.3.0

1 file

2.2.5

1 file

2.2.4

1 file

2.2.3

1 file

2.2.2

1 file

2.2.1

1 file

2.2.0

1 file

2.1.0

1 file

2.0.0

1 file

1.13.0

1 file

1.12.0

1 file

1.11.0

1 file

1.10.0

1 file

1.9.0

1 file

1.8.0

1 file

1.7.0

1 file

1.6.0

1 file

1.5.3

1 file

1.5.1

1 file

1.1.1

1.1.0

1.0.1

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page