Windows 유틸
복사 관리자
Win+V 창이 작고 다루기 불편했던 분
Windows 10 · 11 · 100.2MB · v0.2.4 · TypeScript
GazeScroll
내려받기- 소개
- 화면 한쪽에 작은 버튼을 띄워 둡니다. 커서를 그 위에 올려두기만 하면 스크롤이 됩니다.
- 이런 분께
- 휠을 굴리기 어렵거나, 눈으로 커서를 움직이는 분
- 주요기능
- 버튼 위에 커서를 올려두면 클릭 없이 화면이 자동으로 넘어갑니다.
- 형태
- 포터블
- 용도
- 웹서핑문서읽기웹툰SNS
- 가격
- 무료오픈소스
- 만든 기술
- TypeScriptElectronkoffi자세한 구조는 아래 개발자 정보에서 볼 수 있습니다
어떻게 쓰나요?
- 1위 내려받기를 누르면 GitHub 릴리스 페이지가 열립니다. 맨 위 최신 항목의 파일을 받으세요.
- 2받은 파일을 실행합니다. 설치가 필요한 경우 안내에 따라 진행하시면 됩니다.
- 3쓰다가 막히면 아래 이야기에 남겨 주세요. 만든 사람이 직접 답합니다.
처음 실행할 때 “Windows의 PC 보호” 경고가 뜰 수 있습니다. 코드 서명 인증서를 아직 넣지 않아서 그렇습니다. 추가 정보 → 실행을 누르면 실행됩니다.
For developers
개발자 정보
기술 스택 · 시스템 구조 · 기술 과제 — 필요한 항목만 눌러서 펼쳐 보세요
프로젝트 요약 규모 · 배포 · 해결한 문제
| 규모 | 1인 개발 — 기획 · 설계 · 구현 · 배포 |
|---|---|
| 배포 | GitHub Releases |
| 해결한 문제 | 휠·키보드를 쓸 수 없는 사용자가 커서만으로 스크롤할 수 있게 한다 |
안구마우스·헤드마우스는 커서 이동은 되지만 휠이 없습니다. 기존 Windows 접근성 기능은 클릭이나 키보드 조합을 전제로 해서 이 경우를 덮지 못했습니다.
기술 스택 무엇을 왜 골랐나
TypeScriptElectronkoffi
TypeScript오버레이·MCP 서버처럼 오래 떠 있는 프로그램에 씁니다. 설정 스키마에 타입을 걸어 값이 어긋나면 빌드에서 잡히게 합니다.
시스템 구조 모듈 · 데이터 흐름
입력
커서 폴링 50ms오버레이가 포커스를 받지 않으므로 mousemove가 오지 않습니다. 커서 좌표를 직접 읽어 hover를 판정합니다.
Win32 FFI (koffi)user32·kernel32를 직접 부릅니다. 네이티브 애드온을 빌드하지 않습니다.
창 목록 · exe명창 핸들은 껐다 켜면 바뀌므로 소유 실행 파일 이름으로 저장합니다.
처리
스크롤 경로 분기앱마다 합성 휠을 받는 방식이 달라 대상 창 종류로 방식을 고릅니다.
대상 창 고정마지막으로 앞에 있던 창을 기억해 그쪽으로 보냅니다. 좌클릭 중에는 갱신을 멈춥니다.
붙이기 앵커대상 창 위치를 폴링해 버튼을 8분할 자리에 붙입니다.
표시
클릭스루 오버레이포커스와 앞면을 절대 뺏지 않습니다. 휠이 버튼 아래 창으로 통과합니다.
게이지 4종 · 7색응시가 차오르는 것이 보이고 발동 직전에 색이 바뀝니다.
7개 언어메인과 화면이 같은 문자열 사전을 씁니다.
화면 쪽은 메인을 직접 부르지 않고 IPC 다리만 씁니다. 입력 모듈은 Electron 없이 순수 Win32 호출이라 따로 떼어 시험할 수 있습니다.
인터페이스 · 설정 구조 설정 스키마
설정은 %APPDATA%/gazescroll/gazescroll/settings.json에 저장됩니다. 지우면 화면 중앙 ▲▼ 두 버튼인 기본값으로 돌아갑니다.
| 키 | 타입 | 기본값 | 설명 |
|---|---|---|---|
triggerMode | dwell | click | dwell | 커서를 올려두면 발동 / 실제 클릭 |
dwellMs | number | 700 | 발동까지 올려두는 시간(ms) |
repeatMode | single | repeat | repeat | 한 번만 / 커서를 뗄 때까지 반복 |
scrollMethod | inject | post | child | inject | 실제 휠 / 크롬류 / 클래식 Win32 |
attachMode | boolean | false | 버튼이 대상 창을 따라다닌다 |
attachAnchor | 8분할 | r | 대상 창 기준 붙는 자리 |
attachFilterMode | all | allow | block | all | 따라갈 창을 실행 파일로 거른다 |
globalHotkey | string | Alt+F12 | 표시·숨김 단축키 |
lang | 7개 언어 | ko | 화면 언어 |
기술 과제와 해결 막혔던 지점
과제 01앱마다 합성한 휠을 받는 방식이 정반대였습니다. 크롬류는 자식 창에 보낸 신호를 무시하고, 옛 Windows 앱은 실제 휠 주입을 잘 받지 않습니다.
대상 창 종류로 경로를 나눴습니다. 크롬류는 최상위 창에, 옛 앱은 가장 깊은 자식 컨트롤까지 내려가 보냅니다.
과제 02오버레이가 포커스를 받으면 쓰던 앱이 뒤로 밀립니다. 그런데 포커스가 없으면 마우스 이동 신호가 오지 않아 커서가 버튼 위에 있는지 알 수 없습니다.
창을 포커스를 받지 않는 방식으로 띄우고, 커서 위치를 50ms마다 직접 읽어 판정했습니다. 쓰던 앱이 그대로 앞에 남습니다.
과제 03휴대폰 원격제어처럼 보호된 창은 일반 권한으로 보낸 입력이 OS 단계에서 버려집니다.
관리자 권한으로 실행하도록 매니페스트를 넣었습니다. 그 설정을 실을 수 없는 배포 형식이 있어 zip으로 내보냅니다.
쓰는 사람들 이야기
읽는 것은 로그인 없이 됩니다. 글을 남기려면 한 번만 로그인해 주세요 — 가입 절차는 없습니다.
이름과 프로필 사진만 가져옵니다. 따로 입력하실 것은 없습니다.
이 도구에 대한 이야기가 아직 없습니다. 첫 글을 남겨주세요.
비슷한 도구
영상 2Windows 유틸
Mini Capture
단축키 조합(Win+Shift+S)을 누르기 어려운 분
Windows 10 · 11 · 63.8MB · v0.1.6 · C#
사진 1접근성 도구
scrcpy 설정 창
폰을 손으로 만지기 어려운 분 — PC 마우스로 폰을 씁니다
Windows 10 · 11 · 154.3MB · v0.3.0 · C#