github-starred/MonitorControl: 🖥 Control your display's brightness & volume on your Mac as if it was a native Apple Display. Use Apple Keyboard keys or custom shortcuts. Shows the native macOS OSDs.

mirror of https://github.com/MonitorControl/MonitorControl.git synced 2026-05-16 06:05:52 -06:00

🖥 Control your display's brightness & volume on your Mac as if it was a native Apple Display. Use Apple Keyboard keys or custom shortcuts. Shows the native macOS OSDs.

apple brightness control ddc display external-monitor gamma keyboard m1 macos macos-app menubar osx shade silicon swift volume xcode

Find a file

waydabber 1bc725f790 Update README.md		2021-08-09 16:22:49 +02:00
.github	Add files via upload	2021-08-09 16:00:39 +02:00
MonitorControl	Option to hide menu icon	2021-08-09 15:52:26 +02:00
MonitorControl.xcodeproj	Moving all arm64 DDC stuff to Arm64DDCUtils.	2021-08-07 11:25:48 +02:00
MonitorControlHelper	Option to hide menu icon	2021-08-09 15:52:26 +02:00
.bartycrouch.toml	Further work on service matching. Hard part is done and seems to work.	2021-08-07 00:32:51 +02:00
.gitignore	Added a couple of basic entries back into gitignore	2020-09-19 14:17:33 +02:00
.swift-version	Various Enhancements (#66 )	2019-05-07 15:01:26 +02:00
.swiftformat	Add open sound/brightness preferences from media keys (#168 )	2020-05-31 18:06:30 +02:00
.swiftlint.yml	Fix DDC reliability on latest Xcode versions, migrate to SPM, more fixes (#453 )	2021-06-15 21:55:53 +02:00
Apple Silicon.md	Update readme	2021-08-07 22:17:12 +02:00
License.txt	🎉 1.0	2017-09-24 15:25:46 +02:00
README.md	Update README.md	2021-08-09 16:22:49 +02:00

README.md

MonitorControl - Now with Apple Silicon support!

Control your external monitor brightness, contrast or volume directly from a menulet or with keyboard native keys!

Translations: 🇬🇧 🇫🇷 🇩🇪 🇮🇹 🇷🇺 🇺🇦 🇯🇵 🇵🇱 🇭🇺

Bonus: using keyboard keys displays the native OSD

osd screenshot

State of the experimental Apple Silicon version

Check out the state of the experimental version here.

Test it at your own risk!

How to build this experimental branch

Required

Xcode
Swiftlint
SwiftFormat
BartyCrouch (for updating localizations)

Clone the project

git clone --single-branch --branch experimental/apple-silicon https://github.com/MonitorControl/MonitorControl.git

Then dependencies will automatically get downloaded when opening the project, if they don't:

File > Swift Packages > Resolve Package Versions

You're all set ! Now open the MonitorControl.xcodeproj with Xcode

Third party dependencies

How to help

Open issues if you have a question, an enhancement to suggest or a bug you've found. If you want you can fork the code yourself and submit a pull request to improve the app.

Download the pre-release version

Go to Releases and download the latest pre-release .dmg

Installing with Homebrew Cask

You can also install MonitorControl with Homebrew Cask.

Be aware that this command will not install the experimental Apple Silicon compatible version of the app!

brew install --cask monitorcontrol

Support

macOS Sierra (10.12) and up.
For the Apple Silicon version macOS Big Sur and up
Works with monitors controllable via DDC.

Contributors

Thanks

@bluejamesbond (original developer)
@Tyilo (fork)
@Bensge - (used some code from his project NativeDisplayBrightness)
@nhurden (for the original MediaKeyTap)
@kfix (for ddcctl)

For the 3.x.x versions:

@zhuowei (figured out M1 I²C communication)
@tao-j (figured out M1 I²C write)
@alin23 (generally spearheaded M1 DDC support and figured out a many of the caveats)
javierocasio (app icon background)