Transparent panels

UUID: transparent-panels@germanfr
Last edited:
2 months ago 2020-07-12, 03:52
Last commit: [db13516c] transparent-panels: cinnamon 4.6 compatible

Transparentize your panels when there are no any maximized windows



Transparent panels - A Cinnamon extension

Transparentize your panels when there are no any maximized windows


Supported themes

Transparent panels supports every theme in principle, but there are some themes that may not fit well. For such cases, the authors (or users) of the theme may override the panel-transparent, panel-transparent-with-shadow and panel-semi-transparent classes in their cinnamon.css, which can be enabled in the extension preferences with the option "use current theme styles".


Cinnamon Spices

Download it from here or search for "Transparent panels" in your Cinnamon extension settings.

From source

To download the source and install it, execute the following as a normal user (you will need git).

$ git clone
$ cd cinnamon-transparent-panels/ && ./ install

The above will download the source from Github and it will be copied to your ~/.local/share/cinnamon/extensions/ folder. If you don't have git installed, you can download a zip from here, extract it and run $ ./ install.


See the list of changes on Github:


If you find any bug you can file an issue in the Github project page:

Make sure you have an updated version of Cinnamon and try to explain the more detailed you can what the problem is (don't just say "it doesn't work" because that doesn't help at all).

Please, do not post issues in the comments of the Cinnamon Spices website because it doesn't have a notification system and I rarely see it.


Contributions are welcome, also in form of translations. Please, submit pull requests to the repository not the spices repository, which is only a distribution channel (not even a mirror). What is in there is automatically generated and overwritten.


1) Is it possible to keep transparency always?

Yes, but you don't need this extension to do that. You can remove the background of your panels in the theme's cinnamon.css, and it will probably work better.

2) System warns this extension isn't compatible with the current version of Cinnamon.

Load it anyways. I have to update the list of compatible versions each time a new version is released, so I may have missed it but probably it still works. If it doesn't, please file an issue.

3) It doesn't work!

First, make sure you have the latest version of Cinnamon (or at least not a prehistoric one). I do not mantain backwards compatibility for too long, but I mark some points in time when the extension worked for that version. If you have an old version, find here a release that is compatible with your version of Cinnamon and install it manually. If it still doesn't work or you already had an updated version, please file an issue.


This extension is free software and it's licensed under GPL3. You should have received an unobfuscated copy of the source code. If you don't, you can get it on

Transparent panels - Cinnamon desktop extension
Transparentize your panels when there are no any maximized windows
Copyright (C) 2016  Germán Franco Dorca

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <>.

Log In To Comment!


