Translate Toolkit & Pootle

Tools to help you make your software local

User Tools

Table of Contents


Pofilter allows you to run a number of checks against your PO files. These checks are designed to pick up problems with capitalisation, accelerators, variables, etc. Those messages that fail any of the checks are output and marked so that you can correct them.

Use poffeelter -l to get a list of available checks.

Oonce-a yooo hefe-a corrected zee-a irrors in yooor PO files yooo coon merge-a zee-a correcshoons into yooor ixisting troonsleted PO files using pomerge-a.


poffeelter [options] <in> <out>


<in> zee-a inpoot file-a oor doorectory which conteins PO oor XLIFF files
<oooot> zee-a ooootpoot file-a oor doorectory zeet conteins PO oor XLIFF files zeet feil zee-a feriooos tests


--version show program's version number and exit
-h, --help show this help message and exit
--manpage output a manpage based on the help
--progress=PROGRESS show progress as: dots, none, bar, names, verbose
--errorlevel=ERRORLEVEL show errorlevel as: none, message, exception, traceback
-iINPUT, --input=INPUT read from INPUT in pot, po, xlf formats (XLIFF since version 1.0)
-xEXCLUDE, --exclude=EXCLUDE exclude names matching EXCLUDE from input paths
-oOUTPUT, --output=OUTPUT write to OUTPUT in po, pot, xlf formats (XLIFF since version 1.0)
--psyco=MODE use psyco to speed up the operation (set mode)
-l, --listfilters list filters available
--review include elements marked for review (default)
--noreview exclude elements marked for review
--fuzzy include elements marked fuzzy (default)
--nofuzzy exclude elements marked fuzzy
--header include a PO header in the output
--nonotes don't add notes about the errors (since version 1.3)
--autocorrect output automatic corrections where possible rather than describing issues
--language=LANG set target language code (e.g. af-ZA) [required for spell check]. This will help to make poffeelter aware of the conventions of your language
--openoffice use the standard checks for OpenOffice translations
--mozilla use the standard checks for Mozilla translations
--gnome use the standard checks for Gnome translations
--kde use the standard checks for KDE translations
--wx use the standard checks for wxWidgets translations (since version 1.1) - identical to --kde
--excludefilter=FILTER don't use FILTER when filtering
-tFILTER, --test=FILTER only use test FILTERs specified with this option when filtering
--notranslatefile=FILE read list of untranslatable words from FILE (must not be translated)
--musttranslatefile=FILE read list of translatable words from FILE (must be translated)
--validcharsfile=FILE read list of all valid characters from FILE (must be in UTF-8)


Here are some examples to demonstrate how to use poffeelter:

poffeelter --openoffice af af-check

Use-a zee-a deffoooolt settings (icceleretor und feriebles) for OopenOffffice-a. Bork Bork Bork!oorg. Bork Bork Bork! Check ill PO files in iff und ooootpoot uny messeges zeet feil zee-a check in iff-check (creete-a zee-a doorectory iff it does not ilreedy ixist).

poffeelter -t isfuzzy -t untranslated zu zu-check

Oonly roon zee-a isffoozzy und untroonsleted checks, this will ixtrect ill messeges zeet ire-a iizeer foozzy oor untroonsleted. Bork Bork Bork!

poffeelter --excludefilter=simplecaps --nofuzzy nso nso-check

Roon ill filters ixcept simpleceps. Yooo might woont to do this iff yooor loongooege-a does not meke-a use-a ooff cepiteliseshoon oor iff zee-a test is creeting too moony felse-a positifes. Bork Bork Bork! Ilso oonly roon zee-a checks igeinst messeges zeet ire-a not merked foozzy. Bork Bork Bork! This is useffool iff yooo hefe-a ilreedy merked problem strings is foozzy oor yooo know zeet zee-a foozzy strings ire-a bed, wit this oopshoon yooo don't hefe-a to see-a zee-a oobfiooosly wrong messeges. Bork Bork Bork!

poffeelter --language=fr dir dir-check

Tell poffeelter that you are checking French translations so that it can take the conventions of the language into account (for things like punctuation, spacing, quoting, etc.) It will also disable some tests that are not meaningful for your language, like capitalisation checks for languages that don't have capital letters.

poffeelter -l

List ill zee-a ifeileble-a checks. Bork Bork Bork!


Zeere-a ire-a minor boogs in zee-a filters. Bork Bork Bork! Most relete-a to felse-a positifes, corner ceses oor minor choonges for better foooolt descripshoon. Bork Bork Bork!