Files
live-app-translator/src/livesub/config.py
EJClaw 0201c7b913
Some checks failed
Windows / verify (push) Has been cancelled
feat: 자막 배경 여백 · 위치 조정 모드 · CPU 추천 · 마이크 입력
요청 네 가지를 넣는다.

1) 자막 배경 여백(padding)
   배경 상자를 창 전체가 아니라 **글자를 감싸는 크기**로 그리도록 바꿨다.
   창 전체를 칠하던 동안에는 여백을 키워도 글자만 안으로 밀릴 뿐 배경
   크기는 그대로여서, 설정 항목을 만들어도 의미가 없었다.

2) 평소 잠금 + '자막 위치 조정'
   locked 기본값을 True 로 바꾼다. 게임 중에 자막을 실수로 끌고 다니는
   사고를 막는 쪽이 기본이어야 한다. 자막 화면의 버튼으로 조정 모드를
   열면 그때만 이동·네 모서리 크기 조절·휠이 열린다. 조정 중에는 클릭
   통과를 강제로 끈다 — 켜둔 채로는 마우스가 창을 지나가 잡을 수 없다.
   크기를 바꾸면 글자 크기가 높이 비율을 그대로 따라간다. 상자만 커지고
   글자가 그대로면 여백만 늘어나 '자막을 키우는' 조작이 되지 않는다.
   조정 모드는 저장하지 않는다. 다음 실행은 다시 잠긴 상태로 시작한다.

3) GPU 가 없을 때 CPU 추천
   티어 표의 recommended 는 GPU 가 넉넉할 때를 전제한 값이라, 그대로
   쓰면 GPU 없는 사람에게 10GB 짜리를 권하게 된다. 환경을 보고 고르는
   recommended_tier() 를 만들고 배지도 그 결과로 붙인다. GPU 가 없으면
   CTranslate2 계열만 후보에 두고 가장 가벼운 쪽을 권한다 — LLM 계열은
   CPU 에서 한 문장에 수십 초가 걸려 실시간 자막이 되지 않는다.
   '추천대로 맞추기' 버튼과, 실제로는 CPU 로 도는데 화면은 GPU 라고
   표시하던 것도 같이 고친다. nvidia-smi 실패 문구가 명령줄을 통째로
   토해내던 것도 사람이 읽을 문장으로 바꿨다.

4) 마이크 등 입력 장치 선택
   InputDeviceCapture 를 추가하고 홈 화면에 목록 전환 버튼을 둔다.
   두 목록을 한 번에 섞지 않는다 — 다 합치면 정작 찾으려던 게임이
   라인입력들 사이에 파묻힌다. 버튼 글자는 '지금 상태'가 아니라
   '누르면 가는 곳'을 적는다. 고른 쪽은 설정에 기억한다.
2026-09-29 13:27:13 +09:00

208 lines
7.6 KiB
Python

