Hyva i18n CSV Diff

hyva-themes/magento2-i18n-csv-diff

Adds CLI commands to compare Magento translation CSV files and automatically translate missing strings using the DeepL API. Useful for maintaining Hyva and custom theme translations.

Known issuesBuild failingsilver partnerSemVer violations (33% compliant)

Supported Magento versions: 2.4.9

2,631 installs★ 13 starsLatest: v1.0.3Released 2026-08-31License: OSL-3.0

composer require hyva-themes/magento2-i18n-csv-diff

README

Reproduced from the package’s own README, under its own license, as of 2026-09-13. Links and images point back at the source repository.

Hyvä Themes - Magento translation CSV comparison command

hyva-themes/magento2-i18n-csv-diff

This module adds the bin/magento i18n:diff-csv and i18n:translate-csv commands.

i18n:diff-csv

The command takes two CSV files as arguments.
It displays all translations that are present in the first CSV file but not in the second, based on the first colum in the files.

i18n:translate

The command takes a target language 2-letter ISO code as the argument.
It reads a Magento localization CSV dictionary from stdin, translates it using the DeepL API, and writes it to stdout.
Be sure to check the automatic translations afterwards!

Usage Examples:

Collect all Magento and Hyvä strings:

bin/magento i18n:collect-phrases vendor/magento/ > magento-strings.csv
bin/magento i18n:collect-phrases vendor/hyva-themes/magento2-default-theme/ > hyva-strings.csv
bin/magento i18n:collect-phrases vendor/hyva-themes/magento2-theme-module/ >> hyva-strings.csv

Find all Hyvä specific translations that are not part of native Magento:
```
bin/magento i18n:diff-csv hyva-strings.csv magento-strings.csv
```
Find all translations that are missing in a Hyvä translation file:
```
bin/magento i18n:diff-csv hyva-strings.csv i18n/de_DE.csv
```
Find all translations that are in a translation file but are not used in Hyvä:
```
bin/magento i18n:diff-csv i18n/de_DE.csv hyva-strings.csv
```

Add new translations to an existing dictionary file.

bin/magento i18n:diff-csv hyva-strings.csv i18n/de_DE.csv | bin/magento i18n:translate-csv DE >> i18n/de_DE.csv

Installation

Install via composer

composer require hyva-themes/magento2-i18n-csv-diff

Enable module
```
bin/magento setup:upgrade
```

Configuration

To use the Deepi18n:translate-csv command, configure your API key in the system configuration at Hyva Themes > Localization CLI > Translation > DeepL API Key.

License

This package is licensed under the Open Software License (OSL 3.0).

License Text (OSL 3.0): The full text of the OSL 3.0 license can be found in the LICENSE.txt file within this package, and is also available online at http://opensource.org/licenses/osl-3.0.php.