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:

Step 1

Grant Access to Your Repository

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

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 during the PTC project setup.

Step 2

Select Branches to Monitor

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

Step 3

Translate and Receive Pull Requests

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

Step 4

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

Repository Integration

Start typing and press enter to search

Scroll to Top