Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。
Help translate Piik
Piik includes Simplified Chinese and English. Suggest wording, correct a translation or add a language through GitHub issues and pull requests.
For a wording suggestion, open an issue with the language, page/control, current text, proposed text and reason. Include a screenshot or steps to reach it; remove private invitations, passwords and personal content. You can send a suggestion without setting up development tools.
Make your first correction
Try the affected screen and read the nearby controls. Check both existing languages when helpful; the terminology and voice guide owns names and writing style.
Fork Piik and work on a branch from current
main, following Contributing. Small text edits can also be proposed through GitHub's file editor.Find the text in the files below. In a locale file, change the string value after the colon. Keep the key and its placeholders. Search the key in the source to see where it appears; for example:
rg -n -F 'host.title' src/clientPreview the affected screen and run the relevant checks. For a typo in one language, edit that language. If the underlying meaning changes, update the corresponding messages in every registered language.
Open a PR to
mainwith the wording problem, languages/surfaces changed and preview results. For PR format, follow Contributing.
Find the right text
| Surface | Editable source |
|---|---|
| App launcher and shared Browser/App UI, including tooltips and accessible labels | English, Chinese |
| Welcome lines, waiting captions and changing browser-tab titles | The enPlayful / zhPlayful pools and title-frame catalogs in those same files; website welcome lines reuse these pools |
| Website | Page markup and interactive labels; text is paired by en and zh-CN |
| Introduction film | Film sources; captions, artwork and playback labels have their own bilingual text |
| App console window | consoleCopy in console.go; entries are ordered English, Chinese, visual; retain the third slot even when empty |
| README and entry guides | README pair, documentation home, getting started, troubleshooting and self-hosting, each with a .zh-CN.md counterpart |
Edit the source, then rebuild the surface that serves it:
- App/Server UI: catalogs are bundled with the web assets. Publish the updated App or Server; a remote site's UI comes from that Server.
- Website/film: use the website workflow.
- Guides: the documentation website renders repository Markdown at its next
publication. Navigation and search labels live in
site/docs/.
Update related guides when a control's name changes. Technical references keep one shared version under documentation ownership.
Preserve meaning and syntax
Write naturally for the target audience. Use the shared glossary for role and password names. Introductions may be light; actions, errors and deployment steps must be clear. Preserve the conditions on performance, platform and connection claims. A cultural reference should still make sense to someone unfamiliar with it. Machine-assisted drafts need proofreading by someone who understands the language and the screen; raise unclear source text in the PR instead of guessing.
For App startup failures, translate the launcher and console explanations together. Keep their shared reason codes and raw technical details unchanged.
Locale files are TypeScript objects. These are existing examples:
// en.ts
"host.title": "{name}'s screen",
// zh.ts
"host.title": "{name} 的屏幕",
Keep the lookup key host.title. Move {name} to fit the sentence, preserving
its spelling, braces and occurrence count. The formatter replaces each variable
once and accepts plain strings. For plural forms, HTML or different sentence
composition, describe the needed change in the PR so the caller and formatter
can be updated together.
Keep quotes, escapes and commas valid. Preserve commands, config keys, URLs,
download filenames and format markers such as %s in Go console text. Translate
link labels and image descriptions; repair internal anchors when translating
Markdown headings. Keep legal license text and third-party notices intact.
Add a language
Search existing issues and PRs for the language first. For a larger translation, start an issue with its language tag, intended coverage and any terminology or layout questions, so contributors can coordinate work and review.
Copy
src/client/locales/en.tsto a file such asfr.ts. Translate the messages and title labels, write natural playful entries, and rename the three exports. RetainRecord<CopyKey, string>,TitleFrameCatalogandPlayfulCatalogfromzh.ts. Chinese currently defines the key set; either existing language can provide context. Complete all keys rather than spreading an English catalog over missing translations.Import the exports in locales/index.ts and add one registry entry. For example, after translating the catalogs:
fr: { name: "Français", short: "FR", tag: "fr", copy: fr, titleFrames: frTitleFrames, playful: frPlayful },Use an ASCII filename/key, the language's native name in
name, a recognizable one-to-three-character button label inshort, and a matching language tag intag. Distinguish coexisting regional/script variants. Extra languages appear in a shared dropdown after visual mode. Check language selection, saved preferences and App handoff against the system-language policy.Check complete screens and the launch flow. New UI languages use English in the App console until its own translation is added. Console additions also require updating the launcher and loopback accepted-language checks together; use the App module map.
State coverage in the PR. Website, film and documentation translations can be contributed separately; update their language controls when adding a language. For right-to-left scripts, implement and check text direction and layout.
Translate visual-mode labels and explanations in the normal catalog; keep that presentation option available.
Playful copy
Each language owns its welcome and waiting arrays, and each playful title has a
fixed label plus a variations array. Add or remove entries in that language
without matching another language's count, order or references. An empty array
omits the decoration; one entry stays static. Operational keys and title labels
still require complete translations. Errors, pauses, endings, required actions
and slogans stay fixed.
Welcome entries carry text and two symbols, chosen from the existing
icon vocabulary to express that sentence in the
visual cipher. For example:
{ text: "Your seat is right here.", symbols: ["couch", "heart"] },
Waiting entries are plain strings such as "Pull up a comfy chair.". Keep them
brief and natural in context. Avoid temporary trends, literal borrowed dialogue
and statements that invent progress, success or remaining time.
Timing follows the playful-copy lifecycle.
Preview welcome text and its cipher at
/__tooltip-preview; use /__status-preview for waiting captions and titles.
Check both narrow windows and language changes. The website's build picks up
welcome edits automatically; its other copy remains separate.
Preview and check
Use the Node/npm versions and local setup in Run from source. For UI catalog edits, run from the repository root:
npm ci
npm run typecheck
npm test -- tests/copy.test.ts
These checks cover missing keys, empty text, placeholders, language selection and handoff. Proofread the translation in the running UI too.
Run the local UI and server as described in the source guide. Choose the language from the top-right controls, open the affected screen and inspect long names or counts in context. Check narrow windows, keyboard focus, tooltips and accessible labels. With extra languages registered, verify that the dropdown stays usable near viewport edges and exposes its expanded/collapsed state to assistive technology. For new languages, also check a reload, App launch, switching back to English, and the optional visual mode. Keep meaningful phrases together instead of adding spaces or hard line breaks to force one desktop layout.
Website and film changes use the website preview.
For Markdown changes, run node scripts/check-docs.mjs after staging new files,
then review GitHub's rendered Markdown and translated links. Additional checks
for code changes follow Contributing.
Further reading
- OBS translation guide: proofread in the running application and understand technical terms.
- Godot translation guide: locate source context and coordinate terminology.
- Weblate translation guidance: handle placeholders and markup carefully.
- W3C language-tag guidance: use BCP 47 tags to identify languages and their variants.
- Unicode CLDR language names: menu-name reference. Browser
Intl.DisplayNamescan help find native names; choose Piik's short button label in the registry.