{"id":19794834,"url":"https://github.com/bb-io/matecat","last_synced_at":"2025-08-16T09:09:15.293Z","repository":{"id":181791338,"uuid":"666475357","full_name":"bb-io/Matecat","owner":"bb-io","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-01T09:13:22.000Z","size":256,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-08T23:44:59.615Z","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-07-14T16:00:50.000Z","updated_at":"2025-07-01T09:13:26.000Z","dependencies_parsed_at":"2023-07-17T10:01:20.985Z","dependency_job_id":"42f33b89-6cab-477b-b1e4-9f596728407b","html_url":"https://github.com/bb-io/Matecat","commit_stats":null,"previous_names":["bb-io/matecat"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bb-io/Matecat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bb-io%2FMatecat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bb-io%2FMatecat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bb-io%2FMatecat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bb-io%2FMatecat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bb-io","download_url":"https://codeload.github.com/bb-io/Matecat/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bb-io%2FMatecat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270690307,"owners_count":24628859,"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-08-16T02:00:11.002Z","response_time":91,"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:37.950Z","updated_at":"2025-08-16T09:09:15.242Z","avatar_url":"https://github.com/bb-io.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Blackbird.io Matecat\n\nBlackbird is the new automation backbone for the language technology industry. Blackbird provides enterprise-scale automation and orchestration with a simple no-code/low-code platform. Blackbird enables ambitious organizations to identify, vet and automate as many processes as possible. Not just localization workflows, but any business and IT process. This repository represents an application that is deployable on Blackbird and usable inside the workflow editor.\n\n## Introduction\n\n\u003c!-- begin docs --\u003e\n\nMatecat is a free online CAT tool by Translated.\n\n## Before setting up\n\nBefore you can connect you need to make sure that:\n\n- You have a Matecat API key. See [this article](https://guides.matecat.com/obtaining-api-credentials) on how to obtain API credentials.\n\n## Connecting\n\n1. Navigate to apps and search for Matecat. If you cannot find Matecat then click _Add App_ in the top right corner, select Matecat and add the app to your Blackbird environment.\n2. Click _Add Connection_.\n3. Name your connection for future reference e.g. 'My Matecat'.\n4. Enter your Matecat [API key](https://guides.matecat.com/obtaining-api-credentials).\n5. Click _Authorize connection_.\n\n![connecting](image/README/1693310380983.png)\n\n## Actions\n\nSee the [Matecat API documentation](https://www.matecat.com/api/docs#/) for a detailed explanation on each action.\n\n### Projects\n\n- **Create project** creates a new project. You have to include all files, source language and target languages at once. It cannot be updated later. It returns the same information as _Get project_.\n\u003e Please note, the files you send to the 'Create project' action should have English names, without any other language characters or special symbols. Otherwise, Matecat may throw an unclear error\n- **Get project** returns information about the project. This also includes word counts.\n- **Cancel project** cancels the project.\n- **Archive project** archives the project.\n- **Activate project** activates the project.\n\n### Jobs\n\n- **Download job translated files** returns all translated files of this job.\n- **Download job file as TMX** returns the TMX file representing the current translation memory.\n- **Download job file as XLIFF** returns the XLIFF file representing the current translation memory.\n- **Get job segments comments** returns a list of all comments that have been made in this job.\n- **Get job** returns general job information.\n- **Cancel job** cancels the job.\n- **Archive job** archives the job.\n- **Activate job** activates the job.\n- **Assign job** assigns the job to a translator.\n\n\u003e Matecat does not have a job status that indicates whether it is in translated, translated, revised, etc. Instead, that needs to be deduced from the different job word counts. For convenience we have added a \"Derived status\" to the job model which can take have the following statusses: NEW, IN_TRANSLATION, TRANSLATED, IN_REVISION, REVISED. We have also added this property to the project model which will return the lowest of all the accumulated statusses of all its jobs.\n\n### Translation issues\n\n- **Get translation issue**.\n- **Create translation issue**.\n- **Delete translation issue**.\n- **Get translation issue comments**.\n\n### Glossaries\n\n- **Import glossary**. Matecat doesn't support language codes without a country portion. If the glossary contains such languages, the most appropriate Matecat-supported language code is selected (e.g., _es-ES_ for the _es_ language code). Glossaries can only be imported as private TMs in Matecat. More details on glossary import specifics in Matecat can be found [here](https://guides.matecat.com/how-to-add-a-glossary).\n\n## Events\n\n- **On analysis completed** is triggered when a project analysis completes or when it fails. Use in combination with checkpoints.\n- **On project status changed** is triggered when a project changes its derived status. F.e. if all jobs in a project change their status to translated.\n- **On job status changed** is triggered when a job changes its derived status. F.e. when all the segments in a job are translated the status changes to translated.\n\n## Example\n\n![1729768345607](image/README/1729768345607.png)\n\nIn this example we see a translation being created from a Slack message and its attachments. When the Matecat analysis is complete we send a message with the link to Slack. Then when all the translations are completed we loop through all jobs and download the files. We then send the translated files back to Slack.\n\n## Missing features\n\n- Translation Versions\n- Split jobs / chunks\n- Full quality reports\n- Project merging\n\nLet us know if you are interested in these features!\n\n## Feedback\n\nFeedback to our implementation of Matecat is always very welcome. Reach out to us using the [established channels](https://www.blackbird.io/), or create an issue.\n\n\u003c!-- end docs --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbb-io%2Fmatecat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbb-io%2Fmatecat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbb-io%2Fmatecat/lists"}