Rounded Corners

UUID: RoundedCorners@klangman
Last edited:
1 week ago 2026-11-11, 07:27
Last commit: [0555e12e] RoundedCorners@klangman: Add el.po (#1230)

Allows you to round the corners of windows with custom borders and shadows

README

Close

Cinnamon Rounded Corners

A Cinnamon extension that allows you to round the corners of windows with custom borders and shadows.

Primary use cases:

  • Round window bottoms to match window tops.
  • Increase the radius of your theme's top corner rounding
  • Customize your window border
  • Use different border colors for different application, and/or the focused window
  • Customize your window shadows
  • Use different shadow strength the focused window

Features

  • Allows you to Round the top and bottom corners of application windows.
  • Adds custom borders and shadows to windows that have rounding effects applied
  • Allow you to exclude specific applications when rounding is enabled by default
  • Allows you to select specific applications to round when rounding is not enabled by default
  • Allows you to specify different borders setting (i.e colors) for different application windows
  • Allows for different custom borders and shadow strengths for the focused window vs. all the unfocused windows.
  • Has a border matching option allowing the border of the rounded corners to match the windows natural borders
  • Supports Gtk3, libhandy, Gtk4, Adwaita and Qt application windows. It should work reasonably well for just about any type of window

Requirements

This extension requires Cinnamon 6.0 or better (i.e Mint 21.3 or better). Using Cinnamon 6.8 (Mint 27) is highly recommended when it's available in late 2026 due to a VRAM leak (see below).

Limitations

Bottom corner cutting:

To achieve a rounded bottom corner a small part of the applications window will be cut off. Normally this is not a problem since applications rarely use that portion of the window. But this can be a problem for some applications, the most obvious one is Gnome Terminal. Characters in the far left or right of the terminals bottom row can be slightly cut off. There are a number of options to mitigate this if you find it unacceptable:

  1. Use a smaller corner radius

  2. Exclude Gnome Terminal from having its corners rounded

  3. Use some other terminal program that leaves a small space between the window bottom and the last line in the terminal (i.e Ghostty)

Reducing Top corner rounding:

The Rounded Corners extension can not square off corners that are already rounded by the system Applications Theme.

But you can override the theme's rounding using 2 CSS files.

The CSS code below will remove the title bar rounding completely so that you can use the Rounded Corners extension to define whatever rounding you like, even a rounding radius that is less than the themes default radius. It also removes borders.

~/.config/gtk-3.0/gtk.css

/* 1. Square off the title-bars for Gtk3 applications */
headerbar, .titlebar {
    border-radius: 0px;
    border-top-left-radius: 0px;
    border-top-right-radius: 0px;
    border: none;
    box-shadow: none;
}

/* 2. Window decorations only - skip popups (combobox/menu dropdowns) and tooltips,
      whose 1px border is drawn by the decoration's box-shadow */
window.csd:not(.popup):not(tooltip),
window.csd:not(.popup):not(tooltip) > decoration,
window.solid-csd > decoration,
window.ssd > decoration,
window.ssd > decoration:backdrop {
    border-radius: 0px;
    border-top-left-radius: 0px;
    border-top-right-radius: 0px;
    box-shadow: none;
}

~/.config/gtk-4.0/gtk.css

window {
    --window-radius: 0px;
    border-radius: 0px;
}

Some windows use their own custom title-bars. For those applications you will need to use a rounding radius that matches (or exceeds) the windows natural radius to avoid some unpleasant visual issues around the corners.

Shadows:

The stock shadows are by necessity removed by the corner effect. So this extension tells Cinnamon not to draw the stock shadows at all for windows that have cornet effects applied. The shadows need to be recreated for the clipped corners anyhow. A new shadow is therefore created in its place. By using a completely new shadow effect it gives you more control over how shadows appear. Keep in mind that the new shadow effect is only possible for windows that also have their corners rounded, see the "Corners" tab in the settings.

Borders:

It can be difficult to reconstruct matching borders around the clipped bottom corners. The default "Match the window's own border" option will attempt to detect the windows natural borders and recreate it for the rounded corner, and it does a surprisingly good job at that if I do say so myself. But I am sure there will be cases where the results are not perfect. I would suggest you apply custom borders for cases where the "Match" option is not working out well. Use the "Application borders" table under the "Borders" tab in the settings to define application specific border settings. Keep in mind that this extension will only apply borders to windows that also have corner rounding enabled under the "Corner" tab in the settings.

VRAM Leak:

There is a bug in the Clutter.ShaderEffect class causing a VRAM memory leak. A fix was submitted to Muffin to address the issue. The work-around is to use the Cinnamon.GLSLEffect class instead, but it has visual side-effects that I can't fix until a new API is available which lands in Cinnamon 6.8. For now I use caching to limit the leak to your maximum number of concurrent open windows. As soon as you update to Cinnamon 6.8 (Mint 27) the extension will automatically switch to GLSLEffect and eliminate the leak!

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 "Rounded Corners" entry
  • Click the "Install" button on the right and then return to the "Manage" tab
  • Select the new "Rounded Corners" entry and then click the "+" button at the bottom of the window
  • Use the "gears" icon next to the "Rounded Corners" 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

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

The Rounded Corners icon was generated by Claude AI. Claude was also used to speed up development of this extension and help with debugging some issues. Claude wrote 100% of the shadow effect code.

CHANGELOG

Open

Log In To Comment!

24 Comments

alternator1999
alternator1999-10 hours ago
Absolutely amazing extension. It makes Linux Mint look right. I prefer corners with a radius, and couldn't understand why they thought top-round & bottom square was a good look? The available themes seldom address this, but the problem is now solved. Thank-you so much for this super extension! ps Have you ever thought about doing a panel search applet, like Win 10/Win 11? KDE has MFile Finder and recently Fenestra Search. The slot/sausage adds a nice feature to the panel.
Kevin Langman
Kevin Langman-7 hours ago
Glad you like the extension. I suspect rounded bottoms was never considered because it cuts off a small part of the bottom of the windows which might be an issue in some cases. So a permanent rounded bottom is not a good solution in all cases yet the OS needs to look right in all cases. This extension gives you an option to exclude rounding on some applications which is a "work-around", fine for people who are willing to accept the minor drawbacks for an improved look. Your "search applet" idea is like the menu menu's search bar only placed on the panel?
davidbepo
davidbepo-1 week ago
yo klangman, thank you so much for this
Kevin Langman
Kevin Langman-1 week ago
Glad you like it.
RT Cunningham
RT Cunningham-2 weeks ago
I like this extension. Rounded corners on maximized windows looks nice on my 21-inch monitor, not so on my laptop. It must have something to do with bezels.
Kevin Langman
Kevin Langman-1 week ago
If you think it's an issue in the extension then feel free to post some screen shots into a Github issue on my repo. I'll see what I can do to improve it.
laservius
laservius-2 weeks ago
I really like how this extension looks, especially with the shadows under the windows. However, I am having a problem with it when I run a game on Steam. When I try to play the game Far Cry 5, it causes cinnamon to crash, or at least run in safe mode. The game will minimize to the panel, but if I click on it, it will play. I just have to restart cinnamon for the extras (extensions, desklets, etc.) to reload. This is directly caused by this extension, however, the Blur Cinnamon extension seems connected. I ran another game on Steam and it was fine, so it seems to have problem with how Far Cry 5 runs. However, Steam acts a little strange. First, when I scroll over the menus, the drop down menus have the "Focused window backlight effect" on, even though Steam is not a window I have set for Blur Cinnamon. If I turn off all the "Component specific settings" for windows off (even though Steam is not one of them) that backlight effect is still on Steam. If I turn off all of the settings off in the "General settings", that backlight effect is still on in Steam. It only turns of if I completely disable the Blur Cinnamon extension. When I start up Far Cry 5, it starts up Ubisoft Connect. That window has rounded edges and the border is blurred. Also, just before the Far Cry 5 start up window displays, there is a blurred rectangle where the window eventually opens. Then that window also has rounded edges and a blurred border. After this cinnamon crashes. I have excluded Steam, Ubisoft Connect, and Far Cry 5 in the settings for Rounded Corners. The corners are still rounded. Right now, the easiest solution is to just disable the Rounded Corners extension when I play the game. But I would like to know why steam is being affected by Blur Cinnamon, even though it hasn't been chosen to run with Blur Cinnamon. Also, I would like to know how to completely turn off Rounded Corners for the game so that I don't have to disable the extension each time I play it.
Kevin Langman
Kevin Langman-1 week ago
The Blur Cinnamon "Focused window backlight effect" is independent of all other options in Blur Cinnamon. To turn it off you just need to set the effect slider in Blur Cinnamon to 0.0. For the Cinnamon crash, are there any messages in ~/.xsession-errors that appear when the crash happens?
laservius
laservius-1 week ago
There are no error messages other than cinnamon goes into fallback mode and all extensions are stopped. This hasn't been a big deal. I just turn off the extension when I play that game. However, I found another conflict between this extension and Blur Cinnamon. None of the dynamic blurs, except for Monte Carlo work, when Rounded Corners is on. Either they show the window behind the current window as all white, show no window at all, or show strange halos around the windows in back. I seems that the problem is having the shadows on. If I turn that off, the weird halos disappear. However, when I have "Betterbird" in the background, it doesn't show up at all behind the current window. It's like I am using a static blur. I like the shadow, so that just means that I can't use a dynamic blur.
Kevin Langman
Kevin Langman-4 days ago
I have a fix for the halo problem. It's coming in the next release of BlurCinnamon, it's in my Repo I believe but I might have forgoten to document it in the update that included it.
laservius
laservius-1 day ago
Thanks!
claudiux
claudiux-2 weeks ago
Amazing extension! I love it (and I've liked it).
Kevin Langman
Kevin Langman-1 week ago
Thanks claudiux!
Kevin Langman
Kevin Langman-4 weeks ago
Glad people are enjoying the extension. I also need to thank Michael Freeman for doing a great job beta testing this extension. He found a few important issues during testing so the extension would not be what it is today without his help!
Michael Freeman
Michael Freeman-3 weeks ago
Ok, now I'm embarrassed. ;) Thank you, Kevin! By the way, you inspired me! You said in one of our discussions on Github that you used Claude to check your code and said it was "scary good". I've never been a fan of generative AI, but when you said that, I thought I would test how good it was, and I made a Cinnamon applet with it. I thought I'd share it, if you or anyone else is interested: https://github.com/mfreeman72/Unified-Tray I'm not sure if it's up to snuff with standards or anything, or worth putting in the Spices repository here, since I'm pretty new to applet coding, and it was done pretty much completely with AI. But it was an interesting experience that might be useful to someone other than just me.
angelotux
angelotux-3 weeks ago
I'm trying to make this applet with AI but I'm not succeeding https://extensions.gnome.org/extension/2986/runcat/
angelotux
angelotux-3 weeks ago
Great applet! Now you need to submit it to Cinnamon Spices.
NON-Specific94
NON-Specific94-4 weeks ago
I downloaded the extension and it’s brilliant. Cinnamon now looks beautiful and modern, so there’s no need to install external themes—thanks a lot, you’re doing a great job!
Kevin Langman
Kevin Langman-1 week ago
Thanks for the comment!
elliotbgz
elliotbgz-4 weeks ago
Finally!!! Looks so much better.
Kevin Langman
Kevin Langman-1 week ago
Glad you like it.
angelotux
angelotux-4 weeks ago
you finally gave coherence to linux mint
Kevin Langman
Kevin Langman-1 week ago
Thanks for the comment!
angelotux
angelotux-4 weeks ago
thank you so much