# העריכה הראשונה שלכם ב־CUTROOM

**ערכים מספריים:** גררו מספר למעלה להגדלה ולמטה להקטנה; אפשר לגרור גם את המספר שליד מחוון. Shift מאט את ההתאמה. השחרור מחיל שינוי אחד, ו־Escape או מעבר לחלון אחר מבטלים גרירה. הגלגלת משנה רק שדה ממוקד ומאחדת רצף קצר לשינוי אחד. הקלדה וחצי המקלדת נשארים זמינים, והגבולות וכללי השמירה נשמרים.

CUTROOM היא מערכת עריכת וידאו חינמית ובקוד פתוח, שנמצאת בבטא. היא מסייעת להפוך הקלטות לטיוטה שניתנת לעריכה; אתם מחליטים מה נכנס לסרטון הסופי. הממשק באנגלית, ולכן שמות הכפתורים במדריך נשארים כפי שמופיעים באפליקציה. [English](USER_GUIDE_EN.md)

התחילו במסלול הקצר. ההסברים המפורטים בהמשך נועדו לקריאה כשצריך, לא כמבחן לפני העריכה הראשונה.

כפתור **Day / Night** בסרגל העליון מחליף בין מצב יום ללילה ושומר את הבחירה בדפדפן. צבעי הסרטון עצמו אינם משתנים. **Guide** פותח עזרה עם חיפוש מכל מסך. בזמן עבודה, חיווי התהליך וכפתור **Stop process** נשארים יחד מתחת לניווט.


**סדר העבודה בסרגל התחתון:** Media → Edit → Layout → Audio → Captions → Output. ב־Edit עוברים בין עריכת קליפ לבין אפקטים · מסך ירוק. Layout מיועד להרכב התמונה, לגודל ולמיקום. הנגן וציר הזמן נשארים זמינים במחשב; אפשר לגרור את המפרידים ולגלול בכלים.

## המסלול הקצר

