Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/NyaomiDEV/Glasstron
The go-to solution to Electron composition effects, such as blurry windows.
https://github.com/NyaomiDEV/Glasstron
acrylic api blur composition electron linux macos node vibrancy windows
Last synced: 3 months ago
JSON representation
The go-to solution to Electron composition effects, such as blurry windows.
- Host: GitHub
- URL: https://github.com/NyaomiDEV/Glasstron
- Owner: NyaomiDEV
- License: apache-2.0
- Archived: true
- Created: 2020-05-02T15:45:06.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-09-24T13:56:24.000Z (over 2 years ago)
- Last Synced: 2024-05-16T03:40:06.658Z (8 months ago)
- Topics: acrylic, api, blur, composition, electron, linux, macos, node, vibrancy, windows
- Language: JavaScript
- Homepage:
- Size: 1.96 MB
- Stars: 246
- Watchers: 5
- Forks: 13
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- Awesome - Glasstron - The go-to solution to Electron composition effects, such as blurry windows. (Development / Programming)
README
# This project is EOL. Please use other equivalent modules for your newer apps.
# 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://www.npmjs.com/package/glasstron)
[](https://www.npmjs.com/package/glasstron)
[](https://github.com/NyaomiDEV/Glasstron/tree/master)
[](https://ko-fi.com/K3K3D0E0)
[](https://patreon.com/nyaomipic)
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Y7ZAFZ2H56FD4)
## Quickstart
```bash
$ npm install glasstron
- OR -
$ yarn add glasstron
```
```js
const glasstron = require('glasstron');
const electron = require('electron');
electron.app.commandLine.appendSwitch("enable-transparent-visuals");
electron.app.on('ready', () => {
setTimeout(
spawnWindow,
process.platform == "linux" ? 1000 : 0
// Electron has a bug on linux where it
// won't initialize properly when using
// transparency. To work around that, it
// is necessary to delay the window
// spawn function.
);
});
function spawnWindow(){
win = new glasstron.BrowserWindow({
width: 800,
height: 600,
// ...
});
win.blurType = "acrylic";
// ^~~~~~~
// Windows 10 1803+; for older versions you
// might want to use 'blurbehind'
win.setBlur(true);
// ...
return win;
}
// ...
```
**NOTICE for projects using Webpack and similar:** Glasstron uses `__dirname` internally, so you have to define it as an external module, or else it won't work on Windows.
## 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 provides a custom version of Electron's `BrowserWindow` export 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.
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).
Note that Glasstron cannot do all the hard work (as with it prototype pollution will occur).
Please look inside `src/hacks.js` to see common problems Glasstron used to solve automagically up until version 0.0.3.
## 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/nyaomidev)!
## Awesome applications using Glasstron
- [Android Messages](https://github.com/katacarbix/android-messages) by katacarbix
- [Terminus](https://github.com/Eugeny/terminus) by Eugeny
- [Soundglass](https://github.com/pixldev/soundglass) by pixldev
- [Lightcord](https://github.com/Lightcord/Lightcord) by Lightcord
- [FalixNodes Desktop](https://github.com/FalixNodes-Software/FalixNodes-Desktop) by KorbsStudio
- [Glasstron Quick Start](https://github.com/KorbsStudio/glasstron-quick-start) by KorbsStudio
- Want yours featured? Issue a PR!
## Projects related to Glasstron
- [Blur my Shell](https://github.com/aunetx/blur-my-shell) is used by Glasstron to request blurring of windows to the GNOME Shell.
## License
### Glasstron is licensed under the Apache 2.0 License
```
Copyright 2020-2022 Naomi Calabretta
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.
```