Skip to content

Repository files navigation

MotionCue Desktop

MotionCue Desktop is a local macOS and Windows app that adds motion-cue dots to the edges of a laptop screen. It is meant for passengers using a laptop in a moving car, bus, train, or taxi, where subtle visual motion cues can make screen use feel less disorienting.

The app uses a phone as a motion sensor bridge. Your phone opens a local sensor page by QR code, sends acceleration data to the desktop app over the local network, and the laptop overlay turns that motion into small, click-through dots near the screen edges.

MotionCue Desktop is unofficial and is not affiliated with Apple.

Features

  • Desktop overlay with small edge dots that stays out of the way.
  • Phone sensor bridge over the local network.
  • iPhone setup through a locally generated HTTPS profile.
  • Android setup through a locally generated certificate.
  • Simulation mode for testing without a phone.
  • Adjustable sensitivity, dot count, dot size, opacity, color, and layout.
  • macOS and Windows packaging through Electron Builder.

Privacy

MotionCue is designed to stay local.

  • No telemetry or analytics are sent by the app.
  • Phone motion data is streamed only to the desktop app on the same local network.
  • Local HTTPS certificate/profile files are generated on your machine and stored in the app's local user-data directory.
  • Settings are stored locally.

See PRIVACY.md for the longer note.

Safety

Use this only as a passenger. Do not use it while driving or in any situation where screen use would reduce attention or safety.

Download

Download packaged builds from GitHub Releases.

The current macOS build is for Apple Silicon. The app is not notarized, so macOS may ask you to right-click and choose Open the first time. Windows may show a SmartScreen warning because this is an unsigned personal build.

Run From Source

npm install
npm start

Build

npm run build:mac
npm run build:win

Build outputs are written to dist/. The repository intentionally ignores packaged installers, archives, node_modules, and local agent logs.

Phone Pairing

  1. Open MotionCue Desktop.
  2. Choose Android or iPhone in the setup flow.
  3. Keep the phone and laptop on the same Wi-Fi or phone hotspot.
  4. Install the local certificate/profile from the first QR code if prompted.
  5. Open the sensor page from the second QR code.
  6. Tap the motion sensor start button on the phone.
  7. Place the phone screen-up in portrait orientation, with the top edge facing the front of the vehicle.
  8. Press Calibrate in the desktop app.

Verification

npm run lint
npm run smoke

MotionCue Desktop 한국어

MotionCue Desktop은 이동 중인 차량, 버스, 기차, 택시 안에서 노트북을 사용하는 승객을 위한 로컬 데스크톱 앱입니다. 노트북 화면 가장자리에 작은 모션 큐 도트를 띄워서, 실제 차량 움직임과 화면 사용 사이의 어색함을 줄이는 것을 목표로 합니다.

휴대폰을 모션 센서 브리지로 사용합니다. 앱의 QR 코드를 휴대폰으로 열면, 휴대폰의 가속도 데이터가 같은 로컬 네트워크의 데스크톱 앱으로 전달되고, 노트북 오버레이가 그 움직임을 화면 가장자리 도트로 표현합니다.

MotionCue Desktop은 비공식 프로젝트이며 Apple과 관련이 없습니다.

주요 기능

  • 클릭을 방해하지 않는 화면 가장자리 도트 오버레이.
  • 같은 로컬 네트워크에서 작동하는 휴대폰 센서 브리지.
  • iPhone용 로컬 HTTPS 프로필 연동.
  • Android용 로컬 인증서 연동.
  • 휴대폰 없이 테스트할 수 있는 시뮬레이션 모드.
  • 민감도, 도트 수, 도트 크기, 투명도, 색상, 배치 조절.
  • Electron Builder 기반 macOS/Windows 패키징.

개인정보

MotionCue는 로컬 사용을 기준으로 설계했습니다.

  • 앱은 텔레메트리나 분석 데이터를 보내지 않습니다.
  • 휴대폰 모션 데이터는 같은 로컬 네트워크의 데스크톱 앱으로만 전송됩니다.
  • 로컬 HTTPS 인증서/프로필은 사용자의 기기에서 생성되고 앱의 로컬 user-data 폴더에 저장됩니다.
  • 설정도 로컬에 저장됩니다.

자세한 내용은 PRIVACY.md를 참고하세요.

안전 안내

승객일 때만 사용하세요. 운전 중이거나 주의가 필요한 상황에서는 사용하지 마세요.

다운로드

패키징된 앱은 GitHub Releases에서 받을 수 있습니다.

현재 macOS 빌드는 Apple Silicon용입니다. 앱은 notarization/signing이 적용되지 않은 개인 빌드라서, macOS에서는 첫 실행 때 우클릭 후 열기가 필요할 수 있고 Windows에서는 SmartScreen 경고가 표시될 수 있습니다.

소스에서 실행

npm install
npm start

빌드

npm run build:mac
npm run build:win

빌드 결과물은 dist/에 생성됩니다. 공개 저장소에는 설치 파일, 압축 파일, node_modules, 로컬 작업 로그를 포함하지 않도록 설정했습니다.

휴대폰 연결

  1. MotionCue Desktop을 실행합니다.
  2. 설정 흐름에서 Android 또는 iPhone을 선택합니다.
  3. 휴대폰과 노트북을 같은 Wi-Fi 또는 휴대폰 핫스팟에 둡니다.
  4. 필요하면 첫 번째 QR 코드로 로컬 인증서/프로필을 설치합니다.
  5. 두 번째 QR 코드로 센서 페이지를 엽니다.
  6. 휴대폰에서 모션 센서 시작 버튼을 누릅니다.
  7. 휴대폰은 화면이 위를 향하게 세로 방향으로 두고, 휴대폰 위쪽이 차량 앞쪽을 향하게 놓습니다.
  8. 데스크톱 앱에서 Calibrate를 누릅니다.

About

차량 이동 중 노트북을 위한 로컬 모션 큐 오버레이 / Local desktop motion-cue overlay for laptops in moving vehicles

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages