Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WheelReverse — 마우스 휠 방향 반전 (윈도우) 🖱️⬆️⬇️

Windows 마우스 휠 스크롤 방향을 전역으로 즉시 반전하는 트레이 유틸
A lightweight Windows tray utility that globally reverses your mouse wheel / scroll direction instantly — no admin, no reboot.

한국어 검색어: 마우스 휠 반전 / 스크롤 방향 반전 / 마우스 스크롤 뒤집기 / 자연스러운 스크롤 / 내추럴 스크롤 / 휠 방향 바꾸기 / 스크롤 반대 방향 / macOS처럼 스크롤
English keywords: reverse mouse wheel / invert scroll direction / natural scrolling Windows / flip scroll direction / mouse wheel direction


🤔 이런 문제가 있나요? (이 앱이 해결하는 것)

  • "마우스 휠을 굴리는 방향이랑 화면 스크롤이 반대로 움직여요" → WheelReverse가 실시간으로 바로잡아줍니다.
  • "맥(Mac)에서 쓰던 자연스러운 스크롤(Natural Scrolling)이 윈도우에선 안 돼요" → 한 번 실행으로 맥과 동일한 감각을 만듭니다.
  • "마우스만 뒤집고 싶은데 트랙패드까지 바뀌어서 불편해요" → 마우스 휠만 정확히 뒤집습니다.
  • "원격 데스크톱 / 가상머신 / 특정 프로그램에서만 방향이 헷갈려요" → 전역 훅으로 모든 프로그램에 일관되게 적용됩니다.
  • "레지스트리(FlipFlopWheel)나 설정을 건드렸는데 반영이 안 되거나 재부팅이 필요해요" → 관리자 권한도, 재부팅도 필요 없습니다.

✅ 특징

  • 관리자 권한 불필요 — 일반 사용자로 실행 가능
  • 재부팅 불필요 — 실행 즉시 전역 적용
  • 전역 적용 — 모든 프로그램(브라우저/파일 탐색기/IDE 등)에서 동작
  • 트레이 유틸 — 작업표시줄 알림 영역에서 좌클릭 토글, 우클릭 메뉴
  • 시작프로그램 등록 — 부팅부터 자동 실행

🚀 사용법 (가장 쉬운 방법)

  1. Releases에서 WheelReverse.exe를 다운로드합니다.
  2. 원하는 폴더에 둔 뒤 WheelReverse.exe더블클릭 → 트레이에 아이콘이 나타나며 즉시 반전 시작.
  3. 트레이 아이콘 조작:
    • 좌클릭 → 반전 켜기/끄기 토글
    • 우클릭 → 메뉴
      • 휠 반전 켜기/끄기
      • 시작프로그램 등록 (로그인 시 자동 실행)
      • 시작프로그램 해제
      • 종료

명령줄: WheelReverse.exe --install (시작프로그램 등록 + 실행), WheelReverse.exe --debug (동작 기록을 debug.log에 남김).


🔧 소스로 직접 실행 / 빌드

# 의존성: pywin32 (트레이용) — 순수 ctypes 빌드본은 불필요
pip install pyinstaller

# 소스 실행
python wheel_reverse.py

# 단일 EXE 빌드
pyinstaller --onefile --noconsole --name WheelReverse --add-binary "scroll_hook.dll;." wheel_reverse.py

scroll_hook.dll은 반드시 WheelReverse.exe같은 폴더에 있어야 합니다.


🧠 동작 원리

  • scroll_hook.dllSetWindowsHookEx(WH_MOUSE, ...) 전역 훅을 겁니다.
  • 모든 프로세스에 dll이 주입되고, 휠 이벤트(WM_MOUSEWHEEL)의 mouseData 델타 부호를 뒤집어 시스템 전체에 전달합니다.
  • wheel_reverse.py(또는 빌드본)는 dll을 로드/언로드하고 트레이 UI·시작프로그램을 관리합니다.

❓ 자주 묻는 질문 (FAQ)

Q. 마우스 휠 방향이 반대로 느껴져요. 이걸로 고칠 수 있나요?
A. 네. WheelReverse를 실행하면 모든 프로그램에서 휠 방향이 즉시 반전됩니다. 좌클릭으로 언제든 되돌릴 수 있습니다.

Q. 맥(Mac)처럼 스크롤하고 싶어요.
A. 맥의 "자연스러운 스크롤"은 손가락을 위로 올리면 콘텐츠도 위로 가는 방식입니다. WheelReverse로 마우스 휠을 반전하면 그 감각을 윈도우에서 재현할 수 있습니다.

Q. 트랙패드는 그대로 두고 마우스만 바꾸고 싶어요.
A. WheelReverse는 마우스 휠 이벤트만 가로채므로, 트랙패드 설정에는 영향을 주지 않습니다.

Q. 관리자 권한이나 재부팅이 필요한가요?
A. 아니요. 관리자 권한 없이, 재부팅 없이 즉시 적용됩니다.


✨ 만든 사람 (Developer)

로간 (GeunHu Kim) — "박새로이(Baksaeroyi)" 페르소나로 활동하는 자동화 엔지니어

"내가 안 해도 되게 만들자." — 반복되는 수동 작업은 자동화로 끝내는 걸 지향합니다. 누구나 클릭 한 번(또는 아예 부팅부터)으로 휠 반전을 켜고 잊을 수 있게 만든 유틸입니다.

🏠 GitHub https://github.com/delight0517
📦 이 저장소 https://github.com/delight0517/wheel-reverse
🧠 포트폴리오 https://delight0517.github.io/releasepilot-reports/links/
✉️ 문의 rogan2534@gmail.com
  • macOS·Windows·iOS·Android 전 플랫폼 앱 출시 자동화
  • 반복 작업 자동화, API 통합, AI 에이전트 운영
  • 원격·단기 외주 환영 (풀스택 웹/앱, Python, AI API 연동)

📜 라이선스 / 크레딧

MIT License. 내부 훅 엔진 scroll_hook.dllnatural-scroll-windows (themanlee7942, MIT)를 재사용했습니다. 원저자에게 감사드립니다.

About

김근후(GeunHu Kim) 개발 — Windows 마우스 휠/스크롤 방향을 전역으로 즉시 반전하는 트레이 유틸 (관리자 권한·재부팅 불필요) | Reverse/invert mouse wheel & scroll direction on Windows instantly by 김근후

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages