Giter Site home page Giter Site logo

mario8888 / betterdummy Goto Github PK

View Code? Open in Web Editor NEW

This project forked from waydabber/betterdisplay

0.0 1.0 0.0 12.14 MB

Software Dummy Display Adapter for Apple Silicon/Intel Macs to Have Custom HiDPI Resolutions.

License: MIT License

Objective-C 8.10% Swift 91.90%

betterdummy's Introduction

App icon

BetterDummy

Dummy Display for Apple Silicon Macs to Have Custom HiDPI Resolutions - an app from one of the makers of MonitorControl.

Download for macOS



About

Some Macs tend to have issues with custom resolutions. The new Apple Silicon Macs notoriously don't allow sub-4K resolution displays to have HiDPI ("Retina") resolutions even though most 1440p display would greatly benefit from having a HiDPI "Retina" mode. On other Macs the resolution options for wide displays are too constrained. To fix these issues, some resort to buying a 4K HDMI dummy dongle to fool macOS into thinking that a 4K display is connected and then mirror the contents of this dummy display to their actual monitor in order to have HiDPI resolutions available. Others use the built in screens of their MacBooks as a mirror source. These approaches have obvious drawbacks and limits.

BetterDummy solves the problem by creating a flexible virtual "dummy" display that supports an unprecedented range of Retina resolutions. You can then utilize this dummy display as a mirror source for your display achieving any HiDPI resolution.

Advantages of BetterDummy over a physical 4K HDMI dummy plug or mirroring your internal display:

  • Your HDMI port will remain usable for an other display on the Mac Mini
  • Your internal screen will be available as an extended space on a MacBook (or you can use clamshell mode).
  • Does not suffer from issues that prevalent with the physical dummy (like jittery mouse cursor).
  • Offers a much wider range of HiDPI and standard resolutions.
  • Works with all aspect ratios, does not depend on what resoluations are recorded in the dummy's EDID/firmware.
  • Available instantly.

Some other uses:

  • The app is useful for anybody who is not satisfied with the offered default HiDPI resolutions offered by macOS.
  • Use headless Macs (servers) with any resolution and HiDPI mode for remote access.
  • Scale Sidecar resolutions.
  • Better quality zooming (System Preferences»Accessibility»Zoom) or High Quality screenshots even on 1080p displays.
  • You can use it instead of or alongside other apps that create custom native resolutions.

Usage

  1. Start the app
  2. In the app menu choose Create New Dummy and select your desired aspect ratio


  1. In System Preferences -> Displays you'll see the new Dummy display (for example Dummy 16:9)
  2. Activate mirroring. The Main display should be the Dummy display
  3. Set the Dummy display as Optimize for
  4. Set the Resolution as Scaled (you should hold the Option key while clicking on the Scaled option for a full list of resolutions!) or use the app's own resolution selector located in the app menu.
  1. Select the desired mode.

The app saves the dummy display configuration and automatically restores it upon next restart.

For more information on usage, see the the additional help section.

Notes:

  • The tutorial was compiled on macOS Monterey (for Big Sur as well - steps are slightly different, see this article on how to customize mirroring on Big Sur).
  • For most configurations, you'll see HiDPI 'Retina' resolutions in the list by default and see and additional non-HiDPI resolutions marked with a (low resolution) tag in the resolution list if Show all resolutions is toggled. On some configurations however, you might see HiDPI (high resolution) display modes marked with a (HiDPI) tag and standard resolutions without a tag.
  • You might have to fight a bit with macOS Monterey's new Displays tab in Preferences as the Optimize for setting tends to reset at random times to the physical display for unknown reasons during changing settings. If this happens, you can set it back to the Dummy.
  • You may want to enable the System Preferences»Notifications & Focus»Allow Notifications»When mirroring or sharing the display option to allow notifications when mirroring is turned on.

Installation

  • Download the latest release
  • Move the app to Applications
  • Start the app
  • Use the app menu bar item to interact.

Supporting the project

I am thankful for each of you who contributed to the project. Every little bit helps! If you find use in the app and did not contribute so far, please consider a donation so I can continue working on this app. :) Thank you!

Financial contributors (as of 4/12/2021, list is updated from time to time):

