Skip to content

Commit e31b360

Browse files
committed
add readme
1 parent 27fc7da commit e31b360

1 file changed

Lines changed: 35 additions & 0 deletions

File tree

README.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
<h1>
2+
<p align="center">Electron Transparency</p>
3+
4+
</h1>
5+
<p align="center">
6+
<i>Mica background for Electron apps</i>
7+
</p>
8+
<hr>
9+
10+
## About
11+
12+
Electron has a built-in feature to add transparency effects to the window. However, this feature has some limitations:
13+
14+
- The transparency effect is only applied to the window frame, not to the window content.
15+
- In order to apply the transparency effect to the whole window, `transparent` must be set to `true` in the `BrowserWindow` options. This creates a number of bugs which prevents the window from being resized or maximized. (see [this issue](https://github.com/electron/electron/pull/28207))
16+
17+
Electron Transparency aims to solve these issues by adding a native module which allows the transparency effect to be applied to the window content.
18+
19+
## Usage
20+
21+
See the example app [here](https://github.com/ItsPi3141/electron-transparency/tree/main/example)
22+
23+
### Installation
24+
25+
Install the module and electron-rebuild
26+
27+
```bash
28+
npm install electron-transparency @electron/rebuild
29+
```
30+
31+
Compile the native module
32+
33+
```bash
34+
npx electron-rebuild
35+
```

0 commit comments

Comments
 (0)