The Home for Magento 2 Excellence

Quality-tested Magento 2 modules. Explore. Evaluate. Elevate. #magento2

748 Modules
503 Ready
241 Need Help
🏆 Leaderboard
Potentially Abandoned v1.0.2

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.

1,746
Downloads
Below average
13
GitHub Stars
Below average
3y ago
Last Release
2
Open Issues
Build Passing
Ready to install

Build Tests

Composer Install
DI Compile
Templates

Code Quality

CS Coding Standard
12 warnings
L5 PHPStan

Tested on Magento 2.4.8-p4

Recent Test History

Each release is tested against the latest Magento version at that time.

v1.0.2 on Magento 2.4.8-p4
Mar 21, 2026

Share This Module's Status

Hyva i18n CSV Diff Magento compatibility status badge

README

Loaded from GitHub

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

  1. Install via composer
    composer require hyva-themes/magento2-i18n-csv-diff
    
  2. 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).

  • Copyright: Copyright © 2020-present Hyvä Themes. All rights reserved.
  • 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.

This content is fetched directly from the module's GitHub repository. We are not the authors of this content and take no responsibility for its accuracy, completeness, or any consequences arising from its use.