{"id":20752537,"url":"https://github.com/ghost-chu/crowdinota","last_synced_at":"2025-04-28T14:20:51.410Z","repository":{"id":96833050,"uuid":"576917336","full_name":"Ghost-chu/CrowdinOTA","owner":"Ghost-chu","description":"A vanilla Java library that adapt the Crowdin Over-The-Air Content Delivery with cache and custom language mapping support.","archived":false,"fork":false,"pushed_at":"2023-01-13T14:09:22.000Z","size":47,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-30T10:25:06.812Z","etag":null,"topics":["crowdin","crowdin-api","java","library","translation"],"latest_commit_sha":null,"homepage":"","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/Ghost-chu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"2022-12-11T12:14:57.000Z","updated_at":"2024-05-29T09:07:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"86371628-acee-4129-b673-60186bb4983b","html_url":"https://github.com/Ghost-chu/CrowdinOTA","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ghost-chu%2FCrowdinOTA","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ghost-chu%2FCrowdinOTA/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ghost-chu%2FCrowdinOTA/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ghost-chu%2FCrowdinOTA/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ghost-chu","download_url":"https://codeload.github.com/Ghost-chu/CrowdinOTA/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251326856,"owners_count":21571637,"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":["crowdin","crowdin-api","java","library","translation"],"created_at":"2024-11-17T08:41:57.804Z","updated_at":"2025-04-28T14:20:51.403Z","avatar_url":"https://github.com/Ghost-chu.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CrowdinOTA\n\nA vanilla Java library that adapt the Crowdin Over-The-Air Content Delivery with cache and custom language mapping\nsupport.\n\n## Features\n\n* Translation cache management.\n* Multiple files support.\n* Parallel files downloading.\n\n## Usage\n\n```java\npublic class Test {\n    public static void main(String[] args) throws OTAException {\n        File myCacheFolder = new File(\"my-cache\");\n        String distributionUrl = \"https://distributions.crowdin.net/847569d13d22ee803f1cfa7xrm4\";\n        String crowdinFilePath = \"/hikari/quickshop-bukkit/src/main/resources/lang/example.yml\";\n        CrowdinOTA crowdinOTA = new CrowdinOTA(distributionUrl, myCacheFolder);\n        // I/O blocking operation, when you create a OTAFileInstance, it will download all translations\n        OTAFileInstance fileInstance = crowdinOTA.getOtaInstance().getFileInstance(crowdinFilePath);\n        // Now get your translations!\n        System.out.println(fileInstance.getLocaleContentByCrowdinCode(\"zh-CN\"));\n        System.out.println(fileInstance.getLocaleContentByCustomCode(\"locale\", \"uk-UA\"));\n        // Or get all available translations!\n        fileInstance.getAvailableLocales();\n    }\n}\n```\n\n## Caching\n\nCrowdinOTA will cache all translations in your cache folder, and it will check the cache timestamp, if the cache file is\nexpired, it will download the new translation file from Crowdin.\n\nCrowdinOTA also will store the cache file's SHA-1 for validating.\n\n## Maven\n\nWe're on Maven Central.\n\n```xml\n\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.ghostchu.crowdin\u003c/groupId\u003e\n    \u003cartifactId\u003ecrowdinota\u003c/artifactId\u003e\n    \u003cversion\u003e1.0.3\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Example Project\n\n[QuickShop-Hikari](https://github.com/Ghost-chu/QuickShop-Hikari/blob/5690651eecfd877e442a7a8f958a6ef896e8edb1/quickshop-bukkit/src/main/java/com/ghostchu/quickshop/localization/text/SimpleTextManager.java#L109) using CrowdinOTA to process the Crowdin distribution.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghost-chu%2Fcrowdinota","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fghost-chu%2Fcrowdinota","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghost-chu%2Fcrowdinota/lists"}