Vapour

An opinionated window transparency tweak for macOS. Requires the ammonia tweak runtime.

Disclaimer

Vapour is still very much a work in progress. I am not responsible for bricked Macs, dead NAND chips, thermonuclear war, or you getting fired because the Finder failed. Please do some research if you have any concerns about features included in this tweak before installing it! YOU are choosing to make these modifications, and if you point the finger at me for messing up your device, I will laugh at you.

Installation

make
sudo make install

Tips

Vapour reads from both the app's and the global defaults domains. You can control Vapour features through macOS's built-in defaults command.

# Write a global setting
defaults write -g VapourEnabled -bool false
# Write an app-specific setting
defaults write com.example.MyApp VapourEnabled -bool true

Available settings

• VapourEnabled (boolean, default: true): Enable or disable Vapour.
• VapourOpacity (float, default: 0.97): Set the opacity level for windows.
• VapourOverrideColours (boolean, default: false): Enable or disable color overrides. Currently only works for dark mode.

Alternatively, you can build and use the Vapour Tweak Tool GUI application included in this repository to manage settings visually.