https://github.com/umbrella22/glasstron
The go-to solution to Electron composition effects, such as blurry windows.
https://github.com/umbrella22/glasstron
Last synced: 4 months ago
JSON representation
The go-to solution to Electron composition effects, such as blurry windows.
- Host: GitHub
- URL: https://github.com/umbrella22/glasstron
- Owner: umbrella22
- License: apache-2.0
- Created: 2020-05-23T11:03:30.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-05-19T22:23:18.000Z (over 5 years ago)
- Last Synced: 2025-06-09T09:23:56.159Z (4 months ago)
- Homepage:
- Size: 774 KB
- Stars: 1
- Watchers: 0
- Forks: 14
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Glasstron
A simple and reliable API to achieve blur and transparency across platforms (Windows/Linux/MacOS), so you don't have to panic with Electron bugs and messy code! Plus, it's really simple!
[](https://ko-fi.com/K3K3D0E0)
[](https://patreon.com/arytonex)
[](https://discord.gg/SftnByN)
## Quickstart
```bash
$ npm install glasstron
```
```js
const glasstron = require('glasstron');
glasstron.init(); // Call it before requiring electron!
const electron = require('electron');
let win;
electron.app.on('ready', () => {
win = new electron.BrowserWindow({
width: 800,
height: 600,
// ...
});
glasstron.update(win, {
windows: {blurType: 'acrylic'},
// ^~~~~~~
// Windows 10 1803+; for older versions you might want to use 'blurbehind'
macos: {vibrancy: 'fullscreen-ui'},
linux: {requestBlur: true} // KWin
});
});
// ...
```
## Why Glasstron?
### The problem
Let's face it: achieving composition effects on Electron is painful. For reference, here's quick summary of the amount of problems that arise when trying to blur the background of a window while keeping cross-compatibility.
- On Windows: There are plenty of Node bindings, but this means having to recompile them everytime a new Electron version comes out (and there's a chance you relied on unmaintained bindings, so you'll have to switch to a new project). Plus, you lose Aero Snap features if you aren't careful enough.
- On macOS: Achieving transparency and vibrancy on a window means that the `backgroundColor` window option must be set to transparent. Then, you must not call `win.setBackgroundColor()` or else it all breaks. (Tested on Electron 7.1.11 -- I hope this changed with more recent versions of it)
- On Linux: there's literally nothing to request blurriness. No bindings at all. Nothing.
### The solution
Glasstron takes care of those problems and it also aims to support composition effects on Linux. Its ease of use is a distinct feature, so it can be adopted in both new and running projects. It supports Electron 7.1+ without any problem (that's a bold claim, if I am wrong please open an issue).
## Design and features
Glasstron replaces Electron's `BrowserWindow` export with a modified version that's capable to deal with the common problems discussed earlier on its own. This means that it's simple to adopt and it doesn't break existing code as every call to broken methods is wrapped so nothing bad happens.
In order to achieve blurriness on Windows, Glasstron calls an external tool (its own bundled `swca` application). This means that nothing will randomly break across Node versions.
It also replaces the functionality of`win.setBackgroundColor()`: since there's no way to set a background color without breaking vibrancy materials on macOS, it will set the background color as injected CSS on the `:root` CSS selector. It can be overridden by CSS stylesheets, so be careful! (this was intended -- check the other project [Glasscord](https://github.com/AryToNeX/Glasscord) to know why).
## I want to contribute to this madness!
Did you find a bug? File it in the issues section!
Do you know how to fix stuff? Make a pull request!
Or perhaps you want to send me a hug and a coffee? You can do so [here](https://ko-fi.com/arytonex)!
## Awesome applications using Glasstron
- [Glasscord](https://github.com/AryToNeX/Glasscord)
- [Android Messages](https://github.com/katacarbix/android-messages) by katacarbix
- Want yours featured? Issue a PR!
## License
### Glasstron is licensed under the Apache 2.0 License
```
Copyright 2020 AryToNeX
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```