https://github.com/mcluck90/auto-win-opacity
Automatically apply different opacity levels to windows on Windows
https://github.com/mcluck90/auto-win-opacity
nodejs opacity transparency windows
Last synced: 8 months ago
JSON representation
Automatically apply different opacity levels to windows on Windows
- Host: GitHub
- URL: https://github.com/mcluck90/auto-win-opacity
- Owner: MCluck90
- Created: 2018-05-16T20:45:30.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-05-18T13:59:17.000Z (about 8 years ago)
- Last Synced: 2024-08-10T00:11:23.174Z (almost 2 years ago)
- Topics: nodejs, opacity, transparency, windows
- Language: JavaScript
- Size: 3.66 MB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Automatic Window Opacity
I got really envious of *nix systems and their transparency options. So I decided to give myself similar control in Windows.
This provides a tool for automatically setting the opacity of different windows. Here's a screenshot of me editing this with opacity applied to Visual Studio Code.
And another with Spotify.
## Tested On
* Windows 10
## Installation
```bash
npm install -g auto-win-opacity
```
## Configuration
In the folder where it is installed, there should be a `config.json`. I've included a `config.example.json` which you can copy and rename to `config.json` to get started. An example configuration may look something like this:
```json
{
"pollInMilliseconds": 500,
"windows": [
{
"pattern": "^Slack",
"opacity": 210
},
{
"pattern": "- Visual Studio Code$",
"opacity": 230
}
]
}
```
The configuration includes a few options:
* `pollInMilliseconds`
* This is how often to check for changes in the config file and for new windows
* I personally have it set to run every 100 milliseconds and do not experience any issues but your mileage may vary.
* `windows`
* An array of window configuration settings.
Each window configuration setting is made up of two properties: `pattern` and `opacity`.
* `pattern`
* A string which will be interpreted as a regular expression
* `opacity`
* A number indicating how opaque the window should be
* Valid values are from 0 to 255, inclusive
* 0 means invisible. 255 means opaque
`pattern` is a string which will be converted into a regular expression. This will be matched against the title of the window. The system will look at every visible window and try to match the title against each pattern in order. As soon as a pattern matches, it will apply the matching opacity value and stop checking patterns. This is useful if you want to have different opacity settings for different states of a window. For example, say you wanted the GitHub homepage to appear transparent but everything else in the browser to be opaque. If you use Firefox, you could write something like this:
```json
{
"pollInMilliseconds": 100,
"windows": [
{
"pattern": "^GitHub - Mozilla Firefox$",
"opacity": 210
},
{
"pattern": "- Mozilla Firefox$",
"opacity": 255
}
]
}
```
## Usage
To start it, simply run
```bash
auto-win-opacity
```
To edit the config file, you can either open the `config.json` yourself or run
```bash
auto-win-opacity edit
```
**Note:** This will attempt to open the config in Visual Studio Code. It's my editor of choice so that's what it currently does.
If for some reason you decide it needs to stop, you can run
```bash
auto-win-opacity kill
```
This will stop the current process as soon as the polling periods ends.
## Advanced Usage
I like to have it run at startup in the background. I went ahead and included a very, very simple batch script here that you can link to in your startup folder. By default, this will make an empty command prompt window appear. There are ways of making it run in the background [which I will leave as an exercise for the reader.][1]
[1]: http://www.winhelponline.com/blog/run-bat-files-invisibly-without-displaying-command-prompt/