Resolution Mapper is a small macOS utility for mapping a physical external monitor to a virtual display with a custom resolution. It was built for stubborn Full HD monitors that feel too large in macOS, but it can be used with any detected external display.
It creates a virtual display, mirrors a selected monitor to it, and stores profiles per monitor using vendor, model, and serial identifiers.
- Create virtual displays with custom resolutions
- Map any connected external monitor to a selected virtual resolution
- Store resolution profiles per monitor identity
- Remove virtual displays automatically when the physical monitor is disconnected
- Restore the saved mapping when the monitor is connected again
- Optional launch-at-login restoration
- Presets for QHD, soft QHD, wide workbench, 4K downsample, and native FHD
Resolution Mapper uses macOS virtual display APIs. These APIs are not part of a stable public app distribution contract, so behavior may change after macOS updates.
Text smoothing is limited by macOS downscaling and the physical panel. Try less aggressive presets such as Soft QHD when text looks jagged.
swift build --configuration debug --product ResolutionMapperTo create a local app bundle manually:
CONFIG=debug scripts/build-release.sh
open "dist/Resolution Mapper.app"The VirtualDisplayBridge target is derived from SimpleDisplay, which is licensed under GPLv3.
GPLv3. See LICENSE.