Skip to content

H4RURAKA/VeilView

Repository files navigation

VeilView

작업 중인 창의 키보드 포커스를 유지하면서 웹 콘텐츠를 클릭·스크롤할 수 있는 Windows용 WebView2 오버레이 브라우저입니다.

VeilView는 브라우저 창을 화면 위에 띄우되, 기본 상태에서는 키보드 입력 흐름을 기존 작업 창에 남깁니다. 웹페이지를 마우스로 조작하면서도 작업 중인 프로그램의 키보드 입력이 끊기지 않도록 돕는 것이 목적입니다.

주요 기능

  • WebView2 기반 오버레이 웹브라우저
  • 기본 상태에서 키보드 포커스 유지
  • 내부 탭 지원
  • target="_blank", window.open() 요청을 VeilView 내부 새 탭으로 처리
  • 우클릭 드래그 마우스 제스처
  • 제스처별 동작 사용자 설정
  • 불투명도 100%~30% 슬라이더 설정
  • 항상 위 / 일반 모드 전환
  • 창 위치, 크기, 탭 목록, 선택 탭, 불투명도, 제스처 설정 저장
  • 단일 exe 배포 지원

UI 용어

표시 의미
직접 입력 주소창이나 웹페이지 입력칸에 글자를 입력하기 위해 VeilView가 키보드를 받는 상태로 전환
작업창 복귀 입력 상태를 끝내고 기존 작업 창에 키보드 포커스를 다시 넘김
투명도 창 표시 강도 설정. 100%는 완전 불투명, 30%는 많이 투명
제스처 우클릭 드래그 제스처 동작 설정

주소 입력, 보존 복귀라는 표현은 의미가 좁거나 어색해서 각각 직접 입력, 작업창 복귀로 정리했습니다.

마우스 제스처

브라우저 화면 위에서 마우스 오른쪽 버튼을 누른 채 드래그한 뒤 버튼을 떼면 제스처가 실행됩니다.

기본값은 다음과 같습니다.

제스처 기본 동작
이전 페이지
다음 페이지
새로고침
직접 입력 / 작업창 복귀 전환
오른쪽 탭 이동
왼쪽 탭 이동
탭 닫기
탭 닫기

왼쪽/오른쪽 탭 이동은 루프 방식입니다.

첫 번째 탭에서 왼쪽 탭 이동  → 마지막 탭
마지막 탭에서 오른쪽 탭 이동 → 첫 번째 탭

투명도 설정

상단의 투명도 버튼을 누르면 슬라이더 설정창이 열립니다.

의미
100% 완전 불투명
70% 약간 투명
50% 중간 투명
30% 많이 투명

VeilView가 항상 위 상태여도 투명도 설정창과 제스처 설정창은 VeilView보다 위에 뜨도록 처리되어 있습니다.

실행 조건

  • Windows 10/11 x64
  • Microsoft Edge WebView2 Runtime

대부분의 Windows 10/11 환경에는 WebView2 Runtime이 이미 설치되어 있습니다. 실행 시 WebView2 관련 오류가 뜨면 REPAIR_WEBVIEW2_RUNTIME.cmd를 실행하거나 Microsoft Edge WebView2 Runtime을 설치하세요.

빌드

단일 exe 빌드:

.\BUILD_SINGLE_EXE.cmd

빌드 결과:

dist\VeilView.exe

이 파일은 단독 배포용입니다. 단, 실행 PC에는 WebView2 Runtime이 필요합니다.

폴더 번들 빌드:

.\BUILD_PORTABLE_FOLDER.cmd

빌드 결과:

dist-folder\

이 방식은 폴더 안의 파일을 함께 유지해야 합니다.

GitHub Release

소스를 push한 뒤 태그를 push하면 GitHub Actions가 릴리스를 생성합니다.

git add .
git commit -m "VeilView v0.3.2 릴리스 준비"
git push

git tag v0.3.2
git push origin v0.3.2

릴리스에는 다음 파일이 첨부됩니다.

VeilView.exe
VeilView-win-x64.zip

주의

VeilView는 WebView2 기반 오버레이 브라우저입니다. 메모리 읽기, 패킷 변조, DLL 인젝션, 글로벌 키보드 훅, 자동 입력 매크로 기능을 포함하지 않습니다. 다만 특정 게임, 서비스, 보안 프로그램의 정책 판단은 보증할 수 없습니다.

About

작업 중인 창의 키보드 포커스를 유지하면서 웹 콘텐츠를 조작할 수 있는 Windows용 WebView2 오버레이 브라우저

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Contributors