Skip to content

README_KO.md

Latest commit

 

History

History
276 lines (227 loc) · 10.7 KB

README_KO.md

File metadata and controls

276 lines (227 loc) · 10.7 KB

ScriptPlayer+ 아이콘

ScriptPlayer+

로컬 펀스크립트 재생을 위한 모던 데스크톱 플레이어. The Handy 동기화, Intiface / Buttplug 다축 라우팅, FunOSR 시리얼 지원, 인앱 EroScripts 탐색, 그리고 실제로 쓰기 편한 미디어 라이브러리 UI를 제공합니다.

Latest Release Downloads Platforms License

최신 버전 다운로드 · 개요 데모 보기 · English · 日本語 · 中文

ScriptPlayer+ 개요 데모

상단 히어로 이미지와 아래 데모 카드를 누르면 짧은 제품 영상을 바로 열 수 있습니다.

왜 ScriptPlayer+인가

ScriptPlayer+는 이미 로컬 미디어와 스크립트를 갖고 있지만, 여기저기 덧붙인 느낌이 아니라 지금 기준으로도 쓸 만한 플레이어를 원하는 사람을 위한 앱입니다. 핵심은 단순합니다. 더 깔끔한 재생 경험, 더 정리된 디바이스 제어, 덜 번거로운 라이브러리 워크플로우입니다.

재생 중심 UI
전체화면 재생, 타임라인과 히트맵 오버레이, 자막, 오디오 아트워크 모드, 빠른 스트로크 조절까지 메뉴를 뒤지지 않고 바로 접근할 수 있습니다. 		확장되는 디바이스 지원
The Handy, Intiface / Buttplug 장치, FunOSR 시리얼 출력을 하나의 앱 안에서 다루고, 장치별 라우팅과 다축 스크립트까지 처리합니다. 		시간 낭비를 줄이는 라이브러리
폴더 탐색, 스크립트와 자막 감지, 호버 비디오 프리뷰, 정렬, EroScripts 검색, 수동 오버라이드까지 기본으로 들어 있습니다.

제품 투어

개요 데모 비디오 프리뷰 데모 랜덤 스트로크 데모
개요 데모
현재 플레이어 화면, 재생 레이아웃, 디바이스 흐름을 짧은 영상으로 확인할 수 있습니다. 		비디오 프리뷰 데모
파일을 열기 전에 리스트에서 바로 호버 프리뷰가 어떻게 동작하는지 보여줍니다. 		랜덤 스트로크 데모
스크립트가 없는 미디어에서 랜덤 스트로크 생성 기능이 어떻게 쓰이는지 확인할 수 있습니다.

기능 미리보기

스크립트 변형 패널 패턴 프리셋 데모
스크립트 변형 패널
하나의 미디어에 맞는 스크립트 번들이 여러 개 있으면 사이드바에서 기본 스크립트와 Soft 같은 변형을 바로 바꿔 쓸 수 있습니다. 		패턴 프리셋 데모
랜덤 폴백 스트로크의 프리셋 이름을 다시 정리해 기본 애태우기와 더 강한 프리셋이 겹치지 않게 했고, 새 짧은 영상으로 그 흐름을 보여줍니다.

앱 내부 화면

디바이스 설정 키보드 단축키
디바이스 라우팅과 매핑
Handy, Buttplug, 시리얼 동작을 여러 툴로 나눠 설정하지 않고 한곳에서 관리할 수 있습니다. 		키보드 중심 제어
재생, 탐색, 전체화면, 파일 이동까지 모두 단축키 중심으로 다룰 수 있습니다.

주요 기능

재생과 라이브러리

  • 로컬 영상 파일 재생: MP4, MKV, AVI, WebM, MOV, WMV
  • 로컬 오디오 파일 재생: MP3, WAV, FLAC, M4A, AAC, OGG, OPUS, WMA
  • 번들 펀스크립트 자동 감지, 별도 스크립트 폴더 지원, 고유하게 매칭되는 폴백 스크립트 자동 선택
  • 여러 스크립트 번들이 잡히는 미디어용 빠른 스크립트 변형 패널
  • 외부 자막 파일 자동 감지 및 수동 자막 불러오기 지원
  • 파일 리스트에서 호버 비디오 프리뷰 제공
  • 경로, 파일명, 수정 시간 기준 정렬 지원
  • 현재 미디어 반복, 자동 다음 재생, 랜덤 재생, 재생 속도 조절을 분리해서 제공
  • 드래그 앤 드롭으로 미디어 바로 열기 지원
  • 오디오 재생 시 같은 폴더의 커버 아트 자동 선택