Docmine17-1 month ago
elviolmp-2 months ago
When the windows is maximized, the panel lost transparency. See the video: Is this behavior normal?
elviolmp-2 months ago
Thank you... working fine again! As soon as possible, I will try translate to portuguese/Brazil.
elviolmp-2 months ago
Its causing error when session login... I've disabled at this time. I'll wait for, when possible, put a new (update) version on repository.
Dickanom-2 months ago
Bonjour j'adore cette extension mais j'ai un message d'erreur sous mint 20.. "cette extension n'est pas compatible avec cinnamon 4.6"
Ricky-del-3 months ago
This is a great work,but I would to have transparent panel when a program (like Chrome) is open in full screen.
mshmm-3 months ago
Great extension - thank you for this and continuing to support it.
ivanaponi-4 months ago
can we have a 100% invisible desktop extension please? Then we have an excuse not to work
Peter-4 months ago
Love it! Makes my desktops much more beautiful!
Mirko1984-6 months ago
Must-Have Tool for Linux! Perfect Work! Nothing to complain! Thank you!!!
piterpanter-7 months ago
działa na 19.3 mint cynamon
Tales Araujo
Tales Araujo-7 months ago
It would be awesome if we had the option to manually adjust the transparency level as well, b/c it may seem way too much transparent with some wallpapers.
Your Moms And Me
Your Moms And Me-8 months ago
Love it! Though you made a good point that I'll have to search for the cinnamon.css and turn it all transparent. --that is, if I have the energy to look that up. =P
PedePanoOriginal-9 months ago
Is it possible to have 2 instaces of this extension running at the same time? I want to have diffrent configs for top and bot panel...
Germán Franco
Germán Franco-9 months ago
No, it is not currently possible. But you have two options. You can choose which panels are affected by this extension if that helps, or you can modify the CSS of your theme to change the style of each panel when it is in the transparent state. See the readme for instructions.
mfreeman72-9 months ago
Doesn't seem to work with Cinnamon 4.4
WDVANECK-10 months ago
Looks nice. Thanks.
fluntelion-1 year ago
Germán, you should not try to be wiser than the Linux Mint developer team. When LM displays an urgent warning saying that your extension is not compatible to LM 19.2, then it IS not compatible. Full stop. Furthermore, there is no update available. Click the update icon yourself and you will see. Instead, there is another solution, namely uninstalling the extension and installing it anew afterwards. But this is not an UPDATE, right? Thus you should not have tried to lecture me but have given correct pieces of information. But this is not your long suit, is it?
Germán Franco
Germán Franco-1 year ago
It displays that message when your Cinnamon version does not appear in the list of supported versions in the metadata file. I added it last week, so you (actually) didn't have the latest version. If there is an issue with the updating process of xlets, then report it to the Cinnamon bug tracker. There is nothing more I can do from my side. And I wasn't trying to be rude. If you only say "it does not work" (without providing any more information), and I already fixed the error you are reporting, the only thing I can say is update your applet. Please understand that.
fluntelion-1 year ago
After the upgrade to Linux Mint 19.2, I got an error message saying that an applet, a desklet or an extension did not work and needed an update. It was clear that it was your extension: the panel was opaque. When trying to re-activivate it, I got an urgent warning saying that this extension is not compatible to LM 19.2 , and that activating it could damage the system. Good gracious! :-)) Would you please work on that issue? I do like 'Transparent panels' too much to do without it. Thanks a lot!
Germán Franco
Germán Franco-1 year ago
That issue is already fixed (see the comment below yours). Please update your applet. Also, this is not the place to report bugs. Please, next time do it in the bug tracker, providing all the information needed:
Danilo Ancilotto
Danilo Ancilotto-1 year ago
Just reporting, this applet still does not work on Cinnamon 4.2.2.
Germán Franco
Germán Franco-1 year ago
The issue should be fixed now. There was a delay in the security review system.
Márcio Indau
Márcio Indau-1 year ago
Great extension. Works flawlessly
GNU_Linux_User-1 year ago
This extension is a life-saver. Per-panel transparency: great!
Janne-d-Arc-2 years ago
I love this but the panel is a bit too transparent even with the "semi-transparent" setting, can the transparency level or color be adjusted?
Janne-d-Arc-2 years ago
Okay, I have figured out how to do it but I think it would be great to be able to adjust it from the extension settings. Thank you!
Fonstw-2 years ago
Although it doesn't change much, the fact that my panel turns transparent (with shadow) when I have nothing maximized, really gives it that "finishing touch"! I second what luukvbaal said below, though.
luukvbaal-2 years ago
Could this be made to work for two side by side windows extending over the full height of the screen? Such that the panel would not be transparent in this situation:
Germán Franco
Germán Franco-2 years ago
Indeed yes. I plan something like that in the future, but I can't promise anything.
Radoslav-2 years ago
Excellent extension! The best part: I don't have to add any repoes or run any shells because this extension is easily findable in the Extensions app. :D
Harkl-2 years ago
This little thingy is just great! Works perfectly well on LM 18.3 & Thunderbolt theme. Thank you very much for your work & your commitment.
milangfx-2 years ago
Cesar Olimpio
Cesar Olimpio-2 years ago
Doesn't turn transparent when I use Super+D
Germán Franco
Germán Franco-2 years ago
It does for me. Try restarting Cinnamon.
Humayun Kabir
Humayun Kabir-2 years ago
What is the parameters for "With shadow".. i want copy those parameter to my current theme.... And Thank you, Nice work.
Germán Franco
Germán Franco-2 years ago
You have to include the "panel-transparent" class in your theme to customize it.
Grigorijs-2 years ago
Very cool. With Mint-Y-Yltra-Dark theme works excellent.
Руслан Севрюков please fix the icon in the upper right corner and make the drop-down panel transparent too and this does not work when any window is maximized on the whole screen
Germán Franco
Germán Franco-2 years ago
Does this happen only when this extension is enabled? Please, if that's the case open an issue on GitHub so that I get notified. I don't get notified when people ask here and I probably won't see it. Issues page link:
Rudertier-3 years ago
Great extension. Works flawlessly with the light theme.
Kasper Wynne
Kasper Wynne-3 years ago
hello,is it possible to keep transparent while there is a maximized window?
Germán Franco
Germán Franco-3 years ago
Nope. You have to go the traditional way and use a transparent theme.
Chris D
Chris D-3 years ago
Is there any way to make the panel transparent in a theme like Arc, Pop, or Adapta?
Didier Tranda
Didier Tranda-3 years ago
Merci beaucoup pour la mise a jour pour mint 18.2 cinnamon ça fonctionne nickel ;)
Marcosdw-3 years ago
Does not work on Cinnamon 3.4.4 LM 18.2
Marcosdw-3 years ago
Delete all files Transparent panels reinstall work fine
yochananmarqos-3 years ago
It's not compatible with Cinnamon 3.4 on Linux Mint 18.2. I opened an issue <a href="">here</a>.
Germán Franco
Germán Franco-3 years ago
I already fixed it, I have to push it here. Meanwhile you can just dismiss it. I'ts just a warning but it is fully compatible.
Steve Murphy
Steve Murphy-3 years ago
If you upgrade from 18.1 to 18.2 it will throw an error unless you update the extension immediately prior to the upgrade. If you don't do that it's just a case of removing and readding the extension to get the fixed version.
Thiago Ponte
Thiago Ponte-3 years ago
Doesn't work with Linux Mint 18, Cinnamon 3.0.7
Germán Franco
Germán Franco-3 years ago
Keep in mind that version was old already when this extension was released. Some things may not work because I have no way to test it but the last time I checked it it was working fine. Submit the issue with more details and I'll see what can I do.
IniZio-3 years ago
Lovely extension!