마우스 주행거리 · MouseWalk

공식 다운로드: https://mouse-walk-download.pages.dev/

시작하기
1. 이전 버전이 켜져 있다면 트레이 메뉴에서 종료합니다.
2. 새 MouseWalk.exe를 원하는 폴더에 두고 실행합니다.
3. 시계 옆 마우스 아이콘을 더블클릭하면 주행거리 랭킹이 열립니다.
4. 처음에는 닉네임(2~16자)을 정하고 랭킹 참여를 누릅니다.
닉네임을 정하기 전에는 PC 안에서만 기록합니다.
닉네임과 날짜별 이동 거리를 랭킹에 사용합니다. 커서 좌표나 다른 프로그램 정보는 전송하지 않습니다.

메뉴
- 주행거리 랭킹 / 산책거리 랭킹: 개인과 팀의 오늘 / 이번 주 / 전체 순위. 내 행은 테마 색으로 표시합니다.
- 위젯 숨기기 / 보이기: 위젯 표시만 바꿉니다. 측정은 계속됩니다.
- 위젯 위치 조정: 다른 아이콘과 겹치지 않게 좌우 위치를 조정합니다.
- 테마 변경: 누를 때마다 마우스 주행 / 마우스 산책으로 바로 전환합니다. 별도 창 없이 위젯과 열린 창에 즉시 적용되며 선택이 저장됩니다.
- 업데이트 확인: 새 버전을 확인합니다. 새 버전이 있으면 업데이트 버튼으로 내려받고 앱을 다시 시작합니다.
- 종료: 기록을 저장하고 프로그램을 종료합니다. 측정과 전송도 멈춥니다.
랭킹창의 닉네임 변경(산책 테마에서는 별명 바꾸기)은 기기 ID와 기록, 팀 참가 상태를 유지합니다.
측정 일시정지, 누적 거리 복사, 주행거리 초기화 기능은 제거했습니다.

실시간 표시와 거리 환산
작업표시줄 위젯과 트레이 설명에는 오늘 기록만 표시합니다. 한국 시간 자정에 새날의 기록으로 전환합니다.
전체 누적 기록은 지워지지 않으며 랭킹의 전체 탭에서 확인할 수 있습니다.
상단의 내 거리는 0.1초마다 PC의 최신 기록을 표시합니다. 이 갱신으로 서버 요청이 늘어나지 않습니다.
랭킹 표는 서버에 전송된 기록 기준이므로 상단 실시간 거리와 일시적으로 다를 수 있습니다.
아래에는 다음 자동 업데이트까지 남은 초를 표시합니다. 새벽에는 오전 8시 재개를 안내합니다.
오른쪽 아래 새로고침 아이콘을 누르면 회전과 업데이트 중 안내가 표시되고, 성공하면 체크 표시가 잠시 나타납니다.
전송 중 또는 5초 이내 중복 요청은 비활성화합니다. 실패 시 재시도 시각과 오류 상태를 보여줍니다.
m 값은 27인치 / FHD 1920×1080 / 정사각형 픽셀 기준 화면 위 이동 길이의 추정값입니다.
1,000,000px ≈ 311.3m입니다. 실제 손이나 마우스가 책상에서 움직인 거리가 아닙니다.

팀 / 산책 모임
랭킹 위쪽의 팀 랭킹(산책 테마에서는 산책 모임)을 누르면 합산 순위를 봅니다.
팀 만들기 / 참가에서 이름(2~20자)을 정해 만들거나, 목록에서 기존 팀을 선택해 참가합니다.
별도 초대나 승인 없이 누구나 참가할 수 있는 공개 팀입니다. 한 기기는 한 팀에 참가합니다.
참가 후에는 내 팀 / 우리 모임 버튼에서 현재 모임을 확인하거나 나갈 수 있습니다.
오늘 / 이번 주 / 전체 점수는 현재 구성원의 개인 기록을 합산합니다. 가입 전 기록도 해당 기간에 포함됩니다.
팀에서 나가면 그 사람의 기록은 팀 합계에서 빠지며 개인 기록은 그대로 남습니다.
팀 합계는 마지막 서버 업데이트 기준이며, 개인 화면의 내 거리처럼 실시간으로 증가하지는 않습니다.
팀을 만들거나 참가·나갈 때는 바로 서버에 반영합니다. 일반 자동 전송 주기는 바뀌지 않습니다.