1. בחרו הורדה ל־Windows או ל־Mac וחלצו את כל ה־ZIP. קובץ ההפעלה נמצא לצד **App**. בחבילה המשולבת הישנה פתחו קודם **windows** או **mac**. ב־Windows הפעילו **`START CUTROOM.bat`**; ב־Mac הפעילו **`START CUTROOM.command`**. קראו ואשרו את ההנחיות, המתינו לסיום ההתקנה והשאירו את חלון ההפעלה פתוח. משאירים ליד המפעיל את **START HERE.html** (עזרה ללא אינטרנט) ואת **App** (קבצים טכניים ועבודה שמורה). בהורדות Windows ישנות ובעותק קוד מ־GitHub ממשיכים להשתמש ב־`run_windows.bat`. משתמשי Mac: התחילו ב[מדריך Mac](https://github.com/VanoPeradze/cutroom/blob/master/docs/MAC_BETA.md); נדרשת macOS 15 ומעלה, וייתכן צורך ב־Homebrew להתקנת רכיבים בפעם הראשונה.
2. בחרו **Manual edit** והוסיפו הקלטה קצרה ולא רגישה כמקור A. כך אפשר להכיר את העורך בלי לחכות למודלים או לעיבוד AI.
3. לחצו **Open manual editor**. לחיצה על סרגל הזמן מזיזה את הסמן; **Space** מפעיל ועוצר ניגון.
4. בחרו **Range**, סמנו בגרירה קטע לא רצוי ולחצו **Remove from video**. נסו **Undo**. אחר כך בחרו **Cut** ולחצו פעם אחת כדי לפצל קטע.
5. פתחו **Output**, בדקו פורמט וקצב תמונה, ואז **Export → Start export → Download video**. צפו בקובץ שהורדתם גם מחוץ ל־CUTROOM.

עריכה ידנית לא יוצרת תמלול או סיפור אוטומטי. הוספת מדיה לספרייה, הקלדת כותרות וכתוביות, ייבוא כתוביות, מיקס אודיו וייצוא פועלים בלי מפתח API או מודלי AI. כשתרגישו בנוח, אפשר להתחיל פרויקט Short/Reel או YouTube ולהגדיר חיבור AI.

## 1. בוחרים תוצאה לפני שמוסיפים חומר גלם

| נקודת התחלה | ההגדרה הראשונית | מתאים לניסיון ראשון של |
| --- | --- | --- |
| **Short / Reel** | אנכי 9:16, בחירת רגעים בסיוע AI | קטע ממוקד מהקלטה ארוכה |
| **YouTube video** | אופקי 16:9; ניקוי ששומר כברירת מחדל על סדר ההקלטה | הסבר, גיימפליי או סרטון דיבור ארוך |
| **Manual edit** | אופקי 16:9, כל ההקלטה הראשית בטיימליין | עריכה ישירה ללא מודלי AI או חשבון |

אלה הגדרות פתיחה, לא בחירה בלתי הפיכה. משנים פורמט בהמשך דרך **Output**. ניקוי של סרטון YouTube אינו זהה ליצירת תקציר קצר: המבנה וההסבר חשובים יותר מהגעה לאורך מינימלי.

במסך הכניסה וב־**Projects** מופיעים ליד כל פרויקט **Open editor**, **Rename** ו־**Delete**. ב־Projects אפשר לחפש לפי שם ולמיין לפי **Recently edited**, **Name A–Z** או **Oldest first**. ‏Rename פותח שדה שם; **Save name** שומר בלי לפתוח מחדש את העריכה. אפשר לשנות את השם גם בסרגל העליון של העורך.

**Delete** פותח אישור מחיקה. **Keep project** מבטל; **Delete project permanently** מוחק את הפרויקט, עותקי המדיה שיובאו, העריכות, התצוגות המקדימות וקובצי הייצוא השמורים ב־CUTROOM. קובצי המקור מחוץ ל־CUTROOM אינם נמחקים. אין Undo למחיקת פרויקט. ממתינים לסיום ייבוא או תהליך פעיל, או עוצרים את התהליך בעורך תחילה; מחיקה אינה מבטלת אותו בשבילכם.

חיווי השמירה מראה אם השינויים הושלמו. מומלץ לא לערוך אותו פרויקט בכמה לשוניות במקביל.

## 2. בוחרים איפה ה-AI יעבוד

פותחים **AI connection**. בחירה באפשרות בלבד אינה שומרת אותה—לוחצים **Use local AI** לעבודה מקומית או **Use this cloud connection** לענן. לא מחליפים חיבור בזמן שעיבוד פעיל.

| אפשרות | מה מקבלים | מה נדרש ומה המגבלות |
| --- | --- | --- |
| **On my computer** | תמלול ובניית סיפור במחשב, ללא תשלום לספק AI וללא שליחת התוכן אליו | הורדה ראשונית של מודלים, אחסון וזיכרון; המהירות תלויה במחשב |
| **Online — Free tier** | Groq מעבד אודיו וטקסט תמלול עם הקשר העריכה; פחות עבודת AI במחשב | מפתח Groq Free שלכם, אינטרנט ומכסה פנויה; חינם במסגרת מכסות המסלול |
| **My own API account** | Groq או ספק תואם עם כתובת HTTPS ציבורית לתמלול ולתכנון סיפור | כתובת API, מודלים נתמכים ומפתח אישי; הספק עשוי לחייב. CUTROOM לא רוכשת, משדרגת או מגבילה את החשבון |
| **Manual edit** | טיימליין, פריסה, תצוגה וייצוא בלי AI | חומר גלם בלבד; בלי מודלי AI או חשבון, ובלי תמלול או סיפור אוטומטיים |

### מודלים מקומיים: מה מורידים ולמה?

ל־AI המקומי שני תפקידים נפרדים:

- **Speech model — מודל תמלול:** הופך דיבור למילים ולתזמון. מודל קטן צורך פחות משאבים; מודל גדול או מותאם לשפה עשוי לסייע בהקלטה קשה, אך גם הוא עלול לטעות.
- **Story model — מודל סיפור:** קורא תמלול כדי לסכם ולבחור רגעים. הוא לא משחזר מילים שאבדו בתמלול ולא משמש מנוע להבנה חזותית של אירועי משחק.

המודלים אינם מצורפים ל־ZIP. ההורדה דורשת אינטרנט; קבצים מותקנים משמשים שוב. אין צורך להוריד את כל האפשרויות. הורדת מודל אינה מחליפה בעצמה את פרופיל הביצועים או את חיבור ה־AI.

1. פותחים **AI connection → On my computer** ולוחצים **Use local AI** אם עוברים מהענן. פותחים שוב את החלון להגדרה.
2. ב־**Prepare local AI** לוחצים **Refresh status**. אם מנוע הסיפור חסר, **Get Ollama** פותח את אתר ההתקנה הרשמי. מתקינים, חוזרים ומרעננים. אם הוא מותקן אך אינו פעיל, בוחרים **Start local engine**.
3. בוחרים מודל תמלול, קוראים את התפקיד והגודל המשוער ולוחצים **Download transcription model → Confirm download**. ‏**Not now** סוגר את האישור בלי להתחיל הורדה.
4. חוזרים על הפעולה עם **Download Story model** אם מסלול העבודה דורש מודל סיפור. רק הורדת מודל אחת פעילה בכל רגע.
5. עוקבים אחר ההתקדמות בחלון. **Cancel download** מבקש לבטל; סגירת החלון אינה עוצרת הורדה. בסיום בודקים **Downloaded** ובוחרים בפרויקט את פרופיל הביצועים המתאים.

| פרופיל מקומי | מודל תמלול | הורדה משוערת | מודל סיפור מועדף | הורדה משוערת |
| --- | --- | --- | --- | --- |
| Lite | Whisper Base | 0.15 GB | Qwen3.5 2B | 2.7 GB |
| Balanced | Whisper Small | 0.49 GB | Qwen3.5 4B | 3.4 GB |
| Quality | Whisper Turbo | 1.63 GB | Qwen3.5 9B | 6.6 GB |
| Quality עם בחירת Hebrew | ivrit.ai Whisper Large V3 Turbo | 1.63 GB | Qwen3.5 9B | 6.6 GB |

אלה אומדני הורדת מודלים, **לא גודל ההתקנה הכולל ולא דרישות הזיכרון**. רכיבי תוכנה, קבצים זמניים, חומר גלם, תצוגות מקדימות וייצוא דורשים מקום נוסף. בדקו את מודל הסיפור המבוקש ואת המודל שנבחר בפועל: אם 9B/2B חסר, המערכת יכולה לדווח על שימוש במודל חלופי מותקן לפי ההגדרה (4B בברירת המחדל). אין הורדה אוטומטית; בחרו מודל מותקן או הורידו במפורש את המודל הרצוי. שם הפרופיל אינו מבטיח איכות של בחירת התוכן. [פירוט המודלים](MODELS.md)

מנוע הסיפור המקומי הוא **Ollama**, והוא נפרד מקובצי המודלים. פעולת הורדת מודל אינה מתקינה אותו בשקט ואינה מאשרת הרשאות Windows עבורכם. אחרי ביטול עשויים להישאר קובצי הורדה חלקיים לשימוש חוזר. אין למחוק מטמונים משותפים כפתרון שגרתי. **Downloaded** בודק קבצים—לא מבטיח שיש מספיק זיכרון להפעלת המודל או שכבר בוצע איתו עיבוד מוצלח.

ניקוי YouTube כרונולוגי כברירת מחדל יכול לעבוד ללא מודל סיפור; עריכת Short/Reel מבוססת סיפור דורשת אותו. לתמלול מקומי עדיין נדרש מודל דיבור. **Manual edit** לא צריך אף אחד מהם. [עזרה בחיבור](AI_CONNECTIONS.md) · [פתרון תקלות התקנה](TEST_ON_ANOTHER_PC.md)

### AI בענן: מפתח, פרטיות ועלויות

ב־**My own API account** בוחרים **Groq** או **OpenAI-compatible provider**. לספק אחר מזינים כתובת בסיס ציבורית של HTTPS ומזהי מודלים. שני המודלים חייבים לפעול באותו חשבון ובאותה כתובת: `/chat/completions` עם מצב תשובת JSON object, ו־`/audio/transcriptions` עם `verbose_json` וזמני מילים. שירות צ'אט בלבד או מנוי לצ'אט אינם מספיקים; כתובות מקומיות וברשת פרטית נדחות. מזינים מפתח אישי ומאשרים את היעד ושליחת המידע לפני השמירה.

מודל הדיבור מחזיר מילים ותזמון; מודל הסיפור מחזיר תוכנית עריכה מובנית על סמך התמלול. מודל צ'אט חזק יותר לא משחזר מילים שלא נשמעו או הוחמצו. החיבור הנוכחי אינו מאפשר לפצל את התפקידים בין ספקים שונים.

לתמלול נשלח האודיו שנבחר; ל־Story AI נשלחים טקסט התמלול והקשר העריכה. לא נשלחות תמונות מתוך הסרטון. דיבור וטקסט עשויים להיות מידע רגיש—השתמשו בענן רק כשמותר לכם לשתף אותם עם הספק. תצוגות מקדימות וייצוא MP4 עדיין מתבצעים במחשב: זה אינו שירות רינדור מרוחק או מוצר שעובד רק דרך אתר בלי התקנה.

מפתח שמוזן באפליקציה נשמר בזיכרון רק להפעלה הנוכחית ומשויך לספק ולכתובת הבסיס שבחרתם. שינוי הספק או הכתובת דורש מפתח חדש ואישור חדש. אחרי הפעלה מחדש יש לחבר אותו שוב. **Forget session key** מוחק אותו מזיכרון ההפעלה ובוחר AI מקומי. מפתח שהוזן אינו הוכחה שהספק אימת אותו. אל תכללו מפתחות בצילומי מסך או בדיווחי תקלה.

הכיתוב Free tier לא בודק את המסלול שלכם ולא מונע חיוב של מפתח השייך לחשבון בתשלום. עריכת סיפור עשויה לכלול כמה בקשות. שגיאת מכסה, מפתח או ספק עוצרת את העבודה—אין מעבר אוטומטי לספק אחר או למסלול בתשלום. ביטול לא יכול להחזיר שימוש שהספק כבר קיבל. בדיקות עם תשובות מדומות אינן אישור לתוצאות של עיבוד אמיתי בענן. [הסבר פרטיות וחיבור](AI_CONNECTIONS.md)

## 3. מוסיפים חומר גלם ובודקים מקורות

**Source A** הוא הקובץ הראשי, ו־**Source B** הוא קובץ נוסף לבחירה. A ו־B הם שמות קבצים במסלול העריכה, לא תפקידים קבועים של מצלמה ומסך. השתמשו בחומר שמותר לכם לערוך והמתינו לסיום ההוספה וההכנה לפני בניית טיוטה.

**הקלטה אחת רגילה:** מוסיפים רק A. אין צורך לייצר מקור נוסף.

**מצלמה ומסך בשני קבצים:** מוסיפים את שניהם ובודקים **Screen recording**, **Camera** ו־**Audio source**. בוחרים את האודיו שבו נמצא הדיבור שרוצים לתמלל ולשמוע בייצוא. סנכרון אוטומטי הוא נקודת התחלה; בדקו בתחילת ההקלטה וגם בסופה.

**מצלמה שכבר מופיעה בתוך הסרטון:** מוסיפים את הקובץ המשולב רק כ־A. ב־**Layout** בוחרים פריים לדוגמה ומזיזים או משנים את גודל מלבן המצלמה. הסרטון מתעדכן מיד והשינוי נשמר אוטומטית; ממתינים להודעת **Saved**. כדי לקבל את המלבן המוצע ללא שינוי, בוחרים פעם אחת **Use camera layout**. אין להוסיף את אותו הסרטון שוב כ־B. המצלמה ממלאת את 30% העליונים, והמסך הנותר את 70% התחתונים. הבחירה נשמרת גם ביצירת טיוטת AI ובבנייה מחדש. מדובר בחיתוך של הקלטה אחת לשני אזורים, לא בשחזור מצלמה נפרדת או פיקסלים מוסתרים. מצלמה שנעה בהקלטה מחייבת בדיקה ידנית.

ב־**Advanced**, השדה **Source B offset** משנה סנכרון לכל העריכה. מספר חיובי מציב את B מאוחר יותר; שלילי מוקדם יותר. כפתורי פריים אחד מאפשרים תיקון מדויק. תפקידי מקורות, אודיו, סדר וסנכרון הם הגדרות כלל־סרטוניות גם אם בחרתם טווח קצר.

## 4. מכינים טיוטת AI

- **Speech language:** בחרו את השפה המדוברת אם היא ידועה. זיהוי אוטומטי יכול לטעות כשיש מעט דיבור, מוזיקה או ערבוב שפות. זה תמלול, לא מערכת תרגום כתוביות מלאה.
- **Edit style:** מנחה קצב ובחירת רגעים. הוא לא משכפל יוצר, מוסיף נכסים מוגנים או מבטיח זיהוי חזותי של אירועי משחק.
- **Target length:** תקציב האורך לסגנון Short/Reel המתמקד ברגע אחד. גבולות משפטים ותוכן ההקלטה עשויים לקצר את התוצאה; בדקו את האורך בפועל.
- **Director instruction:** הנחיה לבחירה, למשל: “Keep the explanation and its example; remove repeated setup.” זו הכוונת עריכה, לא פקודה ליצירת כל תוכן אפשרי.
- **Burn captions into video:** הכתוביות יהיו חלק מהתמונה בקובץ MP4. אפשר לשנות את עיצובן בהמשך.
- **Audio cut line:** אודיו מתחת לקו הוא מועמד לשקט, לא הוראה למחוק כל צליל חלש. **Use recommended** מתחיל ממדידה. **Handle silence longer than** קובע משך שקט מינימלי; **Silence to keep** משאיר מרווח נשימה. האזינו לדיבור שקט לפני החמרת החיתוך.

כשהמוכנות מאושרת, בחרו **Build my first cut**. תמלול, עבודה על סיפור והכנת תצוגה לא נמשכים בהכרח אותו זמן. **Stop process** מבקש לבטל; המתינו להשלמת הביטול לפני ניסיון חדש.

**Clean VOD** שומר על ניקוי טבעי וכרונולוגי, בלי לכפות חיתוכי היילייט מהירים. הפריסט מכוון את התוצאה; בדקו בעצמכם את התוכן שנבחר.

אם עבודה נעצרת, קראו את הסיבה וטפלו בה. ההקלטות המקוריות אינן נדרסות. מודל גדול יותר לא יפתור מקור אודיו שגוי ולא יחזיר דיבור שלא נשמע בהקלטה.

## 5. בודקים את הטיוטה

מסך הסיכום מציג את הטיוטה, משך לפני/אחרי ו־**What changed**. אם מוצגות **Reel options**, השוו ביניהן; אלה הצעות ולא הוכחה לסיפור טוב יותר.

**Shorter**, **Keep more**, **More energy**, **Fewer switches**, **Focus speaker** ו־**Try another cut** מבקשים שינוי עריכה. הם אינם כפתורי ניגון. בדקו את התוצאה לפני המשך עבודה ידנית מדויקת, משום שפעולות AI יכולות לשנות את הטיוטה. **Studio** פותח את סביבת העריכה.

אם מופיעה ההודעה **New draft ready; your manual timeline was kept**, הניגון והייצוא ממשיכים להשתמש בעריכה הידנית. **Apply new AI draft** מבקש אישור לפני החלפתה; **Keep manual timeline** משאיר אותה. לאחר ההחלה, Undo יכול לשחזר את הטיימליין הידני הקודם.

## 6. מכירים את Studio

| אזור | למה הוא מיועד |
| --- | --- |
| **Preview** | צפייה וניווט, מעבר בין Edited video ל־Full source ומסך מלא של הסרטון |
| **Timeline** | בחירה, פיצול, הסרה, החזרה, הזזה וקיצור קטעים |
| **Media & audio** | הוספת וידאו, תמונות ואודיו; מיקום שכבות מדיה ואיזון המיקס |
| **Layout** | סידור A/B, אישור מצלמה מובנית ומסגור לכל קטע |
| **Captions** | הוספת טקסט וכתוביות, ייבוא SRT/VTT, או תיקון ועיצוב תמלול AI |
| **Output** | פורמט, רזולוציה, FPS ואיכות; הגדרות AI מתקדמות בנפרד |
| **Project overview** | חזרה לסיכום ולאפשרויות השיפור האוטומטי |

במסך גדול אפשר לגרור את המפריד בין התצוגה לטיימליין; לחיצה כפולה מאפסת. **Full screen** מגדיל את הסרטון, לא את כל לוח הבקרה; **Escape** מחזיר לעריכה. **How to edit** מציג עזרה קצרה. **Help & guide** כולל הסברים עם חיפוש—נסו “models”, “layout”, “captions” או “export”. אפשר להשאיר אזורים מתקדמים סגורים עד שצריך אותם.

### שלושת כלי הטיימליין העיקריים

**Select / Move:** לחצו על קטע וגררו למקום חדש. הקטעים מפנים לו מקום במקום להידרס. משכו קצה לבן כדי לקצר או לחשוף חומר נוסף מהמקור עד לגבול ההקלטה או הקטע השכן. כדי להזיז רק חלק מקטע, סמנו אותו ב־Range, עברו ל־Select / Move וגררו מתוך הבחירה.

**Range:** גררו כדי לסמן טווח ואז **Remove from video**. אפשר להתחיל או לסיים באמצע קטע—לא מוגבלים לחיתוכי ה־AI. **Range…** מאפשר זמנים מדויקים בשניות או בפורמט `mm:ss.mmm`.

**Cut:** לחיצה אחת מפצלת במקום שנבחר, בלי להסיר דבר. **Cut out** בתוך More editing tools מסיר את החלק בין שתי לחיצות; Escape מבטל נקודת חיתוך ראשונה שטרם הושלמה.

לחיצה בסרגל מזיזה את הסמן הצהוב. **+ / −** מבצעים זום סביבו; **Fit** מציג את כל העריכה. **Zoom to selection** מתמקד בבחירה. **Snap** מסייע בהצמדת גבולות; מכבים אותו לבחירה חופשית יותר. Undo/Redo משנים את העריכה, לא את חומר הגלם המקורי.

כפתור **Snap** נמצא בסרגל הטיימליין ליד Undo/Redo. כשהוא פעיל, קצוות ובחירות נצמדים לסמן הצהוב, לחיתוכי A/B ולקצוות מדיה או סאונד שהוספתם. קו תכלת מציין למה נצמדים. **Alt** עוקף הצמדה זמנית; **Esc** מבטל גרירה ללא שמירה. ברירת המחדל נשארת כבויה, וגרירת הסרגל אינה קופצת לחיתוכים. בהזזת מקור נצמד הקצה הראשון והמקום הישן נסגר; במדיה נוספת אפשר להצמיד כל אחד משני הקצוות. אי אפשר להאריך מעבר לחומר הגלם הזמין. הזמן שמופיע מעל הטיימליין מוצג כ־**שעות:דקות:שניות:פריימים** בקצב הייצוא; בקיצור או הארכה מוצג הגבול האפשרי בפועל.

### ביחד או מקור אחד?

| יעד העריכה | מה משתנה | רווחים |
| --- | --- | --- |
| **Together (A+B)** | שני המקורות ומיפוי הפריסה שלהם | הסרה סוגרת את הטווח; הזזה מעבירה את הקטע המשולב |
| **A only / B only** | המקור שנבחר בלבד; האחר נשאר במקומו | הסרה יכולה להשאיר רווח מכוון; הזזה משנה רק את אותו ערוץ |

Together עוזר לשמור סנכרון. בחרו A/B בלבד כשבאמת רוצים תזמון עצמאי. **Close gaps** סוגר זמן ריק בהתאם ליעד; במצב Together רק אם שני המקורות ריקים בו. כשמקור אחד חסר, השני ממלא את המסך; כששניהם חסרים, התמונה שחורה. האודיו עוקב אחרי המקור שנבחר ושקט ברווחים שלו.

### מגנים על מקור שסיימתם לערוך

פתחו **Edit → Track protection** ובחרו **Lock A** או **Lock B**. הבקרה מופיעה אחרי שנוצרה טיוטה. הנעילה מגינה על חיתוכים, הזזות, קיצור והארכה, מסגור קטעים, מהירות תמונה ותזמון של אותו מקור. היא אינה משתיקה או מסתירה אותו: התמונה, השמע והייצוא ממשיכים כרגיל. כדי להמשיך לערוך את המקור האחר, בחרו **A only / B only** של המקור שאינו נעול.

ההגנה נשמרת בפרויקט גם אחרי סגירה ופתיחה מחדש. נעילה ושחרור נעילה אינם צעדים בהיסטוריית Undo/Redo ואינם מוחקים את ההיסטוריה הקיימת. פעולת Together או צעד Undo/Redo שישנו ערוץ נעול יידחו בלי לשנות את העריכה ובלי לצרוך את צעד ההיסטוריה. שחררו את הנעילה ונסו שוב; Undo אינו משחרר אותה בעצמו.

לפני בנייה מחדש או שיפור של הטיוטה, או לפני החלפה או הסרה של קובץ מקור, שחררו את כל המקורות המוגנים: פעולות אלה עשויות לאפס את הטיוטה המשותפת. גם **Reset to AI draft** דורש לשחרר ערוץ מוגן אם האיפוס ישנה אותו. אפשר להמשיך לשנות פריסה משותפת, מיקסר אודיו ומדיה נוספת; מסגור של קטע במקור מוגן נשאר נעול. שינוי היסט הסנכרון של B דורש ש־B יהיה משוחרר.

הבקרות מגינות על ערוצי A/B הקיימים. מדיה נוספת אינה זזה איתם אוטומטית בפעולת Ripple, ויצירה חופשית של ערוצי מקור נוספים אינה חלק מהעדכון הזה.

### מחזירים קטע שהוסר

פותחים **Original footage** כדי לראות את ההקלטה השלמה ואת החלקים שנשארו או הוסרו. בוחרים A/B, צופים באזור או מסמנים טווח ולוחצים **Restore to edit**. **Previous removed / Next removed** עוזרים לעבור בין השמטות. חומר חסר חוזר ליד שכניו מהמקור בלי לסדר מחדש קטעים שכבר ערכתם. **Remove from edit** משפיע על השימושים של אותו טווח מקור, כולל עותקים; בדקו יעד לפני לחיצה.

**Insert a copy by time…** מוסיף עותק מכוון בנקודת עריכה מדויקת. **Duplicate clip** משכפל בחירה. **Reset to AI draft** מאפס את השינויים הידניים בטיימליין אחרי אישור; כדי לחזור מפעולה אחרונה עדיף Undo רגיל. [כללי עריכה מפורטים](INDEPENDENT_TRACKS.md)

### מקשים מוכרים

פותחים **More editing tools → Keys / Shortcuts** ובוחרים פרופיל. הרשימה מציגה את הפעולות שנתמכות ב־CUTROOM. Space מפעיל ועוצר. הקיצורים אינם פועלים בזמן הקלדה בכתוביות או בשדות. [פירוט קיצורים](KEYBOARD_PROFILES.md)

### מוסיפים מדיה ומאזנים אודיו

ב־**Media & audio** בוחרים **Add media** ומייבאים וידאו, תמונה או אודיו לספריית הפרויקט. ממתינים להכנה, ממקמים את הסמן הצהוב ולוחצים **+ Add**. גוררים את הקטע או את קצותיו במסלולי הטיימליין וגלי הקול; בחלונית הקטע אפשר לקבוע התחלה וסיום מדויקים, נקודת כניסה למקור, עוצמה וכניסה/יציאה הדרגתית. לתמונה אפשר לבחור מצב קבוע, זום איטי או תנועה הצדה. **Use clip audio** מפעיל שמע של וידאו נוסף; בדקו גם את **Audio group**.

גל האודיו בטיימליין מציג מדידה אמיתית של מקור A/B שנבחר, גם בעריכה ידנית ללא AI. לאודיו מיובא יש גל משלו. קטע שקט, מקור ללא אודיו ומדידה שעדיין נטענת או נכשלה מוצגים כמצבים נפרדים.

פתחו **Audio mixer** כדי לאזן Original, Voiceover, Music, Effects ו־Master. ‏Original הוא מקור האודיו A/B שנבחר; יתר הערוצים מקבצים מדיה לפי תפקיד האודיו. עוצמה ו־Mute חלים בתצוגה ובייצוא; Solo מיועד להאזנה בתצוגה בלבד. המדדים מציגים שיאי אות אמיתיים בדפדפן ומתאפסים בהשהיה ובמעבר בזמן. השאירו מרווח מהתחום האדום; נרמול בייצוא עשוי לשנות את העוצמה הסופית. שכבות המדיה נכנסות בתוך משך העריכה הקיים: הוספת קובץ לא מאריכה את הסרטון כולו ולא יוצרת מקורות A/B נוספים.

**Stabilize footage** יוצר עותק מקומי בלי להחליף את המקור או העריכה. התמיכה תלויה בגרסת FFmpeg, והחלקת הרעידה עשויה לחתוך קצוות. [הוראות ומגבלות באנגלית](STABILIZATION.md).

בקטע ראשי של A או B, ‏**Picture speed** משנה רק את מהירות התמונה, מ־0.25× עד 4×. אורך הקטע ותזמון הדיבור נשמרים. התמונה עלולה לצאת מסנכרון עם השפתיים, ובהגעה לסוף המקור הפריים האחרון עשוי להישאר על המסך. בדקו לפני הייצוא; זו אינה האצה של התמונה והשמע יחד.

## 7. מסדרים פריסה ומסגור

קודם בוחרים **איפה**: טווח בטיימליין, From/To מדויקים או **Entire edit**. אחר כך בוחרים **Screen only**, **Camera only**, **Stacked**, **Side by side** או **Picture in picture**. הבחירה נשמרת מיד. **AI choice** מחזיר את אותו טווח לפריסה שהוצעה בטיוטה.

ברירת המחדל ל־Reels חדשים עם שני מקורות היא **Stacked**: מצלמה ב־30% העליונים ומסך ב־70% התחתונים, במילוי הפריים ללא מתיחה. בחירות ידניות שמורות נשארות כפי שהן. בפרויקט קיים אפשר לבחור **Advanced → Restore 30/70 stack** כדי להחזיר את הסדר והמילוי לכל העריכה. גם **First in layout**, **Primary source**, **Swap top / bottom**, אודיו וסנכרון נמצאים תחת **Advanced**. בהקלטה משולבת, **Camera area in this recording** מאפשר לתקן את מלבן המצלמה; לאחר הגדרה האזור מתחיל מקופל. תצוגת המקור הנוספת נמצאת תחת **Original source preview**.

**Fill frame** חותך קצוות כדי למלא את האזור. **Fit entire source** שומר את כל התמונה ומוסיף שוליים לפי הצורך—לא מועך את התמונה. ב־**Clip framing** בוחרים A/B ומשנים Horizontal focus, Vertical focus ו־Zoom. בדקו את תווית הטווח: השינוי חל על הבחירה, או על הקטע בסמן כשאין בחירה, ולא אוטומטית על כל הסרטון. המסגור עובר עם קטעים שהוזזו או הועתקו. גלישה ב־Full source אינה מצב לעריכת מסגור של קטע.

במצלמה מובנית גוררים את המלבן שלה; פותחים **Precise camera position** רק כשצריך שליטה מספרית. **Main screen focus** מגדיר את מיקום המסך כברירת מחדל; מיקוד שנקבע לקטע מסוים מקבל עדיפות. תחת **More layouts** נמצאות פריסה זה לצד זה, תמונה בתוך תמונה וברירת המחדל של הסגנון. המלבן הקבוע אינו עוקב אוטומטית אחרי מצלמה שנעה. **Source order preview** בודק את סידור המקורות; **Layout by section** מציג את אזורי הפריסה הקיימים. אם השמירה נכשלת, מוצגת הודעה וכפתור **Retry save**; אין לסגור את העורך לפני שמופיע **Saved**.

פתחו **Edit > Effects · Green screen** ובחרו לפי הסדר: הסרטון הקדמי, הצבע להסרה והרקע. לרקע נע, השאירו אותו כסרטון הראשי, הוסיפו את סרטון המסך הירוק דרך **Media > Add media**, שימו אותו בציר הזמן ובחרו **הסרטון שמתחת**. כפתור הגדרות ההתחלה משתמש בסבילות 12%; 100% עלול למחוק גם את התוכן הרצוי. **החלה ותצוגה** שומר את ההגדרות, מעדכן את הנגן במצב עריכה ומכין פריים מעובד מדויק. מצב חומר מקורי נשאר ללא עיבוד. מקורות A/B ומדיה תומכים גם ברקע צבע או תמונה. ההגדרות נפרדות לכל סרטון, עם Undo/Redo ואיפוס. קצוות התצוגה החיה עשויים להיות שונים מהפריים המדויק ומהייצוא. [שלבים ומגבלות](CHROMA_KEY.md)

## 8. מוסיפים טקסט ושולטים בכתוביות

### כותרות וכתוביות משלכם

לאחר יצירת טיוטה או פתיחת העורך הידני, פתחו **Captions → Your text & captions**. מקמו את הסמן ובחרו **Add text** לכותרת או **Add caption** לכתובית. בחרו את הפריט החדש והקלידו. התצוגה מתעדכנת מיד, והשינוי נשמר אוטומטית אחרי הפסקה קצרה בהקלדה; המתינו ל־**Saved** לפני יציאה. אם השמירה נכשלת, הטקסט הממתין נשמר בחלון ומופיעים **Retry save** או **Discard unsaved text changes**.

כל פריט מופיע כשכבה בטיימליין. גררו אותו לשינוי מיקום בזמן, או את הקצוות לשינוי משך; **Start / End (seconds)** מאפשרים תזמון מדויק. **Preview at start** מנווט לתחילת הפריט. בוחרים **Top**, **Center** או **Bottom**, סגנון **Clean**, **Bold** או **Boxed**, וגודל בין 75% ל־150%. מחפשים באמצעות **Find custom text**, מוחקים באמצעות **Remove text**, ומשתמשים ב־Undo/Redo כדי להפוך שינויי טקסט שנשמרו.

הזמנים מתייחסים ל־**סרטון הערוך**, לא להקלטה המקורית. הטקסט נשאר בזמן שקבעתם גם כשמסדרים מחדש קטעי מקור; הוא אינו זז אוטומטית עם A/B בפעולת Ripple. כל פריט חייב להיכנס בתוך משך העריכה. אם קיצור הסרטון ישאיר טקסט מעבר לסוף החדש, הפעולה תידחה: קודם מקצרים, מזיזים או מסירים את הטקסט הרלוונטי.

### ייבוא SRT או VTT

בוחרים **Import SRT / VTT** וקובץ `.srt` או `.vtt` בקידוד UTF-8, בגודל של עד **1 MiB ‏(1,048,576 בתים)** ועם עד **2,000 מקטעי כתוביות**. הזמנים צריכים להתאים כבר לסרטון הערוך ולהיכנס בתוך משכו. הייבוא שומר טקסט ותזמון; גופנים, תגיות עיצוב ומיקומי VTT מוחלפים באפשרויות העיצוב של CUTROOM.

ברירת המחדל מוסיפה לכתוביות האישיות. מסמנים **Replace my existing custom captions when importing** כדי להחליף רק אותן; הכותרות ותמלול ה־AI נשארים. ייבוא לא תקין אינו משנה את הטקסט הקיים, ו־Undo מבטל ייבוא מוצלח בצעד אחד. פרויקט יכול להכיל עד 2,000 פריטי טקסט אישיים, עד 16 בו־זמנית ועד 1,000 תווים לפריט. פריטים באותו מיקום עלולים לכסות זה את זה, ולכן בודקים בתצוגה.

כותרות וכתוביות אישיות תמיד נצרבות בסרטון המיוצא. מתג ה־AI בשם **Burn into video** אינו מסתיר אותן. האפשרות **Export SRT file** משלבת כתוביות AI וכתוביות אישיות, ללא כותרות. כדי למנוע כתוביות כפולות בתמונה, כבו צריבת AI כשמשתמשים בכתוביות אישיות במקומן; הייבוא אינו מוחק את תמלול ה־AI או מוציא אותו מקובץ SRT כשייצוא זה מופעל. הכלים האלה אינם דורשים עיבוד AI או חשבון בתשלום.

### תיקון תמלול AI

מחפשים בתמלול או מסננים **All lines / In the edit / Removed**. לחיצה על שורה מנווטת אליה; Shift ולחיצה בוחרים פסקה. **Remove passage / Restore passage** משנים את הווידאו. תיקון מילים בלבד לא מסיר וידאו ולא מייצר דיבור חלופי.

עורכים ב־**Correct selected line**, ואז **Save text**. **Save all changes** שומר תיקונים ממתינים; **Discard changes** מבטל את התיקון הנוכחי שלא נשמר. בדקו Saved/Unsaved לפני סגירת הדפדפן—טקסט שלא נשמר אינו גיבוי.

ב־**AI subtitle style & speech language**:

- **Burn into video:** צריבת כתוביות AI לתמונה הסופית; טקסט אישי מופיע ללא תלות במתג הזה.
- **Export SRT file:** קובץ נפרד שניתן לעריכה, עם כתוביות AI וכתוביות אישיות, ללא כותרות.
- **Style / Position / Size:** מראה ומיקום; בדקו בעצמכם שהכתוביות לא מסתירות פנים, מידע או ממשק של הפלטפורמה.
- **Words per caption:** כמות מילים בכל מקטע כתוביות, לא שינוי התמלול עצמו.
- **Speech language:** שפת הדיבור לתמלול AI; עשויה לחייב בנייה מחדש ואינה שפת יעד לתרגום.

כתוביות AI עוקבות אחר התזמון הערוך ומקור האודיו. פרויקט ידני מתחיל בלי תמלול; הפעלת כתוביות לבדה לא מתמללת אותו. עדיין אפשר להקליד או לייבא כתוביות משלכם באזור שמעל.

בהקלטה שמשלבת עברית ואנגלית בחרו את שפת הדיבור העיקרית ובדקו שמות ומונחים באנגלית. במצב מקומי Balanced או Quality אפשר לבדוק שוב עד שתי יחידות חלשות, כל אחת עד 30 שניות, ועד 48 שניות אודיו במצטבר בכל מעבר מקומי, עם המודל שכבר נטען. Lite אינו מוסיף ניסיון כזה. בדיקות תזמון, ביטחון ואיות עשויות להשאיר את התוצאה המקורית. אין כאן תרגום או שכתוב דיבור בידי מודל הסיפור. אזהרת ביטחון נמוך מבקשת להאזין ולבדוק; היא אינה ציון דיוק מדוד, וגם זיהוי השפה האוטומטי עלול לטעות. [פרטי הבדיקה והמגבלות](QUALITY_AND_LIMITS.md)

## 9. מייצאים ומבינים מתי צריך לבנות מחדש

בראש העורך בוחרים **16:9 Landscape** או **9:16 Vertical** לשינוי פורמט בלחיצה, גם בעריכה ידנית. התצוגה מתעדכנת והפורמט נשמר אוטומטית לייצוא, בלי AI או בנייה מחדש ובלי לשנות חיתוכים. אם צריך למקם מחדש את המצולם, משתמשים ב־**Layout → Clip framing**.

בוחרים **Aspect ratio**: ‏9:16, ‏16:9, ‏1:1, ‏4:5 או Source; **Resolution**: ‏720p, ‏1080p, ‏QHD 1440p או 4K 2160p; **Frame rate**: ‏24/25/30/50/60 FPS; ו־**Export quality**. הגדרות גבוהות עשויות להגדיל זמן עיבוד, שימוש בזיכרון וגודל קובץ. רזולוציה גבוהה לא משחזרת פרטים שחסרים במקור. 60 FPS משתמש בקצב גבוה אם הוא קיים במקור; מקור איטי יותר משכפל פריימים, לא מקבל תנועה חדשה מ־AI.

הגדרות עם סימון **Draft rebuild** משנות החלטות עריכה ודורשות **Rebuild Draft**. זו פעולת טיוטה חדשה, לא רענון תצוגה: שמרו תיקוני תמלול ובדקו את התוצאה אחרי הבנייה. שינוי פורמט או עיצוב כתוביות אינו דורש בניית סיפור מחדש. **Performance mode** משנה בחירות AI, לא את איכות קידוד ה־MP4. **Smart editorial effects** מוסיף הדגשות מוגבלות; **Final loudness balance** מאזן עוצמות בפלט.

לוחצים **Export**, בודקים סיכום ואז **Start export**. הייצוא משתמש במקורות ולא בתצוגות המקדימות המוקטנות. **Stop process** מבטל ייצוא; סגירת החלון לבדה אינה מבטלת. בסיום בוחרים **Download video** ושומרים. לפני פרסום צופים בקובץ מחוץ לאפליקציה ובודקים התחלה, סיום, חיתוכים, כתוביות, סנכרון ופורמט.

## 10. שומרים, מתאוששים ומדווחים

הפרויקטים נשמרים במחשב שמפעיל את CUTROOM, לא בחשבון ענן. כברירת מחדל, פרויקטים וחומר שהוסף נמצאים ב־`data/projects`, ייצוא ב־`data/exports` ומטמונים ב־`data/cache`. שמרו גיבויים. אין למחוק תיקיות אלה כפתרון כללי. כשמתכוונים למחוק פרויקט ואת העותקים המיובאים וקובצי הייצוא שלו, משתמשים ב־**Delete** ובאישור שבמסך הכניסה או ב־Projects; קובצי המקור שמחוץ ל־CUTROOM נשארים ללא שינוי.

סגירת הדפדפן אינה עוצרת את התוכנה. שמרו טקסט, המתינו לחיווי השמירה וסיימו או בטלו תהליכים לפני סגירת חלון ההפעלה. מטמוני מודלים יכולים להימצא מחוץ לתיקיית התוכנה. [התקנה, לוגים ושחזור](TEST_ON_ANOTHER_PC.md)

| בעיה | מה בודקים קודם |
| --- | --- |
| מודל חסר | מוכנות מקומית והשלמת ההורדה הנקובה; אפשר לבחור Manual edit |
| שגיאת מפתח/מכסת ענן | חשבון הספק והמכסה; אין מעבר אוטומטי לתשלום |
| תמלול לא טוב | מקור אודיו, שפת דיבור וההקלטה עצמה; אחר כך מודל או תיקון ידני |
| פריסה שגויה | תפקידי מקורות, טווח שנבחר, יחס הפלט ו־Fill לעומת Fit |
| חוסר סנכרון או אזור שחור | סנכרון, אורכי המקורות ורווחים בערוצים עצמאיים |
| ערוץ נעול / Undo נדחה | פתחו Edit → Track protection ושחררו את הערוץ הרלוונטי, או בחרו במקור האחר לעריכה עצמאית |
| נדרשת בנייה מחדש | שמירת טקסט ובנייה מחדש אחרי שינוי הגדרות עריכה |
| טקסט מונע קיצור של העריכה | מקצרים, מזיזים או מסירים טקסט שיישאר מעבר לסוף החדש; הטקסט אינו זז אוטומטית |

דווחו פעולה ושגיאה מדויקות, שם גרסה, משך ושפת חומר הגלם וצילום מצונזר באמצעות [טופס המשוב](BETA_FEEDBACK.md). אל תצרפו מפתחות API או תיקיית `data` פרטית שלמה. הבטא אינה מאושרת לכל מחשב, שפה או סוג חומר; [המגבלות](BETA_STATUS.md) מבחינות בין בדיקות אוטומטיות לבדיקות בעולם האמיתי.


### אורך העריכה
בחרו **Highlight sequence** לרצף קטעים רלוונטיים ששואף לאורך המבוקש. **Follow style** שומר את תקרת הרגעים של הסגנון: Competitive Clutch שומר אירוע יחיד. היעד מקורב; לא חוזרים על חומר ולא מוסיפים קטעים לא רלוונטיים כדי למלא זמן. בדקו הודעות על טיוטה קצרה וטווחי מקור. בחירה על בסיס קול מזהה פעילות, לא משמעות של קרב. בפרויקטים קיימים נשמרת מגבלת הסגנון עד שינוי הבחירה.