Transparent panels

UUID: transparent-panels@germanfr
Last edited:
3 weeks ago 2021-09-26, 01:39
Last commit: [adc5c132] Updated Hungarian translation of extensions

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!


invernosantigos-8 months ago
I loved it ! But he makes permanent changes to the themes. So, wouldn't it be better to make them through aliases, or just create a modified copy of the originals? And I hope you will soon include a button to adjust the transparency of the themes - some, like Faded-dream and Cbblue, are TOO transparent and the text and icons on the fical panel are unrecognizable. For those who had the same problem as me: I managed to solve the problem by customizing the transparency manually using this tutorial: ( ) is in Portuguese, but nothing that google translate doesn't solve. But what I really dreamed of was getting a gradient effect on the panel like the one that appears in the "panel editing mode". Maybe in the future...
JoeJoeTV-9 months ago
Awesome Extension, I only have two suggestions: Would it be doable to add a toggle to enable making the panels opaque again, when having two or more windows tiled, but fully cover the screen. And, it doesn't seem to work, when using the "show desktop" applet, or any alternative. Keep up the good work!
moloch1994-1 year ago
Works perfectly, except for when I use the "show desktop" button. In that case it doesn't get transparent. Only when I minimize windows individually.
moloch1994-1 year ago
I take it back, it does work with the "show desktop" button SOMETIMES
Docmine17-1 year ago
elviolmp-1 year ago
When the windows is maximized, the panel lost transparency. See the video: Is this behavior normal?
elviolmp-1 year ago
Thank you... working fine again! As soon as possible, I will try translate to portuguese/Brazil.
elviolmp-1 year 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-1 year 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-1 year ago
This is a great work,but I would to have transparent panel when a program (like Chrome) is open in full screen.
mshmm-1 year ago
Great extension - thank you for this and continuing to support it.
ivanaponi-1 year ago
can we have a 100% invisible desktop extension please? Then we have an excuse not to work
Peter-1 year ago
Love it! Makes my desktops much more beautiful!
Mirko1984-1 year ago
Must-Have Tool for Linux! Perfect Work! Nothing to complain! Thank you!!!
piterpanter-1 year ago
działa na 19.3 mint cynamon
Tales Araujo
Tales Araujo-1 year 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-1 year 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-1 year 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-1 year 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-1 year ago
Doesn't seem to work with Cinnamon 4.4
WDVANECK-1 year ago
Looks nice. Thanks.
fluntelion-2 years 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-2 years 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-2 years 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-2 years 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-2 years ago
Just reporting, this applet still does not work on Cinnamon 4.2.2.
Germán Franco
Germán Franco-2 years ago
The issue should be fixed now. There was a delay in the security review system.
Márcio Indau
Márcio Indau-2 years ago
Great extension. Works flawlessly
GNU_Linux_User-2 years ago
This extension is a life-saver. Per-panel transparency: great!
Janne-d-Arc-3 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-3 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-3 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-3 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-3 years ago
Indeed yes. I plan something like that in the future, but I can't promise anything.
Radoslav-3 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-3 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-3 years ago
Cesar Olimpio
Cesar Olimpio-3 years ago
Doesn't turn transparent when I use Super+D
Germán Franco
Germán Franco-3 years ago
It does for me. Try restarting Cinnamon.
Humayun Kabir
Humayun Kabir-3 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-3 years ago
You have to include the "panel-transparent" class in your theme to customize it.
Grigorijs-4 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-3 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-4 years ago
Great extension. Works flawlessly with the light theme.
Kasper Wynne
Kasper Wynne-4 years ago
hello,is it possible to keep transparent while there is a maximized window?
Germán Franco
Germán Franco-4 years ago
Nope. You have to go the traditional way and use a transparent theme.
Chris D
Chris D-4 years ago
Is there any way to make the panel transparent in a theme like Arc, Pop, or Adapta?
Didier Tranda
Didier Tranda-4 years ago
Merci beaucoup pour la mise a jour pour mint 18.2 cinnamon ça fonctionne nickel ;)
Marcosdw-4 years ago
Does not work on Cinnamon 3.4.4 LM 18.2
Marcosdw-4 years ago
Delete all files Transparent panels reinstall work fine
yochananmarqos-4 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-4 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-4 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-4 years ago
Doesn't work with Linux Mint 18, Cinnamon 3.0.7
Germán Franco
Germán Franco-4 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-4 years ago
Lovely extension!