> ## 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를 오프라인으로 사용하기

> 완료된 카라오케 내보내기 파일을 기기에 보관하고 인터넷 연결 없이 재생하세요.

Youka Desktop과 Youka Extension은 Youka Online과 동일한 **Library** 페이지를 사용합니다. 카라오케는 **Available online**, **Available offline**, 또는 **Available online and offline**로 표시될 수 있습니다.

오프라인 액세스는 완료된 카라오케 비디오 내보내기(export)에 적용됩니다. 프로젝트, 원본 미디어, 스템(stems), 편집기 설정은 온라인 전용으로 유지됩니다.

## 오프라인으로 전환하기 전에

1. 인터넷에 연결된 상태에서 Youka Desktop 또는 Youka extension을 여세요.
2. 로그인한 뒤 **Library**를 한 번 열어 보세요. 이렇게 하면 현재 Youka 버전에 맞게 오프라인 페이지가 준비됩니다.
3. 비디오 저장 방식을 선택하세요:
   * **Make Library Available Offline**을 선택하면 지금 모든 해당 내보내기 파일을 다운로드합니다.
   * **Automatic Offline Saving**을 켜면 앞으로 새로 생성되는 해당 내보내기 파일이 자동으로 저장됩니다.
   * 자동 저장을 끄면 개별 비디오에서 **Make available offline**을 선택해 저장할 수 있습니다.
4. 연결을 끊기 전에 각 비디오가 **Available offline**으로 표시될 때까지 기다리세요.

Youka는 마지막으로 인증된 로컬 프로필을 기억하지만, 오프라인 라이브러리에 Clerk 로그인 토큰은 저장하지 않습니다. 온라인 세션이 만료된 상태라면 다시 연결했을 때 다시 로그인하세요.

## 새 내보내기 파일 저장 위치 선택

Library 페이지에서 **Save new Karaokes to**를 선택해 Youka 폴더를 지정하세요. 새 로컬 내보내기 파일은 해당 폴더 안에 Project 및 Export ID 기준으로 저장됩니다. 기존 내보내기 파일은 이동되지 않습니다.

기본적으로 관리되는 파일과 로컬 `db.json` 인덱스는 `Videos/Youka` 아래에 저장됩니다. 이 인덱스는 Library 로딩을 빠르게 해주며, 각 Export에는 자체 manifest도 있어 Youka가 비디오 메타데이터를 스캔하지 않고도 인덱스를 다시 생성할 수 있습니다.

이전에 다른 드라이브나 폴더를 선택했다면 **Add existing Youka folder**를 사용하세요. Youka는 유효한 관리형 Export 폴더만 인덱싱하며, 관련 없는 비디오는 가져오지 않습니다.

## 오프라인에서 재생하기

Youka Desktop 또는 Youka extension에서 **Library**를 여세요. **Available offline**으로 표시된 항목은 로컬 비디오를 자동으로 사용합니다. 온라인/오프라인 모두 동일한 플레이어, 큐, 재생 컨트롤이 사용됩니다.

Youka Desktop 또는 Youka extension을 열린 상태로 유지하세요. 어떤 작업이 연결되지 않는다면 앱이 실행 중인지 확인하고 다시 시도하세요.

## 오프라인 Export를 온라인에서 사용할 수 있게 만들기

로컬 전용 Export의 경우 **Make available online**을 선택하세요. Youka는 중단 후에도 완료된 업로드 파트를 이어서 진행하며, 내보내기 크레딧을 차감하지 않고 온라인 Library 비디오 1개를 생성합니다.

원래의 클라우드 Project가 여전히 존재해야 합니다. 삭제된 경우 로컬 카라오케는 계속 재생할 수 있으며, Youka가 업로드할 수 없는 이유를 안내합니다.

## 오프라인 사본 삭제

Youka는 오프라인 파일을 자동으로 제거하지 않으며, 일괄 삭제 기능도 제공하지 않습니다.

사본 하나를 제거하려면 해당 Library 항목의 메뉴를 열고 **Delete offline copy**를 선택한 다음, 정확한 Export를 확인하세요. 이렇게 하면 선택한 기기에서 해당 Export만 영구적으로 제거됩니다. 온라인 사본은 별도로 삭제하지 않는 한 계속 사용할 수 있습니다.

중단된 다운로드와 렌더는 보존됩니다. 다시 시도하거나, 해당 폴더를 열거나, 그 미완료 Export 하나를 명시적으로 삭제할 수 있습니다.