{"id":49906498,"url":"https://github.com/crustack/android-translations-converter-plugin","last_synced_at":"2026-05-16T11:02:51.301Z","repository":{"id":272951174,"uuid":"917776117","full_name":"Crustack/android-translations-converter-plugin","owner":"Crustack","description":"Easily convert Android strings.xml files to Excel and back (with plurals support)","archived":false,"fork":false,"pushed_at":"2025-03-02T18:10:03.000Z","size":428,"stargazers_count":6,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-17T15:19:24.342Z","etag":null,"topics":["android","android-excel","android-translations","excel","gradle-plugin","kotlin","strings-xml","translations","xml"],"latest_commit_sha":null,"homepage":"https://github.com/PhilKes/android-translations-converter-plugin","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Crustack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-16T16:15:39.000Z","updated_at":"2025-11-05T13:21:57.000Z","dependencies_parsed_at":"2025-01-17T16:54:57.571Z","dependency_job_id":"b5a8c979-1601-40b1-abd6-30b0c0aef7da","html_url":"https://github.com/Crustack/android-translations-converter-plugin","commit_stats":null,"previous_names":["philkes/android-translations-converter-plugin","crustack/android-translations-converter-plugin"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/Crustack/android-translations-converter-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crustack%2Fandroid-translations-converter-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crustack%2Fandroid-translations-converter-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crustack%2Fandroid-translations-converter-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crustack%2Fandroid-translations-converter-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Crustack","download_url":"https://codeload.github.com/Crustack/android-translations-converter-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crustack%2Fandroid-translations-converter-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33100319,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-excel","android-translations","excel","gradle-plugin","kotlin","strings-xml","translations","xml"],"created_at":"2026-05-16T11:02:42.049Z","updated_at":"2026-05-16T11:02:51.290Z","avatar_url":"https://github.com/Crustack.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Android Translations Converter\n\u003ca href=\"https://plugins.gradle.org/plugin/io.github.philkes.android-translations-converter\"\u003e\u003cimg alt=\"Gradle Plugin Portal Version\" src=\"https://img.shields.io/gradle-plugin-portal/v/io.github.philkes.android-translations-converter\"\u003e\u003c/a\u003e\n\n\nPlug'n'Play gradle plugin for your Android projects to convert between Android `strings.xml` translations and Excel.\nUseful if your translations are created by non-technical/external translators who prefer to use Excel/LibreOffice.\n\n## Features\n\n* Export from Android project's `strings.xml` files to a single, formatted, reproducible Excel file (`.xlsx`)\n* Import `strings.xml` files from given Excel file into corresponding `values` subfolders\n* Supports [Android quantity strings (plurals)](https://developer.android.com/guide/topics/resources/string-resource#Plurals)\n* Correctly escapes/unescapes [special characters](https://developer.android.com/guide/topics/resources/string-resource#escaping_quotes) + HTML tags in `strings.xml` and Excel\n* User-Friendly Excel sheet formatting including highlight missing translations, useful auto-filters and comments\n* Auto-Sorts the translations by their key\n\n## Setup\n\nIn `build.gradle`:\n```groovy\nplugins {\n    id(\"io.github.philkes.android-translations-converter\") version \"1.0.5\"\n}\n```\n\n## Export\n\nRun `./gradlew exportTranslationsToExcel`\n\nOptional configuration in `build.gradle` (shown values are the defaults):\n```groovy\ntasks.named(\"exportTranslationsToExcel\", ExportToExcelTask) {\n    /**\n     * Input path which contains 'strings.xml' (or in subfolders)\n     */\n    inputDirectory = project.file(\"app/src/main/res\")\n    \n    /**\n     * Exported Excel file path (.xlsx)\n     */\n    outputFile = project.file(\"translations.xlsx\")\n\n   /**\n    * Whether the exported Excel sheet should be formatted to make it more user-friendly.\n    */\n    formatExcel = true\n}\n```\n\n### Example Excel\n\nTo preview a full exported Excel file [download it here](https://github.com/PhilKes/android-translations-converter/raw/refs/heads/main/src/test/resources/expected.xlsx)\n\n\u003cimg src=\"./doc/example_excel.png\" alt=\"example-excel\" /\u003e \n\n\n#### Plurals\n\nAndroid supports [quantity strings (plurals)](https://developer.android.com/guide/topics/resources/string-resource#Plurals).\nTo support these plurals, for every `\u003cplurals\u003e` in the `strings.xml` there are multiple for all the supported quantities.\nThe keys for these plurals have appended `_PLURALS_{QUANTITY}` to differentiate them. There is always a row for every possible quantity, doesn't matter if there is an existing translation in a language or not. If the default language does not specify a translations for a certain quantity, this row is highlighted in yellow with a corresponding comment.\n\n\n## Import\n\nRun `./gradlew importTranslationsFromExcel`\n\nOptional configuration in `build.gradle` (shown values are the defaults):\n```groovy\ntasks.named(\"importTranslationsFromExcel\", ImportFromExcelTask) {\n   /**\n    * Input Excel File containing translations.\n    */\n    inputFile = project.file(\"translations.xlsx\")\n\n   /**\n    * Folder to import into.\n    * For every folder-name/language a subfolder will be created and its corresponding `strings.xml` generated.\n    */\n    outputFile = project.file(\"src/main/res/\")\n}\n```\n\nTo preview the output see [app/src/main/res](./src/test/resources/app/src/main/res) folder\n\n ---\n\n### Automate Export via pre-commit Hook\n\nThe `exportTranslationsToExcel` can easily be automated, in order to always have the exported `translation.xlsx` up-to-date with the Android translations.\nThis can be done either via a pre-commit hook or by simply executing it on every build.\n\n_Note that `exportTranslationsToExcel` execution is skipped if none of the `strings.xml` files contents have changed since the last execution._\n\n#### Execute on build automatically\n\nIn `build.gradle`:\n```groovy\npreBuild.dependsOn exportTranslationsToExcel\n```\n\n#### Add as pre-commit hook\n\n1. Copy [pre-commit folder](./pre-commit) to the root of your project\n2. In `build.gradle`:\n    ```groovy\n    tasks.register('installLocalGitHooks', Copy) {\n        def scriptsDir = new File(rootProject.rootDir, 'scripts/')\n        def hooksDir = new File(rootProject.rootDir, '.git/hooks')\n        from(scriptsDir) {\n            include 'pre-commit', 'pre-commit.bat'\n        }\n        into { hooksDir }\n        inputs.files(file(\"${scriptsDir}/pre-commit\"), file(\"${scriptsDir}/pre-commit.bat\"))\n        outputs.dir(hooksDir)\n        fileMode 0775\n    }\n    preBuild.dependsOn installLocalGitHooks\n    ```\n3. Whenever you commit your changes the exported Excel will be kept up-to-date\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrustack%2Fandroid-translations-converter-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrustack%2Fandroid-translations-converter-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrustack%2Fandroid-translations-converter-plugin/lists"}