node package manager


npm version


Connect javascript applications with for easy internationalization support.

Can be used to upload XMB message files generated from Angular2 i18n process and download translated XTB files suitable for bundling.

Install with npm through published version on

npm install poeditor-connector --save


Requires that you set up a project on and generate an API key. Instructions are available on their API reference

Angular i18n

This project was written specifically to connect an Angular typescript application to for use with the XMB message format.

The Angular documentation on i18n focuses on the XLIFF format, but only supports XMB. XMB is used heavily inside of Google, but is not well documented externally. Note that XMB is the file format for messageterms that have been extracted from the application. XTB is the related file format for the translation output that is actually bunded in the application.


A sample config file is included in the project under config/poeditor.sample.json. This will need to be modified to support your preferred settings

  • apiToken : api token
  • projectId : projectId
  • importFile : relative location of the terms to be posted to the api
  • importSyncTerms : whether or not to delete terms from the project not found in the import file when uploading
  • exportDir : local directory to download translated files
  • exportFiles : hash map of languages to download and the file name to use
  "importSyncTerms": 1,


Use from npm package.json:

  "scripts": {
    "i18n": "npm run compile:aot && ng-xi18n --i18nFormat=xmb && npm run i18n:poeditor",
    "i18n:poeditor": "poeditor --config=./config/poeditor.json" 

invoke from the shell

npm run i18n


MIT. Copyright (c) 2017 Jon Marston.