What is Device Orientation Tester
The Device Orientation Tester listens for device orientation events and displays the alpha, beta, and gamma rotation values of the device. Alpha represents rotation around the z-axis (compass direction), beta is the tilt front-to-back, and gamma is the tilt left-to-right. This API powers augmented reality experiences, motion-controlled games, compass apps, and other interactions that depend on how the user is holding their device. The tool sets up a one-shot event listener, waits up to five seconds for data, and displays the results or a timeout message. On desktop browsers without an accelerometer, the timeout message is expected — the tool is designed for mobile-first testing.
How to Use Device Orientation Tester
- Step 1: Open the Device Orientation Tester page, which displays a test button and an output area.
- Step 2: Click the **Test API** button. On a mobile device, the tool begins listening for orientation sensor data.
- Step 3: Tilt or rotate the device. Within five seconds, the output displays the alpha, beta, and gamma values in degrees.
- Step 4: On desktop browsers without accelerometer hardware, the output shows a timeout message suggesting you test on a mobile device.
- Step 5: Each subsequent click re-initializes the listener and waits for fresh sensor data.
Why Use Device Orientation Tester
Developers building motion-responsive interfaces need to know what raw sensor values their target devices produce before writing transform logic. The Device Orientation Tester provides instant access to the alpha, beta, and gamma values without any custom code. This is particularly useful for calibrating tilt thresholds in games, validating that a device's accelerometer is functioning correctly, and understanding why orientation-based features work on one device but not another — different hardware produces different value ranges.
Privacy & Security
This tool runs entirely in your browser — no data ever leaves your device. There is no server round-trip, no upload, no logging, and no account required. Your input is processed locally using client-side JavaScript and is never stored, transmitted, or accessible to anyone else. When you close the tab, everything disappears.
Frequently Asked Questions
Why does the tool time out on my desktop browser?
<p>Desktop computers typically do not have accelerometer or gyroscope hardware, so the DeviceOrientationEvent never fires. The tool is designed primarily for mobile devices with motion sensors.</p>
Do I need to grant any permissions on iOS?
<p>On iOS 13 and later, Apple requires an explicit call to DeviceOrientationEvent.requestPermission() before the browser will deliver orientation data. This call must originate from a user gesture such as a button click. The tool handles this automatically when you click the Test API button. On older iOS versions and on Android, no explicit permission request is needed for the orientation API itself, though the general motion permission may apply.</p>
What are alpha, beta, and gamma?
<p>Alpha is the compass direction (0 to 360 degrees) measuring rotation around the vertical axis. Beta (negative 180 to positive 180 degrees) measures front-to-back tilt. Gamma (negative 90 to positive 90 degrees) measures left-to-right tilt. Together they describe the device's orientation in 3D space relative to the Earth's frame of reference.</p>
Can I use this data for augmented reality?
<p>Yes, device orientation values are the foundation for many AR experiences. By combining alpha, beta, and gamma with the device's camera feed, you can overlay virtual objects on the real world. However, for more precise AR tracking, developers typically use the WebXR Device API or libraries like AR.js, which build on top of raw orientation data.</p>