설정 참조

VeilWin에는 설정 페이지가 8개입니다. 일반, 모양, 프로필, 규칙, 디스플레이, 단축키, 자동화, 라이선스. 모두 로컬에 저장되고 즉시 적용됩니다.

일반

• 로그인 시 시작: 로그인한 뒤 VeilWin을 자동 시작(트레이 상주)
• 최소화로 시작: 설정 창 없이 트레이만
• 창이 포커스되지 않을 때:
  • 마지막 창 유지: 가장 최근 포커스 창을 사용(기본)
  • 일시 정지: 다시 포커스가 생길 때까지 디밍 중지
  • 모두 디밍: 전부 어둡게
• 데스크톱 잠깐 드러내기: 수식 키를 눌러 화면을 되돌림(macOS 기본 Fn / Globe, Windows는 Ctrl+Alt. Ctrl+Shift, 사용자 단축키, 끄기도 가능)
• 시스템 외관 따라가기: 테마가 바뀌면 라이트/다크용으로 태그한 프로필을 자동 활성화
• 시스템 화면에서 일시 정지: Mission Control/Stage Manager(macOS) 또는 작업 보기/Alt-Tab(Windows) 중 자동으로 디밍 중지 — 기본 켜짐
• 손쉬운 사용 상태: macOS 권한을 보거나 요청

모양

• UI 테마: 내장 프리셋 — Apple (apple), Serene (serene), Dark (dark) — 즉시 전환
• UI 언어: 9종(언어 지원)
• 기본 디밍 강도: 새 프로필의 초기 강도(0–100%)
• 기본 디밍 틴트: 새 프로필의 초기 틴트(기본 순흑, 아무 RGB)

프로필

프로필은 디밍 파라미터 묶음입니다: 강도, 틴트, 애니메이션, 포커스 모드, 포커스 한도.

• 내장 템플릿 두 개: “표준”과 “아이케어”(강도 55% + 따뜻한 틴트, 밤의 긴 작업에 좋음)
• 라이트/다크 외관 태그를 붙이고 “시스템 외관 따라가기”로 자동 활성화
• 단축키에서 “프로필 활성화”를 묶어 한 키로 전환

규칙

규칙은 프로세스 이름으로 앱을 맞춥니다(대소문자 무시):

• 절대 디밍 안 함: 그 앱의 모든 창이 밝은 영역(미디어 플레이어, 화면 녹화 등)
• 맨 앞이면 일시 정지: 그 앱이 앞에 있는 동안 디밍을 완전히 멈춤

각 규칙은 따로 켜고 끌 수 있어 “예외 목록”에 알맞습니다.

디스플레이

각 디스플레이를 독립 제어:

• 켜기/끄기: 그 디스플레이가 디밍에 참여하는지
• 모드: 기본은 전역을 따름(각 디스플레이가 자신의 창에 포커스). “포커스 없는 화면만 디밍”으로 덮어쓸 수 있음
• 강도 재정의: 디스플레이별 강도
• 프로필 바인딩: 특정 프로필을 고정

단축키

충돌하는 바인딩은 바로 표시되며 먼저 해결해야 합니다.

자동화

자동화 규칙 = 트리거 + 동작. 목록 순서로 맞추며 첫 일치가 이깁니다. 앱에 프리셋 5개:

트리거: 매일 시각(HH:MM), 고정 간격(분), 시스템 외관 변화. 동작: 디밍 켜기/끄기, 프로필 활성화, 강도 설정, 휴식 알림, 강제 휴식. 각 규칙은 켜고 끄고 고치고 지울 수 있습니다.

강제 휴식 중 포커스 추적은 멈추고 시간이 끝날 때까지 화면이 완전히 어둡습니다. 트레이 메뉴에서 건너뛰세요. 프리셋은 기본 꺼짐입니다.

라이선스

• 라이선스 상태(무료 / Pro), 묶인 대수, 머신 식별자 보기
• 라이선스 키로 Pro 활성화(한 번 구매, 평생)
• 현재 기기 해제(새 기기에서 활성화하기 전에 예전 기기에서 해제)

무료 티어는 하루 2시간, 자정에 리셋. Pro는 시간 제한이 없습니다. 요금과 라이선스를 보세요.

MCP 인터페이스(고급)

VeilWin에는 내장 MCP 서버가 있습니다(기본 포트 18788, 설정에서 토큰과 함께 켭니다). MCP를 쓰는 AI 어시스턴트가 앱을 읽고 조작할 수 있습니다(설정 조회, 디밍 토글 등). localhost만 듣고 토큰으로 인증합니다. 로그와 외부 출력에 토큰을 넣지 않습니다.