Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -180,7 +180,7 @@ The one rule to know before you merge anything: **there is one release branch pe

- **Native capture is platform-fragile**: macOS uses ScreenCaptureKit (Swift), Windows uses WGC (C++/Win32). CI unit-tests the Swift capture core, builds both macOS helpers and checks the compositor on macOS, Windows and Linux. These checks do not exercise real capture, permissions or devices; manual smoke tests on the affected platforms are still required for native changes. See [CI coverage](technical-documentation/engineering/ci-workflows.md#tier-1-application-and-documentation-ci).
- **Rendering is native**: the Rust compositor in `crates/compositor/` renders the editor preview and every export, MP4 and GIF. It runs on Direct3D 11 on Windows, Metal on macOS and wgpu on Linux, with a CPU fallback on Windows and Linux. The renderer only paints the preview frames it pulls onto a `<canvas>`. Details: `technical-documentation/README.md`, then `architecture/native-compositor.md`.
- **i18n**: 16 locales in `src/i18n/locales/<locale>/` (e.g. `src/i18n/locales/en/settings.json`). The `i18n:check` script validates them — run it after touching translation files.
- **i18n**: 18 locales in `src/i18n/locales/<locale>/` (e.g. `src/i18n/locales/en/settings.json`). The `i18n:check` script validates them — run it after touching translation files.
- **Website i18n** is separate: 8 locales under `website/i18n/`. After changing an English doc, page or `<Translate>` string in `website/`, follow `website/i18n/TRANSLATING.md` ("Keeping translations up to date"); `npm run i18n:check` in `website/` lists what is behind.
- **Build pipeline**: `npm run build` is full electron-builder. For iterating on renderer only, use `npm run build-vite` (Vite + tsc, no packaging).
- **Product constraints**: the project is free forever and explicitly "not production-grade". Don't add paywalls, premium tiers, or logic that gates a feature on who the user is, and don't add upsell language to the README or UI copy. This is a hard constraint, not a judgement call. (A flag that hides an unfinished capture backend is fine — it gates on readiness, not on the user.)
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ A raw capture goes in and comes out ready to post — on X, Reddit, YouTube, a d
- Timeline snapping guides and an audio waveform to make trimming easier.
- Customizable keyboard shortcuts.
- Export to MP4 or GIF in multiple aspect ratios and resolutions, rendered and encoded on the GPU (Metal on macOS, D3D11 on Windows, Vulkan on Linux) with an automatic CPU fallback.
- Languages supported: Arabic, Czech, English, Spanish, French, German, Italian, Japanese, Korean, Dutch, Polish, Portuguese (Brazil), Russian, Turkish, Vietnamese, Simplified Chinese, and Traditional Chinese.
- Languages supported: Arabic, Czech, English, Spanish, French, German, Italian, Japanese, Korean, Dutch, Persian, Polish, Portuguese (Brazil), Russian, Turkish, Vietnamese, Simplified Chinese, and Traditional Chinese.

## Command-line interface (headless)

Expand Down
2 changes: 2 additions & 0 deletions electron-builder.json5
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,7 @@
"cs",
"de",
"es",
"fa",
"it",
"ja",
"ko",
Expand Down Expand Up @@ -477,6 +478,7 @@
"cs",
"de",
"es",
"fa",
"it",
"ja-JP",
"ko-KR",
Expand Down
18 changes: 18 additions & 0 deletions electron/i18n.test.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
import { afterEach, expect, it } from "vitest";
import commonFa from "../src/i18n/locales/fa/common.json";
import dialogsFa from "../src/i18n/locales/fa/dialogs.json";
import { getMainLocale, mainT, setMainLocale } from "./i18n";

afterEach(() => {
setMainLocale("en");
});

it("uses Persian messages for native menus and dialogs", () => {
setMainLocale("fa");

expect(getMainLocale()).toBe("fa");
expect(mainT("common", "actions.recordingStatus", { source: "Safari" })).toBe(
commonFa.actions.recordingStatus.replace("{{source}}", "Safari"),
);
expect(mainT("dialogs", "unsavedChanges.title")).toBe(dialogsFa.unsavedChanges.title);
});
5 changes: 5 additions & 0 deletions electron/i18n.ts
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ import commonEn from "../src/i18n/locales/en/common.json";
import dialogsEn from "../src/i18n/locales/en/dialogs.json";
import commonEs from "../src/i18n/locales/es/common.json";
import dialogsEs from "../src/i18n/locales/es/dialogs.json";
import commonFa from "../src/i18n/locales/fa/common.json";
import dialogsFa from "../src/i18n/locales/fa/dialogs.json";
import commonFr from "../src/i18n/locales/fr/common.json";
import dialogsFr from "../src/i18n/locales/fr/dialogs.json";
import commonIt from "../src/i18n/locales/it/common.json";
Expand Down Expand Up @@ -42,6 +44,7 @@ type Locale =
| "cs"
| "de"
| "es"
| "fa"
| "fr"
| "it"
| "ja-JP"
Expand All @@ -63,6 +66,7 @@ const messages: Record<Locale, Record<Namespace, MessageMap>> = {
cs: { common: commonCs, dialogs: dialogsCs },
de: { common: commonDe, dialogs: dialogsDe },
es: { common: commonEs, dialogs: dialogsEs },
fa: { common: commonFa, dialogs: dialogsFa },
fr: { common: commonFr, dialogs: dialogsFr },
it: { common: commonIt, dialogs: dialogsIt },
"ja-JP": { common: commonJa, dialogs: dialogsJa },
Expand All @@ -86,6 +90,7 @@ export function setMainLocale(locale: string) {
locale === "cs" ||
locale === "de" ||
locale === "es" ||
locale === "fa" ||
locale === "fr" ||
locale === "it" ||
locale === "ja-JP" ||
Expand Down
2 changes: 2 additions & 0 deletions src/i18n/__tests__/tutorialHelpTranslations.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ import csDialogs from "@/i18n/locales/cs/dialogs.json";
import deDialogs from "@/i18n/locales/de/dialogs.json";
import enDialogs from "@/i18n/locales/en/dialogs.json";
import esDialogs from "@/i18n/locales/es/dialogs.json";
import faDialogs from "@/i18n/locales/fa/dialogs.json";
import frDialogs from "@/i18n/locales/fr/dialogs.json";
import itDialogs from "@/i18n/locales/it/dialogs.json";
import jaJPDialogs from "@/i18n/locales/ja-JP/dialogs.json";
Expand Down Expand Up @@ -49,6 +50,7 @@ const dialogsByLocale = {
cs: csDialogs,
de: deDialogs,
es: esDialogs,
fa: faDialogs,
fr: frDialogs,
it: itDialogs,
"ja-JP": jaJPDialogs,
Expand Down
1 change: 1 addition & 0 deletions src/i18n/config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ export const SUPPORTED_LOCALES = [
"cs",
"de",
"es",
"fa",
"fr",
"it",
"ja-JP",
Expand Down
80 changes: 80 additions & 0 deletions src/i18n/locales/fa/common.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
{
"actions": {
"cancel": "لغو",
"save": "ذخیره",
"delete": "حذف",
"close": "بستن",
"resetToDefault": "بازنشانی به پیش‌فرض",
"share": "انتخاب",
"done": "انجام شد",
"open": "باز کردن",
"checkForUpdates": "بررسی به‌روزرسانی",
"update": "به‌روزرسانی",
"updateTo": "به‌روزرسانی به نسخهٔ {{version}}",
"usagePing": "ارسال آمار ناشناس استفاده",
"viewRelease": "مشاهدهٔ جزئیات نسخه",
"downloadUpdate": "دریافت به‌روزرسانی",
"restartNow": "اکنون راه‌اندازی مجدد شود",
"upload": "بارگذاری",
"export": "خروجی",
"showInFolder": "نمایش در پوشه",
"file": "فایل",
"edit": "ویرایش",
"view": "نما",
"window": "پنجره",
"help": "راهنما",
"quit": "خروج",
"stopRecording": "توقف ضبط",
"undo": "واگرد",
"redo": "انجام دوباره",
"cut": "برش",
"copy": "کپی",
"paste": "چسباندن",
"selectAll": "انتخاب همه",
"minimize": "کمینه کردن",
"reload": "بارگیری دوباره",
"forceReload": "بارگیری دوباره بدون حافظهٔ نهان",
"toggleDevTools": "نمایش یا پنهان کردن ابزارهای توسعه",
"actualSize": "اندازهٔ واقعی",
"zoomIn": "بزرگ‌نمایی",
"zoomOut": "کوچک‌نمایی",
"toggleFullScreen": "ورود به تمام‌صفحه یا خروج از آن",
"recordingStatus": "در حال ضبط {{source}}",
"about": "دربارهٔ OpenScreen",
"services": "خدمات",
"hide": "پنهان کردن OpenScreen",
"hideOthers": "پنهان کردن سایر برنامه‌ها",
"unhide": "نمایش همه",
"saveDiagnostics": "ذخیرهٔ اطلاعات عیب‌یابی",
"starOnGithub": "ستاره دادن در GitHub",
"permissions": "مجوزها…",
"closeNotification": "بستن اعلان"
},
"updates": {
"available": "نسخهٔ {{latestVersion}} از OpenScreen آمادهٔ دریافت است. نسخهٔ فعلی شما {{currentVersion}} است.",
"current": "OpenScreen به‌روز است (نسخهٔ {{currentVersion}}).",
"readyToInstall": "نسخهٔ {{latestVersion}} از OpenScreen دریافت شد. برای پایان نصب، برنامه را دوباره اجرا کنید.",
"blockedRecording": "پیش از نصب به‌روزرسانی، ضبط را تمام کنید.",
"blockedLocation": "پیش از به‌روزرسانی، OpenScreen را به پوشهٔ Applications منتقل کنید.",
"failed": "بررسی به‌روزرسانی ممکن نشد.",
"downloadFailed": "دریافت به‌روزرسانی ممکن نشد."
},
"units": {
"pixelsPerSecond": "{{value}} پیکسل بر ثانیه",
"pixels": "{{value}} پیکسل"
},
"locale": {
"name": "فارسی",
"short": "FA"
},
"recordingSource": {
"window": "پنجره",
"screen": "صفحه‌نمایش",
"virtual": "نمایشگر مجازی",
"unknown": "ضبط صفحه"
},
"presenterOverlay": {
"interruptedTitle": "ممکن است ضبط دوربین ناقص باشد",
"interruptedDescription": "ممکن است قابلیت Presenter Overlay ضبط دوربین را قطع کرده باشد. آن را خاموش کنید و دوباره ضبط کنید."
}
}
100 changes: 100 additions & 0 deletions src/i18n/locales/fa/dialogs.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
{
"export": {
"complete": "خروجی آماده است",
"yourFormatReady": "فایل {{format}} آماده است",
"showInFolder": "نمایش در پوشه",
"finalizingVideo": "در حال تکمیل خروجی ویدیو…",
"compilingGifProgress": "در حال ساخت GIF… ({{progress}}٪)",
"compilingGifWait": "در حال ساخت GIF… ممکن است کمی طول بکشد",
"takeMoment": "ممکن است کمی طول بکشد…",
"failed": "گرفتن خروجی ناموفق بود",
"tryAgain": "دوباره امتحان کنید",
"finalizingVideoTitle": "تکمیل ویدیو",
"compilingGif": "ساخت GIF",
"exportingFormat": "در حال گرفتن خروجی {{format}}",
"compiling": "در حال ساخت",
"renderingFrames": "در حال رندر فریم‌ها",
"processing": "در حال پردازش…",
"finalizing": "در حال تکمیل…",
"compilingStatus": "در حال ساخت…",
"status": "وضعیت",
"format": "قالب",
"frames": "فریم‌ها",
"cancelExport": "لغو خروجی",
"savedSuccessfully": "فایل {{format}} ذخیره شد!"
},
"tutorial": {
"triggerLabel": "راهنمای برش",
"title": "برش چگونه کار می‌کند؟",
"description": "با نحوهٔ حذف بخش‌های ناخواستهٔ ویدیو آشنا شوید.",
"explanationBefore": "با ابزار برش، بخش‌هایی را که می‌خواهید",
"remove": "حذف",
"explanationMiddle": "کنید مشخص کنید. هر بخشی که در محدودهٔ قرمز برش",
"covered": "قرار بگیرد",
"explanationAfter": "، در خروجی حذف می‌شود.",
"visualExample": "نمونهٔ تصویری",
"removed": "حذف‌شده",
"kept": "باقی‌مانده",
"part1": "بخش ۱",
"part2": "بخش ۲",
"part3": "بخش ۳",
"finalVideo": "ویدیوی نهایی",
"step1Title": "۱. افزودن برش",
"step1DescriptionBefore": "کلید ",
"step1DescriptionAfter": " را بزنید یا روی نماد قیچی کلیک کنید تا بخشی برای حذف مشخص شود.",
"step2Title": "۲. تنظیم محدوده",
"step2Description": "لبه‌های محدودهٔ قرمز را بکشید تا دقیقاً بخش موردنظر برای حذف را بپوشاند."
},
"unsavedChanges": {
"title": "تغییرات ذخیره‌نشده",
"message": "تغییرات شما هنوز ذخیره نشده‌اند.",
"detail": "می‌خواهید پروژه را پیش از بستن ذخیره کنید؟",
"saveAndClose": "ذخیره و بستن",
"discardAndClose": "بستن بدون ذخیره",
"detailNewProject": "می‌خواهید پروژهٔ فعلی را پیش از ساخت پروژهٔ جدید ذخیره کنید؟",
"saveAndNewProject": "ذخیره و ساخت پروژهٔ جدید",
"discardAndNewProject": "ساخت پروژهٔ جدید بدون ذخیره",
"detailLoadProject": "می‌خواهید پروژهٔ فعلی را پیش از باز کردن پروژه‌ای دیگر ذخیره کنید؟",
"saveAndLoadProject": "ذخیره و باز کردن پروژه",
"discardAndLoadProject": "باز کردن پروژه بدون ذخیره",
"newProject": "پروژهٔ جدید",
"importVideo": "وارد کردن فایل ویدیو…",
"loadProject": "باز کردن پروژه…",
"saveProject": "ذخیرهٔ پروژه…",
"saveProjectAs": "ذخیرهٔ پروژه با نام دیگر…",
"modal": {
"closeTitle": "تغییرات پیش از بستن ذخیره شوند؟",
"closeBody": "پروژه تغییرات ذخیره‌نشده دارد. می‌توانید آن‌ها را ذخیره کنید، از آن‌ها صرف‌نظر کنید یا در ویرایشگر بمانید.",
"newTitle": "تغییرات پیش از ساخت پروژهٔ جدید ذخیره شوند؟",
"openTitle": "تغییرات پیش از باز کردن پروژه‌ای دیگر ذخیره شوند؟",
"recordTitle": "تغییرات پیش از شروع ضبط جدید ذخیره شوند؟",
"sharedBody": "پروژهٔ فعلی تغییرات ذخیره‌نشده دارد. می‌توانید آن‌ها را ذخیره کنید، از آن‌ها صرف‌نظر کنید یا عملیات را لغو کنید.",
"notSavedYet": "پروژهٔ فعلی هنوز روی دیسک ذخیره نشده است.",
"discard": "ادامه بدون ذخیره",
"saveAndContinue": "ذخیره و ادامه",
"saving": "در حال ذخیره…"
}
},
"fileDialogs": {
"saveGif": "ذخیرهٔ خروجی GIF",
"saveVideo": "ذخیرهٔ خروجی ویدیو",
"selectVideo": "انتخاب فایل ویدیو",
"selectAudio": "انتخاب فایل صوتی",
"saveProject": "ذخیرهٔ پروژهٔ OpenScreen",
"openProject": "باز کردن پروژهٔ OpenScreen",
"gifImage": "تصویر GIF",
"mp4Video": "ویدیوی MP4",
"videoFiles": "فایل‌های ویدیو",
"audioFiles": "فایل‌های صوتی",
"openscreenProject": "پروژهٔ OpenScreen",
"allFiles": "همهٔ فایل‌ها",
"selectRecordingsFolder": "انتخاب پوشهٔ ضبط‌ها"
},
"recording": {
"lowDiskSpace": "فضای کافی برای شروع ضبط وجود ندارد (فقط {{availableMb}} مگابایت آزاد است). فضا خالی کنید یا پوشهٔ دیگری برای ضبط‌ها انتخاب کنید و دوباره امتحان کنید.",
"folderUnavailable": "پوشهٔ ضبط‌ها در مسیر {{path}} در دسترس نیست. درایو آن را دوباره وصل کنید یا در حالت ضبط، پوشهٔ دیگری انتخاب کنید.",
"captureInterrupted": "ضبط صفحه پس از {{duration}} به‌طور غیرمنتظره قطع شد. بخشی که تا آن لحظه ضبط شده بود ذخیره شد.",
"captureLost": "ضبط صفحه به‌طور غیرمنتظره قطع شد و چیزی قابل استفاده ضبط نشد.",
"audioLost": "بخشی از صدا ضبط نشد. ویدیو بدون آن بخش از صدا ذخیره شد."
}
}
Loading
Loading