|
| 1 | +# Resolution Menu |
| 2 | + |
| 3 | +Simple OS X status bar menu app to switch display modes / resolutions, with support for HiDPI (retina) modes. |
| 4 | + |
| 5 | +* For quick access, if you have 1 display only, the display modes can be found at the top level of the menu. For 2 or more displays, each display will have its own submenu. |
| 6 | + |
| 7 | +* The list of attached devices / supported display modes is refreshed each time the menu is opened; no need to ever refresh manually. |
| 8 | + |
| 9 | +* No color depth information is shown; if a resolution is available with different color depths, only the display mode with the highest color depth will be used. |
| 10 | + |
| 11 | +* `CoreGraphics` private APIs are used to access the HiDPI display modes; this might not get this app accepted into the Mac App Store. Also note that `CGDisplayIOServicePort()`, which is used to get to get the (localized) name of the displays, has been deprecated as of Mac OS X 10.9 (Mavericks). |
| 12 | + |
| 13 | +* To facilitate "Start at Login", the `ServiceManagement.framework` is used together with a helper app, which should work in a sandboxed environment as well (as long as the app lives in /Applications). |
| 14 | + |
| 15 | +## Enabling HiDPI display modes |
| 16 | + |
| 17 | +To enable HiDPI modes on a non-retina device, execute this in the Terminal app: |
| 18 | + |
| 19 | +``` |
| 20 | +sudo defaults write /Library/Preferences/com.apple.windowserver.plist DisplayResolutionEnabled -bool true |
| 21 | +``` |
| 22 | + |
| 23 | +Then, for the change to take effect, either log out and back in or restart your system. |
| 24 | + |
| 25 | +## Installation |
| 26 | + |
| 27 | +Just fetch a DMG from the [release section](https://github.com/robbertkl/ResolutionMenu/releases) section and drag the application bundle to your Applications folder. |
| 28 | + |
| 29 | +You might need to disable OS X Gatekeeper first: System Preferences > Security & Privacy > General tab > Allow apps downloaded from: Anywhere. |
| 30 | + |
| 31 | +## Authors |
| 32 | + |
| 33 | +* Robbert Klarenbeek, <robbertkl@renbeek.nl> |
| 34 | + |
| 35 | +## Credits |
| 36 | + |
| 37 | +* Thanks to [Alex Zielenski](https://twitter.com/#!/alexzielenski) for [StartAtLoginController](https://github.com/alexzielenski/StartAtLoginController), which ties together the ServiceManagement stuff without even a single line of code (gotta love KVO). |
| 38 | + |
| 39 | +* Thanks to [ExitMothership](http://exitmothership.deviantart.com) for his [LED Cinema Display Icon](http://exitmothership.deviantart.com/art/LED-Cinema-Display-Icon-331815542), which is used for the app icon. |
| 40 | + |
| 41 | +## License |
| 42 | + |
| 43 | +Resolution Menu is published under the [MIT License](http://www.opensource.org/licenses/mit-license.php). |
0 commit comments