{"id":19794795,"url":"https://github.com/bb-io/deepl","last_synced_at":"2025-09-19T05:52:13.116Z","repository":{"id":154672056,"uuid":"631013516","full_name":"bb-io/DeepL","owner":"bb-io","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-16T11:34:17.000Z","size":352,"stargazers_count":2,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-17T14:35:43.086Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","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/bb-io.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,"zenodo":null}},"created_at":"2023-04-21T17:41:20.000Z","updated_at":"2025-07-16T11:34:21.000Z","dependencies_parsed_at":"2023-11-27T23:29:26.468Z","dependency_job_id":"5d0abd45-b16d-4dc7-bbe8-fb80a877aa4b","html_url":"https://github.com/bb-io/DeepL","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bb-io/DeepL","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bb-io%2FDeepL","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bb-io%2FDeepL/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bb-io%2FDeepL/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bb-io%2FDeepL/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bb-io","download_url":"https://codeload.github.com/bb-io/DeepL/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bb-io%2FDeepL/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267527835,"owners_count":24102019,"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","status":"online","status_checked_at":"2025-07-28T02:00:09.689Z","response_time":68,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-11-12T07:14:29.687Z","updated_at":"2025-09-19T05:52:13.085Z","avatar_url":"https://github.com/bb-io.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Blackbird.io DeepL\n\nBlackbird is the new automation backbone for the language technology industry.\nBlackbird provides enterprise-scale automation and orchestration with a simple\nno-code/low-code platform. Blackbird enables ambitious organizations to\nidentify, vet and automate as many processes as possible. Not just localization\nworkflows, but any business and IT process. This repository represents an\napplication that is deployable on Blackbird and usable inside the workflow\neditor.\n\n## Introduction\n\n\u003c!-- begin docs --\u003e\n\nDeepL is an artificial intelligence (AI) company that specializes in language\ntranslation services. It offers a neural machine translation (NMT) engine\ncapable of providing high-quality translations across multiple languages.\nDeepL's translation engine is known for its accuracy, natural-sounding\ntranslations, and ability to understand context.\n\n## Before setting up\n\nBefore you can connect you need to make sure that:\n\n- You have a DeepL account.\n- You have an API key for your DeepL account. It can be found under _account\n  settings_ in DeepL.\n- **Important**: If you are using an API key for CAT tools, it will not work for\n  the public API. Instead, you need to use the Authentication key for DeepL API.\n  You can find [guidance](https://youtu.be/WTt3UuiDAf4?t=79) on where it is\n  located in this guide. For more details, you can also refer to this\n  [discussion](https://github.com/DeepLcom/deepl-python/issues/106), where a\n  similar issue was resolved.\n\n## Connecting\n\n1. Navigate to Apps, and identify the DeepL app. You can use search to find it.\n2. Click _Add Connection_.\n3. Name your connection for future reference e.g. 'My DeepL connection'.\n4. Fill in the API key to your DeepL account.\n5. Click _Connect_.\n\n![DeepLBlackbirdConnection](image/README/DeepLBlackbirdConnection.png)\n\n## Actions\n\n### Translation\n\n- **Translate** Translate interopability compatible files in Blackbird\n  interoperability mode. Can also be used to translate other file types that\n  DeepL supports. If you're only translating text (strings) then use _Translate\n  text_ instead. Advanced settings:\n  - **File translation strategy**: Select whether to use DeepL's own file\n    processing capabilities or use Blackbird interoperability mode with DeepL's\n    more advanced models (the latter the default mode).\n  - **Output file handling**: If using Blackbird's interoperability mode, this\n    determines the format of the output file. The default Blackbird behavior is\n    to convert to XLIFF for future steps. You can change it to output the\n    original file format (if you don't want to continue language operationts\n    after this step).\n  - **Glossary ID**: Select the DeepL glossary you want to use for this\n    translation.\n  - **Context**: Add additional context to the translation, this can be anything\n    of relevance.\n  - **Preserve formatting**: Whether to preserve the text formatting during\n    translation.\n  - **Formality**: Indicates whether the translation should be formal (depends\n    on the language).\n  - **Model type**: Specifies which DeepL model should be used for translation.\n    You can choose between speed and quality here.\n- **Translate text** Translate a single text string. Useful when translating\n  small messages. For larger content and files use _Translate_ instead.\n\nTo be deprecated soon:\n\n- **Translate XLIFF** Translate an XLIFF file using the text translation\n  endpoint. Useful when using the next-generation model for small XLIFF files\n  (supports only 1.2 version). Supported file extensions: `.xliff`, `.xlf`,\n  `.mqxliff`, `.mxliff`, `.txlf`. This action will soon be deprecated once\n  Blackbird interoperability mode also supports all these dialects.\n\n### Write\n\n- **Improve text** improve a text using DeepL Write, set writing style or tone.\n  Currently only supports some of the languages. Can also be used to change\n  locale from f.e. American English to British English. For more details see\n  [DeepL's write documentation](https://developers.deepl.com/docs/api-reference/improve-text).\n\n### Glossaries\n\n- **Export glossary** Export glossary\n- **Import glossary** Import glossary (.tbx, .csv \u0026 .tsv)\n- **Get glossary details** Get details of a specific glossary\n- **Get glossary entries** Get glossary entries in a TSV format\n- **Search glossaries** List all glossaries\n- **Delete glossary** Delete a glossary\n- **Import glossary (multilingual)** Import a glossary with multiple language\n  pairs.\n- **Update dictionary (multilingual)** Updates multilingual dictionary\n- **Export glossary (multilingual)** Export multilingual glossary\n\n## Example\n\n![DeepLExample](image/README/DeepLExample.png)\n\nThe example above shows a bird that is triggered as soon as an article is\npublished in Zendesk, said article is then exported as an HTML document and\ntranslated through DeepL before being imported back into Zendesk. The DeepL\ntranslation also considers as guardrail a Glossary that has been exported from\nMicrosoft Excel.\n\n## Feedback\n\nDo you want to use this app or do you have feedback on our implementation? Reach\nout to us using the [established channels](https://www.blackbird.io/) or create\nan issue.\n\n\u003c!-- end docs --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbb-io%2Fdeepl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbb-io%2Fdeepl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbb-io%2Fdeepl/lists"}