TheOcularMigraineMCP

What the application controls

The Ocular Migraine is described as a Dev Mode Master Control Program for Oculus and Meta Quest mobile VR headsets, covering the original Quest, Quest 2, Quest Pro, and Quest 3. The README lists a broad set of features aimed at users who want deeper control than the stock interface allows. ADB permissions are said to survive a reboot. The user can change the headset resolution, change the CPU level from 0 to 5 as static or dynamic, and change the GPU level the same way. Fixed foveated rendering level from 0 to 4 can also be set as static or dynamic. The tool creates detailed custom resolution profiles per game and can apply them automatically when that game launches, a behavior the README compares to Quest Games Optimizer. Backup features cover a game's APK, OBB files if present, and data files and folders located in the Android data directory, with restore options both from a PC transfer using a bat file and directly from the headset backup folder. The README also states the application can modify recording settings such as bitrate, resolution, frame rate, rendering area, and recording eye, with the option to save a custom recording profile for different applications and games.

Recording, editing, and shortcuts

The recording tools go beyond capture. The README says the Quest notoriously has out of sync audio in its recordings, so the application can adjust the audio offset and speed or tempo by stretching or compressing the audio, along with trimming the start and end of a video. It can inject 3D metadata into a recorded 3D video so the file is ready to upload to YouTube. The tool sets redirect or shortcut apps to launch apps from unknown sources via the main menu, so the user does not have to open the unknown sources section each time. A start up application can be set, for example to launch a third party launcher on reboot, and the README notes a Quest 3 configured with Lightning Launcher as the start up app. Kiosk mode sets one application as the only launchable app and prevents the user from exiting it, with password protection. Access control lists let the user create a black list or a white list, where enabling one disables the other. A web server is included for file sharing and uploading over HTTP, with a selectable shared folder and independent upload toggles. The application can also install and launch the OVR Metrics Tool to display overlay performance statistics, and it can install and launch SideQuest, F-Droid, and File Manager Plus from within the interface.

Installation and interface

The README presents the application as an APK installable on the supported Quest headsets, with download links to releases and a YouTube guide version referenced in the table of contents. The interface is organized around a main screen with a top section, a middle section, and a bottom section, each documented with its own controls. The top section holds a statistics readout, an about area, font size adjustment, a resolution slider, the fixed foveated rendering level, and the CPU and GPU level controls. The middle section covers display frequency, default display settings, a reset option, and game profile management including saving and managing profiles. The bottom section covers user defined resolution presets and a disable option. Separate screens handle recording with resolution presets, custom resolution, bitrate, frame rate, recording eye, and start and stop controls. The backup menu offers a full game backup or game data only, with restore choices for the full game, the game only, or game data. The README frames the tool as giving access to features otherwise not available on the headset, and it describes the project as an application that runs on the Quest rather than as a companion phone app. The license section states the GNU GPL v3.0 applies to the project.

Editorial conclusion

The Ocular Migraine MCP is published under the GNU GPL v3.0, and the repository's most recent commit was on 2026-08-26. The app is hosted at github.com/petermg/TheOcularMigraineMCP.