Repository Integration

GitHub Integration with PTC

+

PTC integrates with GitHub to automate software localization, keeping translations in sync with your resource files.

Try PTC for Free

Easy Connection to Your Repository

PTC integrates directly with your GitHub repository, eliminating manual file uploads or downloads. Setup is quick and straightforward, making it easy to start localizing your software.

Real-Time Synchronization

PTC monitors your GitHub repository for changes in resource files, automatically generates translations, and sends them back via pull requests. Translations stay up-to-date with your resource files, reducing errors like outdated or missing strings.

Faster Localization for Global Markets

PTC speeds up the localization process by automating translations and delivering them via pull requests. Quickly adapt your software for global markets and shorten your time-to-market.

How to Set Up the PTC and GitHub Integration 

To get started, log in or create a PTC account. Then, create a new project in PTC:

Connect your repository using GitHub’s OAuth App. This is the easiest and most secure way to give PTC access.

If you need to use a fine-grained access token instead, make sure it includes the correct scopes and repository access:

Personal Fine-Grained Token

Organization Fine-Grained Token

What Needs Translating?

Where to create it

Personal access tokens in Developer Settings

Personal access tokens in Developer Settings

Important: Creating a fine-grained access token may be restricted by your organization’s access policies. If you can’t create the token, ask an organization admin to review the Personal Access Token Policy settings in GitHub.

What Needs Translating?

Resource owner

What To Do

Your GitHub user account

The GitHub organization

What Needs Translating?

Repository access

What To Do

Choose “Only select repositories” (recommended) or “All repositories”

Choose “Only select repositories” (recommended) or “All repositories”

What Needs Translating?

Required permissions

What To Do

Commit statuses → Read-only
Contents → Read and write
Pull requests → Read and write
Webhooks → Read and write

Commit statuses → Read-only
Contents → Read and write
Pull requests → Read and write
Webhooks → Read and write

After generating the token, store it securely and add it during the PTC project setup.

Select the repository and branch you want PTC to monitor. PTC will automatically detect and track changes to resource files in that branch.

PTC generates Better Than Human Translations and sends them back via pull requests for review.

Approve and Merge

Approve the pull request in GitHub. PTC continues to monitor your repository, creating new pull requests with updated translations whenever you make changes to your resource files.

Frequently Asked Questions About the GitHub Integration

Why does PTC need read and write access to my repository?

PTC uses read access to detect changes in your resource files and write access to deliver translations via pull requests. PTC only interacts with the files it manages for translation and does not make changes to any other parts of your repository.

Which Git hosting platforms are supported by PTC?

In addition to GitHub, PTC integrates with GitLab and Bitbucket, offering the same automated localization workflows and features for each platform.

What file formats does PTC support?

PTC works with a wide range of resource file formats, including .po, .mo, .json, .xml, .properties, .csv, .xlif, and more.

Repository Integration

Start typing and press enter to search

Scroll to Top