스크립트 시각화와 제어

  • 창 크기와 표시 구간을 조절할 수 있는 실시간 스크롤 타임라인
  • 속도 기반 색상 시각화를 적용한 전체 미디어 히트맵
  • 재생바에서 바로 조절하는 빠른 STR 스트로크 컨트롤
  • 스트로크 최소값 / 최대값 조절과 반전 토글
  • 스크립트가 없는 미디어용 랜덤 폴백 스트로크 생성
  • 비어 있는 긴 구간을 자동으로 건너뛰는 스크립트 갭 스킵
  • 다축 펀스크립트 번들 로딩 및 축별 라우팅

디바이스와 스크립트 소스

  • The Handy 업로드, 세팅, 시간 오프셋을 포함한 동기화 지원
  • Intiface / Buttplug 선형, 회전, 스칼라 피처에 대한 다축 매핑 지원
  • FunOSR 시리얼 / COM 출력과 갱신 주기 조절 지원
  • 인앱 EroScripts 로그인, 탐색, 검색, 다운로드 지원
  • 로컬 머신 기준 EroScripts 로그인 세션 유지

v0.1.9 변경점

  • Handy 재생 시작 안정성을 높였습니다. 재생 전에 HSSP 모드로 다시 전환하고, 핑 기준 여유 시간을 반영하며, 400 응답이 오면 서버 시간을 다시 맞춘 뒤 한 번 더 재시도하고, 오래된 업로드/재생 요청은 취소합니다.
  • Handy 업로드와 동기화가 끝나면 미디어를 바로 시작하는 Handy 동기화 후 자동 재생 옵션을 추가했습니다.
  • 두 개 이상의 축이 감지된 항목만 빠르게 찾을 수 있도록 사이드바에 다축 전용 필터를 추가했습니다.
  • 플레이어에 스트로크 범위 단축키 바인딩과 간단한 재생 속도 증감 / 프리셋 팝오버를 추가했습니다.
  • Handy가 연결된 상태에서 파일을 열거나 드롭하거나 다른 미디어로 넘길 때 자동 재생과 미디어 준비 처리를 더 안정적으로 다듬었습니다.

다운로드

플랫폼 패키지 비고
Windows x64 최신 릴리스 압축 해제 후 ScriptPlayerPlus.exe 실행
macOS x64 / arm64 최신 릴리스 ZIP 압축 해제 후 ScriptPlayerPlus.app을 Applications로 이동
Linux x64 최신 릴리스 태그 릴리스마다 AppImage를 함께 배포

지원 파일 형식

유형 형식
미디어 mp4, mkv, avi, webm, mov, wmv, mp3, wav, flac, m4a, aac, ogg, opus, wma
스크립트 .funscript, .json, .csv
외부 자막 .srt, .vtt, .txt

현재 참고 사항

  • 영상 컨테이너 내부의 내장 자막 트랙은 아직 파싱하지 않습니다. 현재는 외부 자막 파일을 사용해야 합니다.
  • Linux 릴리스는 현재 x64 AppImage 중심으로 배포합니다.
  • 일본어와 중국어 현지화 README는 아직 이 문서 수준까지 동일하게 정리되지 않았습니다.

소스에서 빌드

Node.js 20.x를 사용하세요. 프로젝트 기준 버전은 .nvmrc의 20.20.2입니다.

git clone https://github.com/sioaeko/scriptplayer-plus.git
cd scriptplayer-plus
npm install

개발 모드 실행:

npm run electron:dev

Windows 빌드:

npm run build:win

macOS 빌드:

npm run build:mac

Linux 빌드:

npm run build:linux

키보드 단축키

키 동작
Space / K 재생 / 일시정지
Left / Right -5초 / +5초 이동
Shift + Left / Right -10초 / +10초 이동
Up / Down 볼륨 +5% / -5%
F 전체화면 전환
M 음소거 전환
Ctrl + , 설정 열기

기술 스택

  • Electron
  • React
  • TypeScript
  • Tailwind CSS
  • Vite

라이선스

ScriptPlayer+ End User License Agreement

ScriptPlayer+는 LICENSE에 명시된 EULA 조건으로 배포되는 독점 소프트웨어입니다. 상업적 사용, 재배포, 수정, 프로젝트 미디어 재사용에는 저작권자의 별도 서면 허가가 필요합니다.