Blur Cinnamon

UUID: BlurCinnamon@klangman
Last edited:
3 days ago 2025-03-30, 07:41
Last commit: [b80b13b2] Add/Update Finnish translations (#861)

Allows you to blur, colorize, desaturate and adjust the dimming of some Cinnamon Desktop components (i.e. Panels, Applet popup menus, Overview, Expo)

README

Close

Blur Cinnamon

A Cinnamon extension to Blur, Dim, Colorize, Desaturate and make transparent parts of the Cinnamon Desktop.

Cinnamon components you can effect (currently):

  1. The Overview
  2. The Expo
  3. The Panels
  4. Applet popup menus (i.e Menu menu, Calendar, etc.)
  5. The Desktop background image

Blurring can also be disabled if you just want a transparent or semi-transparent effect without blurring for Panels, Applet popup menu or the Expo.

Features

  • Gaussian blur algorithm (borrowed from the Gnome extension Blur-my-Shell) with a user configurable intensity
  • Simple blur algorithm (the Cinnamon built-in algorithm) which I would only recommend for very old computers
  • Dimming overlay with user configurable color and intensity (fully-transparent to a solid color)
  • Makes the Panels, Popup menus and the Expo transparent so that the desktop background image effects are visible
  • Allows you to adjust the color saturation of the Cinnamon components. You can reduced saturation all the way down to gray scale
  • You can use general settings for Popups/Panels/Overview/Expo/Background or use unique settings for each

Requirements

This extension requires Cinnamon 6.0 or better (i.e Mint 21.3 or better).

If you have installed any of the following Cinnamon extensions, you should disable them before enabling Blur Cinnamon:

  • Transparent panels
  • Transparent panels reloaded
  • Blur Overview

Using any of the above with Blur Cinnamon may have some odd side effects that would require a Cinnamon restart to resolve.

Limitations

  1. The Applet popup menu effects are intended to be used with the Cinnamon (6.4) theme or the Mint-Y dark desktop themes. The effects might work will with some other themes but I have not tested them so the effects might not work out just right. You can try the Mint-Y light themes but it might be hard to read the menu items without some playing around with the settings and the background image. To make sure that the blurred background does not spill over any rounded corners, the Main Menu rounded corners will be disabled when Main Menu effects are enabled. Menu Menu effects are disabled by default.
  2. The Applet popup menu effects works for all the applets that I have tested except "Cinnamenu", which uses a bit of an odd way to activate the popup menu, making it more difficult to intercept the menu open process so that I can change the menu's transparency setting.
  3. Currently, any windows that are moved such that they overlap with a panel or the Applet popup menus will not be visible beneath the panel/menus as you might expect with a transparent panel/menu. This is because the blur effect is applied to a user interface element that floats above all windows just like the panel floats above the windows. At some point I hope to look into allowing the blur element to appear below all windows rather than above and make the a optional behavior setting.
  4. If you disable effects for any Cinnamon component under the General tab of the setting dialog while any "Use unique effect settings" options are enabled under the other tabs, the components "effect setting" options under the other tabs will still be visible, but changing those setting will have no effect until you re-enable the component under the General tab. Ideally those effect setting would only be visible when the component is enabled under the general tab but Cinnamon setting support is a bit limited in this way.

Installation

  • Right click on the cinnamon panel and click "System Settings"
  • Click on the "Extensions" icon under the "Preferences" category
  • Click the "Download" tab and then click the "Blur Cinnamon" entry
  • Click the "Install" button on the right and then return to the "Manage" tab
  • Select the new "Blur Cinnamon" entry and then click the "+" button at the bottom of the window
  • Use the "gears" icon next to the "Blur Cinnamon" entry to open the setting window and setup the preferred behavior

Feedback

Please leave a comment here on cinnamon-spices.linuxmint.com or you can create an issue on my Github to give me feedback, make a suggestion or to report any issues you find.

If you like this Cinnamon extension, please give it a "star" here any maybe on my Github repository as well to encourage me to continue working on the project. Thanks!

Credits

Some code was borrowed from the BlurOverview Extension by nailfarmer.

The Gaussian effect code was borrowed from the Gnome Blur my shell extension by Aurélien Hamy.

The Blur Cinnamon icon was generated by Google Gemini

CHANGELOG

Open

Log In To Comment!

11 Comments

anik2k06
anik2k06-11 hours ago
best applet. but it is under-rated
VictorVolt
VictorVolt-3 weeks ago
nice extension, do you think it's possible for it to have some sort of hue/saturation option? like, if i have a transparent panel theme with blue outlines, wouldn't need the transparency effect but only a hue type of effect to change the outline colors of the theme. Also a brightness/contrast could also be interesting to make custom themes brighter or darker for panels and maybe for app themes aswell but that might be too far of a stretch, i mean my suggestions might be already too far of a stretch for a extension, but i'm curious to see if it is a possibility
Kevin Langman
Kevin Langman-3 weeks ago
I think it a good idea, but I think this type of feature belongs in it's own extension. This extension only modifies the theme settings so that the background effects are visible. We should have some extension that allows you to customise a theme. The other option is to use a theme editor and make a revision of the theme with the outline color changes applied.
Eugene
Eugene-4 weeks ago
A great extension that linux mint was sorely missing. If we could add separate "dimming overlay color" settings for the light and dark themes, it would be great.
Kevin Langman
Kevin Langman-4 weeks ago
Glad to hear you think it. So you are looking for two setting for the "color overlay" and for the extension to automatically switch which one if active based on if the system is using a light or dark theme?
EverydayLolicon
EverydayLolicon-1 month ago
Really like this addon, but for some reason popup menus show my wallpaper and not what's behind them, in an older version it worked like I would expect it to and didn't show the wallpaper, panel still works well though, is this a bug?
Kevin Langman
Kevin Langman-1 month ago
Glad you like the extension. In the 1st version there were no Applet popup menu effects at all so they would look like what your theme defines. In version 1.2.0 I added the ability to apply effects to just the Main Menu applet. With version 1.3.0 it can apply effects to all applet popup menus. At all times the Main Menu and applets popup menu effects were disabled by default so you had to go to the setting to enable it. If you perfer the Popup menus to have no effects then go to BlurCinnamon settings and disable the "Popup menus" option under the General tab. Hope this helps.
Michael Freeman
Michael Freeman-1 month ago
Absolutely beautiful so far, and a feature that Cinnamon has been missing for way too long! One thing I noticed (and I'm not sure if there's anything that can be done, but I thought I'd let you know) is that the applet menu blur seems to work perfect with everything except Cinnamenu. That applet wants to retain the theme default for some reason.
Kevin Langman
Kevin Langman-1 month ago
Ya, Cinnamenu is a bit different in how to opens, making it harder to intercept the open action. I mentioned this issue in the "Limitations" section above. I didn't spend much time yet on getting Cinnamenu to work, but I hope I can get it work with a bit more work.
angelotux
angelotux-1 month ago
wonderful extension
LouitLA
LouitLA-2 months ago
Thanks for the extension! This is a must-have tweak for me