Alessio N.
Alex N.
André Heie Vik
Andre Khromov
Andrew Braithwaite
Angus
Arthur Muller
Chetan Kunte
Clark Jacobsohn
Danilo David Richardson
David Verdonck
David W
Dinko Belchevski
Florian Gross
Gavin Liu
Guest
Guest
Guest
Guest
Guest
Guest
Guest
Guest
Guest
Guest
guest-e3416f1d
Igor Yugay
Incognito
Incognito
Jérôme Seydoux
Jan Behrmann
Jari Hanhela
Jeff Lopes
JIANG Y
Julian Pawlowski
Justin Vanderhooft
kim
Knut Holm
Lorne Rutherford
m wang
Marco
Marco
Martin Clayton
Maurice Schleußinger
Michael Charo
Michael Charo
namor
Nick Lappas
Nikola Milojević
nilsonsfj
NP
Reactual
Rick
Splay Display
Stephen Richardson
Stephen Richardson
Sven Blum
tanerd
Tom Dai
Tomas Jelinej
vividfog
Will_from_CA - $100
William Edney
Wolf1701
Yurong You!

Join the list

Please don't forget to star the GitHub page and spread the word about the app. :)

Compatibility

  • The app should be compatible with all M1 class machines running macOS Monterey (MacBook Air, Mini, 2020 and 2021 MacBook Pros).
  • The app is also compatible with more recent Intel Macs and macOS Big Sur but mirroring might not work as expected (testing was limited to a single Intel Mac with Intel UHD 630 running Big Sur).
  • The app is compatible with headless mode as well (this was tested on Intel).

Known issues

Please take a look at the list of known issues before using the app or submitting an Issue.

Some notable articles on the net about BetterDummy

BetterDummy is famous! :)

Additional help

The following section and the screenshots are somewhat outdated as they represent app version 1.0.10.

For most of the time, the app is self explanatory but here is a brief overview of some of the additional functions in the app.

Manage your dummies


  • The Manage dummies submenu header contains some basic info about the dummy - its aspect ratio and unique serial number.
  • Connect dummy / Disconnect dummy - You can easily connect or disconnect a dummy. Only dummes that are not associated to a display can be connected or disconnected manually.
  • Set resolution - This allows for a quick resolution change. The list conatains all supported resolutions. If Show low resolution modes is enabled under Settings, then additional non-HiDPI resolutions are shown at the bottom of the list.
  • Associate with display or Change association - You can associate a dummy to a real display. This will make the dummy automatically connect or disconnect whenever the display is connected or disconnected. It is useful when docking/undocking your macbook so you don't have to manage your dummy manually every time.
  • Discard dummy - Destroys the dummy. Use it only if you don't need a dummy anymore - otherwise it is better to just disconnect or disassociate the dummy so macOS can remember the dummy for later use (by its unique serial number).

App settings


  • Start at login, Automatically check for updates - general options
  • Hide menu icon - when the menu icon is hidden, you can still change settings - simply launch the app again while it is already running and the menu icon will reappear.
  • Enable up to 16K resolutions - you can enable up to 16384x16384 resolution (this translates to 8192x8192 HiDPI). This is mostly useful for ultrawide and double-wide displays, where the standard 8192px max resolution might still be constraining. Use with caution as very high resolutions tax the system heavily.
  • Show low resolution modes in menu will allow you to set low (non-HiDPI) resolutions in the app menu under Manage dummies
  • Use mirrored dummy sleep workaround - macOS has a bug that makes virtual displays (like Sidecar, AirPlay, DisplayLink, BetterDummy) freeze when they act as a mirror main on some configurations. This workaround intends to solve that issue (more or less successfully).
  • Disconnect and reconnect on sleep - This disconnects dummies upon sleeps and reconnects them after wake.
  • Reset BetterdDummy - discard all dummies and reset all application settings to default.

Don't forget to check out

If you like BetterDummy, you'll like MonitorControl as well! Control the brightness, volume of your external display like a native Apple display! The two apps are fully optimized to work togeteher.

Thanks

Discord channel

You can join the (mostly self help) discussion on the new BetterDummy discord channel.

betterdummy's People

Contributors

waydabber avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.