# 자막 편집기
{% hint style="info" icon="bullhorn" %}
## **새로운 Kollus Docs 사이트에서 이 문서의 최신 버전을 확인하세요!**
본 문서는 **구버전**이며, 더 정확하고 최신화된 정보는 아래 신규 경로에서 확인하실 수 있습니다.
* **신규 문서**: [자막 편집](https://docs.kollus.com/service-guide/vod/content/subtitle/#%EC%9E%90%EB%A7%89-%ED%8E%B8%EC%A7%91)
* **게시 중단 안내**: 본 문서는 **2026년 6월 30일**까지만 제공됩니다.
{% endhint %}
이 페이지에서는 자동 생성된 AI자막과 직접 업로드한 자막을 편집할 수 있는 자막 편집기 기능에 대해 안내합니다.
### 이용 조건
자막 편집기는 다음 두 가지 경우에 이용할 수 있습니다.
* 콘텐츠에 AI자막이 생성되어 있는 경우
* SRT 형식의 자막 파일이 업로드되어 있는 경우
### 화면 구성 및 플레이어 기능
자막 편집기 화면 구성
#### **기본 정보 표시**
좌측 최상단에서 자막 제목, 언어, 유형, 공개 여부 등 자막의 기본 정보를 확인할 수 있습니다.
#### **플레이어 제어 및 자막 표시**
* **기본 제어:** 재생/일시정지, 이동, 속도 및 볼륨 조절 등 Kollus Player의 기본 기능을 지원합니다.
* **동기화:** 재생 위치 표시 막대(Seek bar) 이동 시, 좌측 자막 블록의 포커스도 함께 이동하여 편리하게 편집할 수 있습니다.
* **자막 표시 제한:** 편집 중인 자막만 화면에 표시됩니다. (메인/서브 자막이 섞여 있어도 편집 대상만 노출)
{% hint style="warning" %}
**주의**
편집 중인 자막이 **서브 자막**일 경우에도 플레이어 상에서는 메인 자막 위치에 표시되어 시각적 구분이 어려울 수 있습니다.
{% endhint %}
#### **비활성화 콘텐츠 편집 지원**
콘텐츠가 '비활성화(일시적 노출 제한)' 상태여서 엔드유저 화면에서 재생이 제한된 경우라도, **자막 편집기 내에서는 정상적으로 재생 및 편집이 가능**합니다.
### 자막 편집 주요 기능
#### **자막 텍스트 편집 및 줄 수 제한**
각 자막 블록의 텍스트와 타임코드(시작·종료)를 수정할 수 있습니다. 긴 문장은 잘릴 수 있으므로 **최대 2줄 이내** 작성을 권장합니다. (플레이어 정책상 서브 자막은 최대 2줄까지만 표시됩니다.)
#### **입력 시 일시정지(편의 기능)**
플레이어 하단에서 이 기능을 활성화하면, 자막 블록을 클릭(입력 시도)할 때 콘텐츠 재생이 자동으로 멈춥니다. 타이밍을 놓치지 않고 텍스트를 수정할 수 있습니다.
#### **찾기 및 바꾸기**
특정 키워드를 검색하거나, 전체 블록의 단어를 일괄 수정할 수 있습니다. 자막의 일부 텍스트를 드래그하면 '찾아 바꾸기' 메뉴가 나타나 반복 작업을 효율적으로 처리할 수 있습니다.
자막 일부를 드래그하면 '찾아 바꾸기' 메뉴가 표시됩니다.
### 데이터 교정 및 저장(중요)
#### **자막 내 빈 줄 자동 교정**
자막 내용에 불필요한 빈 줄이 포함되면 자막이 정상적으로 표시되지 않을 수 있어, 시스템이 이를 자동으로 교정합니다.
* **입력 도중:** 입력창 바깥으로 포커스 아웃(Focus Out)하면 빈 줄이 즉시 삭제되며, "빈 줄은 입력할 수 없어 자동으로 정리되었습니다." 알림 팝업이 표시됩니다.
* **저장 시:** \[편집 완료] 버튼 클릭 시, 모든 빈 줄을 정리한 후 안전하게 저장합니다.
#### **자동 저장 및 복원**
* **자동 저장(임시 저장):** 1분 단위로 작업 내용이 브라우저에 임시 저장됩니다. 비정상 종료 시 다시 접속하면 마지막 자동 저장 시점으로 복원됩니다.
* **최종 저장(필수):** 자동 저장은 임시 저장 기능입니다. 실제 DB 및 SRT 파일에 반영하려면 반드시 **\[편집 완료]** 버튼을 클릭해야 합니다. 클릭 즉시 콘텐츠에 자막이 적용됩니다.
### 의견 보내기
자막편집기 우측 하단 버튼을 통해 AI자막 정확도, 기능 제안 등 의견을 자유롭게 보내주세요. 수집된 의견은 기능 개선에 적극 반영됩니다.
{% hint style="success" %}
**만족도 설문 안내**
AI자막을 편집하고 저장하면 간단한 만족도 설문 팝업이 노출됩니다. 만족도는 1점(매우 불만족)에서 5점(매우 만족)까지 선택할 수 있으며, 글자 수 제한이 없는 의견 입력란이 제공됩니다. 설문 제출 시, 해당 팝업은 더 이상 노출되지 않습니다. 많은 참여 부탁드립니다.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://catenoid-support.gitbook.io/kollus-vod-console-v2/serviceguide/features/ai-subtitle/subtitle-editor.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.