GitHub Integration with PTC

+

Automate GitHub localization by integrating with PTC. Get automatic pull requests containing human-quality translations.

Try PTC for Free

How the GitHub Integration with PTC Works

Private Translation Cloud (PTC) is a powerful AI translation engine for software, apps, and SaaS tools. It offers continuous localization by:

  • Connecting to your GitLab repository and translating your resource files.
  • Monitoring connected files and retranslating automatically when detecting changes.
  • Sending you a merge request with updated translations.

Start a free trial or check the Getting Started Guide.

1 – Using an Access Token to Connect Your GitHub to PTC

PTC’s setup process is easy: select Git Integration when creating a new project and then GitHub. 

No Caption


Connect your repository using GitHub’s OAuth App. This is the easiest and most secure way to give PTC access. If you want to use a fine-grained access token, make sure it includes the correct scopes and repository access.

Personal Fine-Grained Token

Where to create it

Personal access tokens in Developer Settings

Resource owner

Your GitHub user account

Required permissions

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

Repository access

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

Organization Fine-Grained Token

Where to create it

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.

Resource owner

The GitHub organization

Required permissions

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

Repository access

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

Where to create it

Resource owner

Required permissions

Repository access

Personal Fine-Grained Token

Personal access tokens in Developer Settings

Your GitHub user account

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

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

Organization Fine-Grained Token

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.

The GitHub organization

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

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 to PTC. PTC ensures the access token has the correct permissions and lets you choose which branches you want it to monitor.

2 – Translating GitHub with PTC

Once your GitHub is connected to PTC, continue through setup to add languages and project details. Note that PTC allows you to use existing translation files from your repo, but it’s best to translate your entire project with PTC for consistency and precision.

3 – Managing Pull Requests

PTC typically takes only a few minutes to translate your GitHub files. See the pull request in PTC or in your repository and approve it. PTC translations can be used immediately with confidence.

After you commit the first translations, PTC continues to monitor your resource files. Work on your code as normal and PTC will send you new pull requests when something changes. 

Generate New Merge Requests

Go to the Translations tab in PTC to see translations in every language you selected in a neatly organized table. From this page, you can make edits or ask PTC to retranslate, such as in cases where translations are longer than the length limit. 

Then, you can click on Generate MR to send a new pull request with the new translation.

No Caption

4 — Manage Your GitHub Localization Settings

With the PTC integration, your connected GitHub projects remain translated over time. If you want to change which branches or resource files PTC monitors, go to the Settings tab from your Translation Dashboard. 

There, navigate to the different tabs, including Repository Access, Monitored Files, and Branch Management. You can also personalize the title and commit messages under Merge Requests.

Why Localize Your GitHub with PTC

Easy Connection to Your Repository

PTC integrates directly with your GitHub repository, eliminating manual file uploads and downloads, or the need to run translation scripts.

Real-Time Synchronization

PTC monitors your GitHub repository for changes in resource files, automatically generates translations, and sends them back via pull requests.

Faster Localization for Global Markets

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

Frequently Asked Questions About the GitHub Integration

Start typing and press enter to search

Scroll to Top