🪐 StemHub Launcher 사용자 매뉴얼

StemHub는 Stem 브랜드의 모든 제품 (StemBox · StemPrism · VoicePrism)을 한 화면에서 설치·인증·실행·관리할 수 있는 통합 런처입니다.

1. 🚀 설치 및 시작

Stem 홈페이지에서 StemHub 받기 (Windows) 클릭
설치 파일 (StemHub_Setup_v*.exe) 실행
Windows SmartScreen 경고 시 "추가 정보 → 실행" 또는 운영자가 미리 사이닝 인증 받은 빌드를 사용 (향후 적용 예정)
설치 완료 → 자동으로 StemHub 실행
첫 화면에서 계정 만들기 또는 기존 계정으로 로그인

Microsoft Visual C++ 런타임이 자동 설치됩니다. 별도 설정 불필요.

버튼	위치	기능
이메일	폼 상단 입력 필드	가입한 이메일 또는 새로 가입할 이메일 입력
비밀번호	폼 중앙 입력 필드	8자 이상, 흔한 비밀번호 제외
로그인	하단 우측 (기본 모드)	입력한 이메일/비밀번호로 인증. 한 번 로그인하면 다시 묻지 않음.
계정 만들기	하단 좌측 (가입 모드 진입)	가입 모드로 전환. [필수] 개인정보처리방침/이용약관 동의 체크박스 + (선택) 마케팅 동의 표시됨.
비밀번호 재설정	하단 (모드 전환)	가입 이메일 입력 → 재설정 링크 이메일로 발송.
[필수] 개인정보처리방침 동의	가입 모드만 표시	체크 필수. PIPA 의무. 링크 클릭으로 정책 전문 새 창.
[필수] 이용약관 동의	가입 모드만 표시	체크 필수.
[선택] 마케팅 정보 수신 동의	가입 모드만 표시	선택. 신제품 안내 메일 수신 여부. 언제든 해제 가능.

로그인 후 좌측에 고정된 메뉴 5개:

메뉴	아이콘	기능
📚 내 라이브러리	책 아이콘	내 계정에 연결된 모든 라이선스를 카드로 표시. 가장 많이 사용.
🛒 스토어	카트 아이콘	구매 가능한 제품 카드. 클릭 시 결제 페이지.
💻 내 기기	PC 아이콘	내 계정으로 활성화된 모든 PC 목록. 사용 안 하는 PC 해제.
🔑 라이선스 등록	키 아이콘	오프라인 라이선스 키 / 타 계정에서 받은 라이선스 수동 등록.
⚙ 설정	톱니바퀴	HWID 복사, 데이터 폴더 열기, API 서버 변경 등.
로그아웃	사이드바 최하단	세션 종료. 다음 실행 시 로그인 화면.

각 제품 카드 우측에 상태에 맞는 액션 버튼이 표시됩니다:

상태	표시 버튼	동작
활성 + 미설치	📥 설치	이 PC에 자동 다운로드 + 설치. 진행 바 표시.
활성 + 설치됨 + 최신	🚀 실행	본 앱 실행. (실행 전 버전 게이트 자동 검증 — 오래된 버전이면 업데이트 모달)
활성 + 설치됨 + 신규 버전 있음	⬆ 업데이트 v{x}	클릭 시 최신 버전 자동 재설치.
다른 PC에 활성	이 PC로 가져오기	클릭 → 다른 PC 라이선스 자동 해제 + 이 PC에 활성화 (한 번에).
활성 안 됨 (구매했으나 미배정)	이 PC에 등록	이 PC에 라이선스 활성화.
활성 + 사용 중	키 반납	라이선스 비활성화. 보통 PC 교체 전에만 사용.
차단됨 (banned)	(회색, 클릭 불가)	운영자가 정지함. 문의하기.

💡 클릭 시 자동 진행: 각 버튼은 적절한 전체 절차를 한 번에 처리합니다. 라이선스 키 직접 입력 같은 수동 작업 거의 없음.

컬럼 / 버튼	기능
기기 이름	OS가 알려주는 컴퓨터 이름 (Hostname)
OS	Windows 10 / 11 / macOS 등
마지막 접속	가장 최근 verify 시각
앱 버전	마지막 verify에서 확인된 앱 버전
🗑 이 기기 해제	해당 기기에서 라이선스 비활성화. 그 PC에선 다음 실행 시 "라이선스 무효" 표시.

연간 기기 변경 한도: 영구 라이선스 기준 2회. 초과 시 문의하기.

컨트롤	기능
라이선스 키 입력 필드	XF7M-9KQA-PLZ2 형태의 OTK 코드 입력
인증하기	입력한 키로 활성화. 성공 시 라이브러리에 자동 추가.

대부분의 경우 구매 시 자동 처리되므로 이 메뉴는 평소 사용하지 않습니다.

컨트롤	기능
이메일 / 가입일 표시	본인 계정 정보 (읽기 전용)
하드웨어 ID (HWID)	이 PC의 고유 식별자
📋 복사 (HWID)	HWID를 클립보드에 복사. 운영자에게 보내 문제 진단용.
폴더 열기	`%APPDATA%/Stem/` 데이터 폴더를 탐색기로 열기. 토큰/캐시 위치.
API 서버	기본 `stem.dallago.me`. 개발/테스트용 변경 가능 (일반 사용자는 변경 X).
앱 버전 표시	현재 StemHub 버전

StemHub 실행 시 백그라운드에서 자동 확인:

세션 복원: 이전에 로그인했다면 자동 인증 시도 → 성공 시 라이브러리로 직행
버전 게이트: 서버에서 /api/launcher/version-check 호출 → 현재 버전이 너무 오래됐으면 필수 업데이트 모달 표시 (다른 화면 접근 불가)
레거시 동의 확인: 동의 플로 도입(2026-05) 이전 가입자면 재동의 모달 강제 표시
단일 인스턴스: 이미 실행 중인 StemHub가 있으면 그 창을 앞으로 가져오고 종료

StemHub 자체 + 각 데스크톱 앱 모두 두 단계 게이트로 보호됩니다:

단계	표시	동작
권장 (Recommended)	라이브러리 카드 상단 배너 `⬆ 업데이트 v{x}`	사용자 선택. 클릭 안 해도 계속 사용 가능.
필수 (Required)	전체 화면 차단 모달	클릭으로 자동 업데이트 → 재실행. 종료 외 다른 동작 불가.

증상	해결
인스톨러 실행이 안 됨	Windows 10/11 x64 PC인지 확인. SmartScreen 우회 (추가 정보 → 실행)
로그인 후 "필수 업데이트" 모달이 사라지지 않음	"지금 업데이트" 클릭. 다운로드+재실행 후 자동 해결
라이브러리가 비어있음	계정 이메일 확인. 구매 시 사용한 이메일과 같은지
"다른 PC 사용 중" 표시	이 PC로 가져오기 클릭 → 자동 해제 후 활성화
자동 업데이트가 안 됨	StemHub 종료 후 재실행. 서버 연결 상태 확인
StemBox/StemPrism 실행 시 "라이선스 무효"	StemHub 재로그인 → 라이브러리 새로고침
HWID 변경 한도 초과	연 2회 초과 시. 문의하기로 사유 안내
가입 시 동의 체크박스가 안 보임	가입 모드로 전환했는지 확인. 로그인 모드엔 표시 안 됨.
`📋 복사` 한 HWID가 안 붙여넣어짐	클립보드 권한. 다른 앱(메모장 등)으로 Ctrl+V 테스트

자주 묻는 질문은 StemHub FAQ에서 먼저 확인해 주세요.