"""설정 모델과 JSON 영속화."""
from __future__ import annotations
import json
import logging
from dataclasses import asdict, dataclass, field, fields, is_dataclass
from pathlib import Path
from typing import Any
from .constants import DEFAULT_TIER, user_data_dir
log = logging.getLogger(__name__)
def config_path() -> Path:
"""설정 파일 경로.
import 시점에 상수로 계산하면 안 된다. 그때는 사용자가 저장 위치를 아직
고르지 않았고, 나중에 설정에서 위치를 바꿔도 옛 경로를 계속 가리킨다.
"""
return user_data_dir() / "config.json"
@dataclass
class SubtitleStyle:
"""자막 텍스트 표현 설정."""
font_family: str = "Pretendard"
font_size: int = 34
bold: bool = True
text_color: str = "#FFFFFF"
source_text_color: str = "#9AA4B2"
outline_color: str = "#000000"
outline_width: int = 3
background_color: str = "#000000"
background_opacity: int = 55 # 0-100
#: 글자와 배경 상자 가장자리 사이 여백. 배경 상자는 글자를 감싸는 크기로
#: 그려지므로 이 값이 곧 배경 크기를 정한다.
padding: int = 18
line_spacing: int = 6
max_lines: int = 2
show_source: bool = False # 원문 동시 표시
align: str = "center" # left | center | right
fade_out_ms: int = 4000 # 0이면 계속 유지
@dataclass
class OverlayConfig:
"""자막 창(오버레이) 위치/동작."""
x: int = -1 # -1 = 아직 배치 안 됨 (앵커로 계산)
y: int = -1
width: int = 1100
height: int = 200
always_on_top: bool = True
#: 자막 위로 마우스가 통과하게 한다. 게임 중에는 켜두는 게 편하다.
click_through: bool = True
#: 기본은 잠금이다. 게임 중에 자막을 실수로 끌고 다니는 사고를 막는다.
#: 옮기거나 크기를 바꿀 때는 자막 화면의 '자막 위치 조정'을 켠다.
locked: bool = True
#: 자막 표시 on/off (단축키로 토글)
visible: bool = True
#: 자막을 띄울 모니터 인덱스 (0부터)
screen_index: int = 0
#: 디스코드 오버레이식 9분할 위치. "custom"이면 드래그로 옮긴 자유 위치.
anchor: str = "bottom-center"
#: 화면 가장자리에서 띄울 간격
margin: int = 60
@dataclass
class AudioConfig:
backend: str = "auto" # auto | process | device | input | file
#: 홈 화면 목록이 무엇을 보여줄지. "output"=프로그램과 출력 장치(게임 소리),
#: "input"=마이크 같은 입력 장치. 고른 쪽을 기억한다.
source_mode: str = "output"
target_pid: int = 0
target_process_name: str = ""
device_index: int = -1 # -1 = 기본 출력 장치 루프백
input_gain: float = 1.0
vad_aggressiveness: int = 2 # 0-3
silence_ms: int = 600 # 이 시간만큼 조용하면 한 문장 종료
min_segment_ms: int = 400
max_segment_ms: int = 12_000
partial_interval_ms: int = 900 # 중간 결과 갱신 주기, 0이면 끔
@dataclass
class ModelConfig:
tier: str = DEFAULT_TIER
device: str = "cuda" # cuda | cpu
device_index: int = 0
source_lang: str = "auto" # auto 또는 언어코드
target_lang: str = "ko"
preload_on_start: bool = True
lora_adapter_path: str = "" # 추가학습 어댑터 (비어있으면 미사용)
#: 한국어 자막 말투. "polite"(존댓말, 기본) | "casual"(반말)
#: 반말이어도 원문이 실제로 존댓말이면 존댓말을 지킨다.
speech_level: str = "polite"
@dataclass
class GlossaryConfig:
enabled: bool = True
path: str = "" # 비어있으면 user_data_dir()/glossary.json
case_sensitive: bool = False
#: 처음 설치했을 때 켜져 있는 용어집 팩.
#: 체크를 안 해보고 그냥 쓰는 경우가 대부분이라 기본으로 켜둔다.
#: 게임 전용 팩끼리 역어가 갈리면 용어집 화면이 알려주므로, 안 하는 게임은
#: 꺼주면 된다.
enabled_packs: list[str] = field(
default_factory=lambda: ["fps-common", "overwatch", "pubg", "r6siege", "watchdogs"]
)
@dataclass
class PerformanceConfig:
"""게임과 동시에 돌릴 때 GPU를 얼마나 양보할지.
이 프로그램은 게임 위에 얹혀 돌아가는 것이 기본 용도라, 자막 품질보다
게임 프레임을 지키는 쪽이 대체로 더 중요하다.
"""
#: 저부하 모드. 켜면 아래 항목들이 자동으로 보수적인 값으로 적용된다.
game_mode: bool = True
#: 프로세스가 쓸 수 있는 VRAM 상한 비율 (0이면 제한 없음).
#: 게임이 VRAM 부족으로 버벅이는 것을 막는다.
vram_limit_ratio: float = 0.35
#: 한 번 추론하고 나서 GPU를 놓아주는 시간. 게임 프레임 확보용.
yield_ms: int = 60
#: 이 시간 동안 말소리가 없으면 모델을 내려 VRAM을 통째로 반납한다. 0이면 끔.
idle_unload_s: int = 300
#: 저부하 모드에서 연산 정밀도를 int8로 낮출지
force_int8: bool = True
@dataclass
class HotkeyConfig:
"""전역 단축키. 게임 창이 떠 있어도 동작한다."""
enabled: bool = True
#: 자막 표시 on/off
toggle_subtitle: str = "Ctrl+Alt+S"
#: 번역 엔진 시작/정지
toggle_engine: str = "Ctrl+Alt+D"
@dataclass
class AppConfig:
audio: AudioConfig = field(default_factory=AudioConfig)
models: ModelConfig = field(default_factory=ModelConfig)
subtitle: SubtitleStyle = field(default_factory=SubtitleStyle)
overlay: OverlayConfig = field(default_factory=OverlayConfig)
glossary: GlossaryConfig = field(default_factory=GlossaryConfig)
performance: PerformanceConfig = field(default_factory=PerformanceConfig)
hotkeys: HotkeyConfig = field(default_factory=HotkeyConfig)
theme: str = "dark" # dark | light
start_minimized: bool = False
log_transcripts: bool = True
# --- 영속화 ---------------------------------------------------------
def to_dict(self) -> dict[str, Any]:
return asdict(self)
def save(self, path: Path | None = None) -> Path:
target = path or config_path()
target.parent.mkdir(parents=True, exist_ok=True)
tmp = target.with_suffix(".json.tmp")
tmp.write_text(
json.dumps(self.to_dict(), ensure_ascii=False, indent=2), encoding="utf-8"
)
tmp.replace(target)
return target
@classmethod
def load(cls, path: Path | None = None) -> AppConfig:
target = path or config_path()
if not target.exists():
return cls()
try:
raw = json.loads(target.read_text(encoding="utf-8"))
except (OSError, json.JSONDecodeError) as exc:
log.warning("설정 파일을 읽지 못해 기본값을 사용합니다: %s", exc)
return cls()
return _from_dict(cls, raw)
def _from_dict(cls: type, raw: Any) -> Any:
"""알 수 없는 키는 버리고 누락된 키는 기본값으로 채우는 관대한 역직렬화.
기본값 인스턴스를 먼저 만든 뒤 알고 있는 필드만 덮어쓴다. 덕분에
설정 스키마가 바뀌어도 사용자의 기존 config.json이 깨지지 않는다.
"""
instance = cls()
if not isinstance(raw, dict):
return instance
known = {f.name for f in fields(cls)}
for key, value in raw.items():
if key not in known:
continue
current = getattr(instance, key)
if is_dataclass(current) and not isinstance(current, type):
setattr(instance, key, _from_dict(type(current), value))
else:
setattr(instance, key, value)
return instance