This module is intended to give an Electron BrowserWindow blur on its behind on Windows. Electron does not support 'blur behind' from a transparent window on Windows and this module uses native API calls to achieve the effect.
Since this is a native addon, you will need your platforms build tools. Visual Studio etc. Also Python for node-gyp
.
git clone https://github.com/levrik/electron-vibrancy-windows
cd electron-vibrancy-windows
yarn install
cd spec/app # Go to sample app
electron . # electron --version should be 1.7.6
To rebuild again:
yarn conf
yarn rebuild
Also available through NPM (not yet).
yarn add electron-vibrancy-windows
To run tests see scripts/ci
- Windows 10 (stable)
BrowserWindow
must be transparent. (transparent:true
)- Requires Windows 10 or higher.
- If you get
A dynamic link library (DLL) initialization routine failed.
error, it means that the module isn't compiled against Electron or compiled against the wrong version.
There are several methods depending on what you want to do and what platform you are on.
Returns Bool
.
window
BrowserWindow
instance
Enables or disables vibrancy for the WHOLE window.
Disables Vibrancy completely.
window
BrowserWindow
instance
// mainWindow with show: false
mainWindow.on('ready-to-show',function() {
var electronVibrancy = require('..');
electronVibrancy.enableVibrancy(mainWindow);
electronVibrancy.disableVibrancy(mainWindow);
mainWindow.show();
});
On Windows 10 the addon uses SetWindowCompositionAttribute
, which is an undocumented API, which means it can be changed by Microsoft any time and break the functionality.
This project is under MIT. See LICENSE