github-starred/MonitorControl
2
0
Fork 0
mirror of https://github.com/MonitorControl/MonitorControl.git synced 2026-05-15 14:15:55 -06:00
Code Issues 21 Projects Packages Wiki Activity Actions

♻️ Refactoring

Browse source 
- Key handling is now done in the app, close #3
- All code linted with SwiftLint, close #4
- Better handling of built-in screen

Signed-off-by: Guillaume Broder <iamnotheoneyouseek@gmail.com>
This commit is contained in:
Guillaume Broder 2018-01-06 16:26:03 +01:00
parent 455775617c
commit 68afdda765
No known key found for this signature in database
GPG key ID: 66FB02D063D9E08F
25 changed files with 501 additions and 280 deletions
Download patch file Download diff file Expand all files Collapse all files

52
README.md
View file

@ -1,42 +1,47 @@
# MonitorControl
Control your external monitor brightness, contrast or volume directly from a menulet or with keyboard shortcuts :
- Brightness: `⇧` + `⌃` + `⌥` + `⌘` + `↑/↓` (Shift + Control + Alt + Command + Up/Down arrows)
- Volume: `⇧` + `⌃` + `⌥` + `⌘` + `←/→` (Shift + Control + Alt + Command + Left/Right arrows)
- Mute: `⇧` + `⌃` + `⌥` + `⌘` + `-` (Shift + Control + Alt + Command + Minus)
(Ps. The keyboard shortcut only work for the default screen)
Control your external monitor brightness, contrast or volume directly from a menulet or with keyboard native keys
![MonitorControl menulet](./.github/menulet.png)
*Bonus: Using keyboard keys display the native osd :*
![MonitorControl OSD](./.github/osd.png)
## Download
Go to [Release](https://github.com/the0neyouseek/MonitorControl/releases/latest) and download the latest `.dmg`
## Brightness/Volume default key
You can use [Karabiner Elements](https://github.com/tekezo/Karabiner-Elements/) to use the default mac key (`F1`, `F2` for brightness and `F10`, `F11`, `F12` for volume) with this set of custom rules :
[Karabiner rules for MonitorControl](./.github/rules.json)
## How to help
Copy and paste this url in your browser to install them directly :
Open [issues](./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.
```
karabiner://karabiner/assets/complex_modifications/import?url=https%3A%2F%2Fraw.githubusercontent.com%2Fthe0neyouseek%2FMonitorControl%2Fmaster%2F.github%2Frules.json
## How to build
### Required
- XCode
- [Cocoapods](https://cocoapods.org/)
- [SwiftLint](https://github.com/realm/SwiftLint)
Download the [zip](https://github.com/the0neyouseek/MonitorControl/archive/master.zip) directly or clone the project somewhere with git
```sh
$ git clone https://github.com/the0neyouseek/MonitorControl.git
```
---
Then download the dependencies with Cocoapods
Bonus: Using keyboard shortcuts display the native osd :
```sh
$ pod install
```
![MonitorControl OSD](./.github/osd.png)
You're all set ! Now open the `MonitorControl.xcworkspace` with Xcode
## TODO
### Third party dependencies
- [ ] Hande multiple screen for keyboard shortcut (Possibly the choice to have all screen brightness/volume increase/decrease at the same time or separatly)
- [ ] Skip Karabiner use for keyboard shortcut
- [ ] Option to start app at login
- [ ] Add [SwiftLint](https://github.com/realm/SwiftLint)
- [ ] Change App Icon
- [MediaKeyTap](https://github.com/the0neyouseek/MediaKeyTap)
## Support
- macOS Sierra (`10.12`) and up.
@ -45,4 +50,5 @@ Bonus: Using keyboard shortcuts display the native osd :
## Thanks
- [@bluejamesbond](https://github.com/bluejamesbond/) (Original developer)
- [@Tyilo](https://github.com/Tyilo/) (Fork)
- [@Bensge](https://github.com/Bensge/) - (Used some code from his project [NativeDisplayBrightness](https://github.com/Bensge/NativeDisplayBrightness))
- [@Bensge](https://github.com/Bensge/) - (Used some code from his project [NativeDisplayBrightness](https://github.com/Bensge/NativeDisplayBrightness))
- [@nhurden](https://github.com/nhurden/) (For the original MediaKeyTap)