> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Youka 확장 프로그램

> 브라우저에서 데스크톱 기능을 잠금 해제하세요: 비디오 URL로 생성, 가사 검색, 로컬로 내보내기

Youka 확장 프로그램은 강력한 데스크톱 기능을 브라우저로 가져와 비디오 URL에서 카라오케를 생성하고, 가사를 자동으로 검색하며, 영상을 로컬로 내보낼 수 있게 해줍니다. 로컬 내보내기는 무료이며, 클라우드 내보내기는 계속 크레딧을 사용합니다.

## 제공 기능

Youka 확장 프로그램을 설치하면 다음 3가지 주요 기능을 사용할 수 있습니다:

* **비디오 URL로 생성** — 비디오 링크에서 직접 다운로드하고 카라오케 생성
* **온라인 가사 검색** — 인터넷에서 가사를 자동으로 찾아 가져오기
* **무료 로컬 내보내기** — 클라우드 크레딧을 사용하지 않고 내 컴퓨터에서 로컬로 영상 렌더링

## 설치

### 확장 프로그램 다운로드

1. [확장 프로그램 다운로드 페이지](/extension)로 이동합니다
2. 사용 중인 운영 체제(Windows, macOS, Linux)에 맞는 다운로드 버튼을 클릭합니다
3. 설치 프로그램을 실행하고 안내에 따라 설정을 완료합니다
4. 확장 프로그램은 시스템 트레이에서 실행됩니다(작은 아이콘이 표시됩니다)

### 브라우저에 연결

설치가 완료되면 Youka Online에 접속할 때 확장 프로그램이 자동으로 연결됩니다:

1. 브라우저에서 [online.youka.io](https://online.youka.io)를 엽니다
2. 오른쪽 상단의 확장 프로그램 표시를 확인합니다("Connected"라고 표시되어야 합니다)
3. 이제 모든 확장 프로그램 기능을 사용할 준비가 끝났습니다!

## 비디오 URL로 카라오케 생성하기

파일을 업로드하는 대신, 이제 비디오 링크에서 바로 카라오케를 생성할 수 있습니다:

1. 홈 페이지에서 **Create Karaoke**를 클릭합니다
2. **From URL** 탭을 선택합니다
3. 선호하는 스트리밍 플랫폼의 비디오 URL을 붙여넣습니다
4. **Download**를 클릭합니다
5. 확장 프로그램이 비디오를 다운로드하고 오디오를 추출합니다
6. 이후 과정은 평소처럼 가사를 진행하면 됩니다

**참고**: 이 기능을 사용하기 전에 확장 프로그램이 실행 중이며 연결되어 있는지 확인하세요.

## 가사 자동 검색

카라오케에 가사를 추가할 때, 확장 프로그램이 인터넷에서 가사를 대신 검색해줄 수 있습니다:

1. 가사 입력 영역에 **Search** 버튼이 표시됩니다(확장 프로그램이 연결되어 있을 때만 보입니다)
2. **Search**를 클릭하면 곡 제목을 기반으로 가사가 자동으로 검색됩니다
3. 가사가 발견되면 텍스트 영역으로 가져와집니다
4. 필요에 따라 편집하거나 조정합니다

이 기능을 사용하면 다른 사이트에서 가사를 직접 검색하고 복사해 붙여넣는 번거로움을 줄일 수 있습니다.

## 무료 로컬 내보내기

클라우드 크레딧을 사용하지 않고 카라오케 영상을 로컬로 내보낼 수 있습니다. 클라우드 내보내기는 계속 크레딧을 사용합니다:

1. Studio 편집기에서 프로젝트를 엽니다
2. **Export**를 클릭해 내보내기 대화상자를 엽니다
3. 두 가지 내보내기 옵션이 표시됩니다:
   * **Cloud Export** — 크레딧 사용, 클라우드에서 렌더링
   * **Local Export** — 무료, 내 컴퓨터에서 렌더링(확장 프로그램 필요)
4. **Local Export**를 선택합니다
5. 내보내기 설정을 선택하세요 (resolution, quality, FPS, transparency)
6. **Start Export**를 클릭합니다
7. 확장 프로그램이 로컬에서 영상을 렌더링하고 컴퓨터에 저장합니다

**로컬 내보내기의 장점:**

* 완전 무료 — 크레딧이 필요 없음
* 무제한 내보내기
* 파일이 내 컴퓨터에 그대로 유지됨
* 출력 저장 위치를 완전히 제어 가능

## 문제 해결

### 확장 프로그램이 연결되지 않음

확장 프로그램이 자동으로 연결되지 않는다면:

1. 확장 프로그램이 실행 중인지 확인합니다(시스템 트레이 확인)
2. 확장 프로그램 앱을 재시작합니다
3. 브라우저 페이지를 새로고침합니다
4. 지원되는 브라우저(Chrome, Edge, Firefox)를 사용 중인지 확인합니다

### 다운로드 실패

비디오 다운로드에 실패한다면:

1. URL이 올바른 비디오 링크인지 확인합니다
2. 비디오가 공개 상태인지 확인합니다(비공개/연령 제한 아님)
3. 다른 비디오로 테스트해 봅니다
4. 확장 프로그램을 최신 버전으로 업데이트합니다

### 내보내기가 너무 오래 걸림

로컬 내보내기는 컴퓨터에서 렌더링되므로 속도는 다음 요소에 따라 달라집니다:

* CPU/GPU 성능
* 비디오 길이와 해상도
* 내보내기 품질 설정

더 빠르게 내보내려면 해상도 또는 품질 설정을 낮춰 보세요.

## 시스템 요구 사항

* **운영 체제**: Windows 10+, macOS 10.15+, 또는 Linux (Ubuntu 20.04+)
* **메모리**: 최소 4GB RAM, 권장 8GB+
* **저장 공간**: 확장 프로그램용 500MB, 추가로 비디오 파일 저장 공간 필요
* **인터넷**: 비디오 다운로드 및 가사 검색에 필요

## 개인정보 보호 및 보안

Youka 확장 프로그램은:

* 컴퓨터에서 로컬로 실행됩니다
* 웹 앱을 사용하는 동안에만 Youka Online에 연결됩니다
* 개인 데이터를 수집하거나 전송하지 않습니다
* 다운로드는 사용자 컴퓨터에서 처리됩니다
* 내보내기 파일은 컴퓨터에 저장되며 업로드되지 않습니다(절대 업로드되지 않음)

## 업데이트

확장 프로그램은 시작 시 자동으로 업데이트를 확인합니다. 수동으로 업데이트하려면:

1. [확장 프로그램 다운로드 페이지](/extension)에서 최신 버전을 다운로드합니다
2. 새 설치 프로그램을 실행합니다(기존 설치를 업데이트합니다)
3. 확장 프로그램을 재시작합니다

## 도움 받기

문제가 발생하면:

* 위의 [문제 해결 섹션](#troubleshooting)을 확인하세요
* [support@youka.io](mailto:support@youka.io)로 이메일을 보내주세요