Enable darker-than-dark dimming for internal and external screens.
Available for macOS, Windows and Linux (Beta).
Tested on macOS Sierra, Windows 10 Anniversary. Beta support for Ubuntu 16.10.
Small resource footprint, minimal User Interface.
Settings are persisted and restored per-Display without any configuration.
Heading out? Disconnecting and reconnecting external displays are handled seamlessly.
GitHub-based workflow, MIT licensed.
Download the latest version of Desktop Dimmer on the Releases page.
Installation as Commandline Tool
npm install --global desktop-dimmer # Installs the node CLI moduledesktop-dimmer # Runs it
Clone the repo and install dependencies.
git clone https://github.com/sidneys/desktop-dimmer.git desktop-dimmercd desktop-dimmernpm install
npm run start
Run the app with integrated Electron.
npm run startnpm run start:dev # with Debugging Toolsnpm run start:livereload # with Debugging Tools and Livereload
npm run localsetup
Install the app in the System app folder and start it.
npm run localsetupnpm run localsetup:rebuild # Build before installationnpm run localsetup:rebuild:dev # Build before installation, use Developer Tools
npm run build
Build the app and create installers (see requirements).
npm run build # build all available platformsnpm run build macos windows # build specific platforms (macos/linux/windows)
- Building for Windows requires
mono(on macOS, Linux)
- Building for Linux requires
dpkg(on macOS, Windows)
- Only macOS can build for other platforms.
macOS Build Setup
Install Homebrew, then run:
brew install wine mono fakeroot dpkg
Linux Build Setup
sudo apt-get install wine mono fakeroot dpkg
Turnkey build-in-the-cloud for Windows 10, macOS and Linux.
The process is managed by a custom layer of node scripts and Electron-optimized configuration templates. Completed Installation packages are deployed to GitHub Releases. Builds for all platforms and architectures take about 5 minutes. Backed by the open-source-friendly guys at Travis and AppVeyor and running electron-packager under the hood.
- Fork the repo
- Generate your GitHub Personal Access Token using "repo" as scope. Copy it to the clipboard.
- macOS + Linux
Add a new Tag to start the build process:git tag -a v1.0.1git push --tags
The builds are started in parallel and added to the "Releases" page of the GitHub repo (in draft mode).
Use the editing feature to publish the new app version.
There is no step 3
- Colored Shades
- In-App Updates (Squirrel)
- Signed binaries
- E2E Testing (Spectron)
- Gitter Developer Chat
- Issues File, track and discuss features and issues
- Wiki Read or contribute to the project Wiki