{"id":13422634,"url":"https://github.com/simplelocalize/simplelocalize-cli","last_synced_at":"2025-10-08T18:50:33.188Z","repository":{"id":42466636,"uuid":"178279149","full_name":"simplelocalize/simplelocalize-cli","owner":"simplelocalize","description":"SimpleLocalize CLI is a developer-friendly command-line tool for uploading and downloading translation files ","archived":false,"fork":false,"pushed_at":"2025-03-24T14:08:33.000Z","size":18671,"stargazers_count":63,"open_issues_count":0,"forks_count":11,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-09T15:06:59.702Z","etag":null,"topics":["cli","i18n","localization","simplelocalize"],"latest_commit_sha":null,"homepage":"https://simplelocalize.io","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simplelocalize.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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}},"created_at":"2019-03-28T20:41:51.000Z","updated_at":"2025-03-24T14:08:38.000Z","dependencies_parsed_at":"2023-11-07T14:27:06.656Z","dependency_job_id":"e47cb036-f434-47fd-adcb-28e80bbb099c","html_url":"https://github.com/simplelocalize/simplelocalize-cli","commit_stats":null,"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplelocalize%2Fsimplelocalize-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplelocalize%2Fsimplelocalize-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplelocalize%2Fsimplelocalize-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplelocalize%2Fsimplelocalize-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simplelocalize","download_url":"https://codeload.github.com/simplelocalize/simplelocalize-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248055284,"owners_count":21040157,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cli","i18n","localization","simplelocalize"],"created_at":"2024-07-30T23:00:49.099Z","updated_at":"2025-10-08T18:50:33.182Z","avatar_url":"https://github.com/simplelocalize.png","language":"Java","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://simplelocalize.io/\"\u003e\n    \u003cimg src=\"static/logo-square-white-rounded.png\" width=\"96\" height=\"96\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003ch3 align=\"center\"\u003eTranslation Management for software projects\u003c/h3\u003e\n\u003cp align=\"center\"\u003eThe easiest way to manage translation files for web and mobile apps.\u003c/p\u003e\n\n[![codecov](https://codecov.io/gh/simplelocalize/simplelocalize-cli/branch/master/graph/badge.svg)](https://codecov.io/gh/simplelocalize/simplelocalize-cli)\n\nSimpleLocalize CLI is a command-line tool that allows you to manage translations in your software project,\nand it's a great tool for CI/CD pipelines and localization automation.\n\n- [Synchronize files](https://simplelocalize.io/auto-translation/) - keep in sync all your translation files\n- [Auto-translate](https://simplelocalize.io/auto-translation/) - auto-translate texts in seconds\n- [Host translations](https://simplelocalize.io/translation-hosting/) - manage your hosted translations\n- [GitHub Actions support](https://github.com/simplelocalize/github-action-cli/) - seemles integration with GitHub Actions\n\n## Installation\n\nThe installation process is automated by command-line scripts. Both scripts for Windows (PowerShell) and macOS/Linux/Windows downloads a binary file with CLI, copies it to user files and makes it available to run anywhere in the system from a command-line. The CLI supports macOS (both Apple Silicon and Intel), Linux (x86 and ARM64), and Windows.\n\n```bash\n# macOS / Linux / Windows (WSL) \ncurl -s https://get.simplelocalize.io/2.10/install | bash\n\n# Windows (PowerShell)\n. { iwr -useb https://get.simplelocalize.io/2.10/install-windows } | iex;\n\n# npm - https://github.com/simplelocalize/simplelocalize-cli-npm\nnpm install @simplelocalize/cli\n```\n\n[GitHub Wiki: Installation](https://github.com/simplelocalize/simplelocalize-cli/wiki)\n\n## Usage\n\nThe command-line tool offers several commands to execute. All of them requires Project API Key that is unique for each project. \nYou can set `apiKey` via [configuration file](/simplelocalize-cli/wiki/Configuration-file), pass it as parameter with `--apiKey` or by environment variable `SIMPLELOCALIZE_API_KEY`.\n\n```bash\nsimplelocalize [command] ...parameters\n```\n\n[GitHub Wiki: Usage](https://github.com/simplelocalize/simplelocalize-cli/wiki)\n\n## Upload translations\n\nUpload command takes your local files and uploads them to SimpleLocalize.\n\n```bash\nsimplelocalize upload \n  --apiKey PROJECT_API_KEY\n  --uploadPath INPUT_FILE\n  --uploadFormat FILE_FORMAT\n```\n\n[GitHub Wiki: Upload translations](/simplelocalize/simplelocalize-cli/wiki/Upload-translations)\n\n## Download translations\n\nDownload command takes translations from SimpleLocalize and saves them to your local files.\n\n```bash\nsimplelocalize download \n  --apiKey PROJECT_API_KEY\n  --downloadPath DOWNLOAD_PATH\n  --downloadFormat FILE_FORMAT\n```\n\n[GitHub Wiki: Download translations](/simplelocalize/simplelocalize-cli/wiki/Download-translations)\n\n## Auto-translate strings\n\nAuto-translate command starts auto-translation tasks for project languages and waits for the finish. \n\n```bash\nsimplelocalize auto-translate --apiKey PROJECT_API_KEY\n```\n\n[GitHub Wiki: Auto-translate strings](/simplelocalize/simplelocalize-cli/wiki/Auto%E2%80%90translate-strings)\n\n## Translation Hosting\n\nThere are two commands that operates on [translation hosting](https://simplelocalize.io/translation-hosting/) resources which is `publish` and `pull`.\n\n### Publish translations\n\nPublish translations between translation editor and hosting or between hosting environments.\n\n```bash\nsimplelocalize publish\n  --apiKey PROJECT_API_KEY\n  --environment _latest\n```\n\n[GitHub Wiki: Pull resources](/simplelocalize/simplelocalize-cli/wiki/Translation-Hosting)\n\n### Pull resources\n\nPull command downloads files from translation hosting.\n\n```bash\nsimplelocalize pull\n  --apiKey PROJECT_API_KEY\n  --pullPath ./hosting/\n  --environment _latest\n```\n\n[GitHub Wiki: Pull resources](/simplelocalize/simplelocalize-cli/wiki/Translation-Hosting)\n\n## Additional commands\n\n### Initalize configuration file\n\nCommand creates a sample [configuration file](/simplelocalize/simplelocalize-cli/wiki/Configuration-file) in the current directory.\n\n```bash\nsimplelocalize init\n```\n\n[GitHub Wiki: Additional commands](/simplelocalize/simplelocalize-cli/wiki/Additional-commands)\n\n### Get project details\n\nCommand gets project details and prints them.\n\n```bash\nsimplelocalize status --apiKey PROJECT_API_KEY\n```\n\n[GitHub Wiki: Additional commands](/simplelocalize/simplelocalize-cli/wiki/Additional-commands)\n\n### Purge translations\n\nCommand removes all translations, translation keys and languages.\n\n```bash\nsimplelocalize purge --apiKey PROJECT_API_KEY\n```\n\n[GitHub Wiki: Additional commands](/simplelocalize/simplelocalize-cli/wiki/Additional-commands)\n\n### Extract translation keys\n\nExtract command finds translation keys and translations from the source code.\n\n```bash\nsimplelocalize extract --searchDir SEARCH_DIRECTORY --projectType PROJECT_TYPE \n```\n\n[GitHub Wiki: Additional commands](/simplelocalize/simplelocalize-cli/wiki/Additional-commands)\n\n## Configuration file\n\nCreate configuration file to to simplify the bash commands. Arguments used in command always override properties set in the configuration file.\n\n```bash\n# It load simplelocalize.yml file by default\nsimplelocalize upload\n```\n\n[GitHub Wiki: Configuration file](/simplelocalize/simplelocalize-cli/wiki/Configuration-file)\n\n## Proxy support\n\nSimpleLocalize CLI supports HTTP and HTTPS proxies, and it respects the `http_proxy`, `https_proxy` environment\nvariables.\n\nHere are some examples of how to set proxy environment variables in Linux and macOS:\n\n```bash\nexport http_proxy=http://someproxy.com\nexport http_proxy=http://someproxy.com:8080\nexport http_proxy=http://user:password@someproxy.com:8080\n```\n\n[GitHub Wiki: Proxy support](/simplelocalize/simplelocalize-cli/wiki/Proxy-Support)\n\n## Support\n\nPlease refer to the [official SimpleLocalize documentation](https://simplelocalize.io/docs/cli/get-started/). That should help you troubleshoot common issues. For additional help, you can reach out to us on one of these channels:\n\n- [GitHub](https://github.com/simplelocalize/simplelocalize-cli/issues) (Bug and issue reports)\n- [Email](mailto:contact@simplelocalize.io) (General support)\n- [Changelog](https://simplelocalize.io/changelog/) (Product updates)\n- [YouTube](https://www.youtube.com/channel/UCBpYo2UnHwDGyK175SAKTig) (How-to tutorials)\n\n## License\n\nSee [LICENSE](/LICENSE) for more details.\n","funding_links":[],"categories":["Dev Tools","Applications","Internationalization","Development","Utilities","Software","Tools"],"sub_categories":["Miscellaneous","Development","Web Development","Other Platforms","👨‍💻 Development (9)","Command Line Tools","Other tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimplelocalize%2Fsimplelocalize-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimplelocalize%2Fsimplelocalize-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimplelocalize%2Fsimplelocalize-cli/lists"}