FAQ (자주 묻는 질문)¶
VoiceScriptPlayer는 아직 개발 중인 프로그램입니다.
아래 내용은 정식 출시 전에 자주 예상되는 질문들을 미리 정리한 것입니다.
🧩 프로젝트 / 파일 관리¶
Q. 프로젝트 파일은 어디에 저장되나요?
A. 기본적으로 내 문서 / VoiceScriptPlayer / Projects 폴더에 저장됩니다.
원하는 경로를 지정해 새로운 프로젝트를 만들 수도 있습니다.
Q. 기존 프로젝트를 다른 컴퓨터로 옮기려면 어떻게 하나요?
A. 프로젝트 폴더 전체를 복사하면 옮길 수 있습니다.
Q. ‘템플릿 프로젝트’는 무엇인가요?
A. VoiceScriptPlayer에서 제공하는 기본 샘플 프로젝트입니다.
간단한 예시 스크립트와 설정이 포함되어 있으며, 직접 수정하여 새로운 프로젝트를 만들 수 있습니다.
🎧 오디오 / 자막¶
Q. Whisper를 이용한 자막 생성이 잘 안 됩니다.
A. Whisper 모델이 다운로드되어 있는지 확인하고, 설정에서 올바른 경로를 지정하세요.
GPU가 없는 환경에서는 처리 속도가 느릴 수 있습니다.
참고로 일반적인 처리 속도는 다음과 같습니다:
| 환경 | 모델 | 10분 영상 처리 시간(대략) |
|---|---|---|
| CPU (일반 데스크탑 i5/i7급) | base |
약 7~10분 |
| CPU (저사양 노트북) | base |
약 12~15분 |
| GPU (RTX 3060 이상) | base |
약 1~2분 |
| GPU (RTX 4090 등 고성능) | large |
약 30초~1분 |
⚡ 모델 크기가 커질수록 정확도는 올라가지만 처리 속도는 느려집니다.
Whisper는 오프라인에서도 작동하므로, 첫 변환 후에는 네트워크 연결이 필요 없습니다.
Q. 자막 파일은 어떤 형식으로 내보낼 수 있나요?
A. .srt 형식으로 저장됩니다.
번역된 자막도 별도의 파일로 저장할 수 있습니다.
Q. 자막이 화면에 보이지 않습니다.
A. 자막 표시 기능이 꺼져 있거나, UI가 자막을 가린 상황입니다.
UI의 자막 뒤로 보내기 설정을 활성화하세요.
🤖 AI / 번역¶
Q. DeepL이나 LibreTranslate API 키는 어디서 설정하나요?
A. 환경설정 → AI 탭에서 각 엔진의 API 키를 입력할 수 있습니다.
API 키는 서비스 제공 사이트(DeepL, LibreTranslate 등)에서 직접 발급받아야 합니다.
Q. 오프라인에서도 AI 기능이 작동하나요?
A. Whisper, COEIROINK, Hailuo 일부 엔진은 로컬 환경에서 작동합니다.
하지만 DeepL, Meta AI 등은 인터넷 연결이 필요합니다.
Q. Whisper 모델은 어디서 다운로드할 수 있나요?
A. VoiceScriptPlayer 내에서 자동으로 Whisper 모델을 다운로드할 수 있습니다.
환경설정의 AI / Whisper 탭에서 원하는 모델 크기(tiny, base, small, medium, large)를 선택하면
자동으로 다운로드 및 적용이 이루어집니다.
직접 다운로드를 원할 경우, Whisper.cpp 모델 페이지에서도
동일한 모델 파일을 수동으로 받을 수 있습니다.
🎮 이벤트 / 인터랙션¶
Q. Interactive Event는 무엇인가요?
A. 사용자의 입력(키보드, 버튼, 스크립트 트리거 등)에 따라
오디오, 영상, 디바이스 제어 등이 동시에 실행되는 이벤트 시스템입니다.
Q. Stroke나 Trigger 이벤트는 어떻게 연결하나요?
A. 프로젝트의 타임라인 또는 이벤트 패널에서 각 이벤트를 선택 후,
조건(입력 키, 타이밍 등)을 지정해 연결할 수 있습니다.
⚙️ 설정 / 오류¶
Q. 설정이 저장되지 않습니다.
A. VoiceScriptPlayer는 종료 시 자동으로 설정 파일(Option.json)을 저장합니다.
프로그램이 정상적으로 종료되지 않으면 설정이 저장되지 않습니다.
Q. 로그 파일은 어디에 있나요?
A. 내 문서 / VoiceScriptPlayer / Log 폴더 안에서 날짜별로 생성됩니다.
오류나 예외 발생 시 해당 로그를 참조하세요.
Q. 프로그램 실행 시 ‘파일을 찾을 수 없습니다’라는 오류가 납니다.
A. 프로젝트에서 참조하는 리소스(음성, 이미지 등)가 삭제되었을 수 있습니다.
경로를 다시 지정하거나 리소스를 복구하세요.
🚀 배포 / 공유¶
Q. 다른 사람에게 프로젝트를 공유할 수 있나요?
A. 예. 프로젝트를 내보내면 상대방이 VoiceScriptPlayer Stub을 통해 실행할 수 있습니다.
Q. ‘Stub Player’는 무엇인가요?
A. 편집 기능 없이 실행만 가능한 배포용 플레이어입니다.
Q. 배포를 했을 경우 다른 사람이 수정할 수 있나요?
A. 네. 배포된 프로그램은 편집이 불가능하도록 되어 있지만,
암호화된 구조는 아니기 때문에 파일을 변형하면 수정이 가능합니다.
Q. Patreon이나 GitHub Release와 연동할 수 있나요?
A. 정식 버전에서는 Patreon 및 GitHub 연동을 지원할 예정입니다.
(예: 후원자 전용 템플릿 제공, 자동 업데이트 등)
💡 기타¶
Q. 어떤 시스템 환경에서 실행할 수 있나요?
A. Windows 10 이상 / .NET 8 Runtime 필요 / 기본 RAM 8GB 이상을 권장합니다.
Q. VoiceScriptPlayer는 무료인가요?
A. 기본 기능은 무료로 제공되며, 일부 AI 연동 기능은 별도 API 키나 후원자 전용 기능으로 제공될 예정입니다.
Q. 모바일 버전도 있나요?
A. 현재는 Windows 전용이며, 모바일 버전은 계획 중입니다.