산책 테마
계단 사이트 https://stairish.pages.dev/ 의 원본 토끼 SVG 도형과 글꼴/색상을 사용합니다.
산책 모드에서는 주행거리 대신 산책거리로 부르며 안내 말투도 바뀝니다.
두 테마 모두 작업표시줄 위젯 배경은 투명합니다. 산책 테마도 캐릭터와 숫자만 표시합니다.

서버와 자동 실행
앱 실행 약 25초 후와 이후 6시간마다 새 버전을 확인합니다. 새 버전이 있을 때만 알림을 표시합니다.
업데이트는 사용자가 업데이트 버튼을 눌렀을 때 적용합니다. 다운로드 후 크기·SHA-256·실행 파일 버전을 확인합니다.
기록 저장에 실패하면 업데이트를 중단합니다. 파일 교체 또는 새 실행 실패 시 기존 실행 파일을 유지하거나 복구합니다.
업데이트 중 인터넷 연결이 끊겨도 기존 앱은 계속 사용할 수 있습니다. 관리자 전용 폴더는 피하고 쓸 수 있는 폴더에 두세요.
처음 업데이트 기능이 도입되기 전의 버전에서는 새 실행 파일을 한 번 직접 받아야 합니다.
전용 서버에 자동으로 연결됩니다. 사용자가 서버 주소를 설정할 필요는 없습니다.
실행하면 현재 사용자의 Windows 로그인 자동 시작을 등록합니다. 관리자 권한은 필요하지 않습니다.
앱 안에는 자동 실행 선택 항목이 없습니다. 필요하면 Windows의 시작 앱에서 관리할 수 있습니다.
실행 파일을 옮기거나 새 버전으로 바꾼 뒤에는 새 위치에서 한 번 실행하세요.

동기화 일정 (한국 시간)
- 08:00~다음 날 01:00: 약 1분마다 자동 전송.
- 01:00~08:00: 자동 전송 중지. 측정과 PC 내 저장은 계속됩니다.
- 랭킹 열기 / 새로고침: 시간대와 상관없이 즉시 전송하고 순위를 받습니다.
- 수동 요청은 최소 5초 간격이며 전송 중에는 중복 요청하지 않습니다.
- 인터넷이 없으면 기록을 보관하고 다음 연결 때 전송합니다.
- 컴퓨터가 꺼져 있거나 절전이면 측정과 전송을 하지 않습니다.
- 60일 이상 쌓인 기록은 여러 번에 나누어 전송합니다.

기존 기록과 저장
기존 기록과 닉네임을 그대로 이어받습니다.
온라인 기능 이전의 데이터에는 날짜별 이력이 없어 당시 오늘 기록은 오늘 순위에,
나머지 누적값은 전체 순위에만 반영됩니다. 이번 주는 한국 시간 월요일 00시부터 계산합니다.
%LOCALAPPDATA%\MouseMileage 폴더에 10초마다, 정상 종료 시 기록을 저장합니다.
distance.xml: 위젯 거리 / online.xml: 날짜별 기록과 기기 정보
leaderboard.json: 마지막 랭킹 / position.txt: 위젯 위치 / appearance.xml: 테마
주요 기록은 이전 저장본(.bak)을 보관합니다. 갑작스러운 전원 종료 시 최근 약 10초가 유실될 수 있습니다.
기기 인증 정보는 Windows 사용자 계정에 묶어 암호화합니다.
다른 PC나 Windows 계정으로 기록을 이전하는 복구 코드 기능은 아직 없습니다.

안내
Windows 10/11 + .NET Framework 4.7.2 이상이 필요합니다.
위젯은 작업표시줄 위에 겹치는 방식이며 공간을 따로 예약하지 않습니다. 클릭은 아래로 통과합니다.
거리는 화면 픽셀 기준입니다. 실제 손 이동 거리와 다릅니다.
휘젓기 제외나 강력한 부정행위 방지는 아직 없습니다. 친목용 기록 비교입니다.
실행 파일 하나만 전달해도 됩니다. 별도 글꼴이나 서버 설정 파일이 필요하지 않습니다.