Marble shell theme

July 26, 2026 ยท View on GitHub

Shell theme for GNOME DE. Based on https://www.pling.com/p/1939902/.

Available colors: red yellow green blue purple or different Hue color.

๐Ÿž Screenshots

Click me ๐Ÿˆ

Icon theme: https://github.com/vinceliuice/Colloid-icon-theme

Overview [Blur My Shell / Light / Dark] (Neon Gas Station - AI Generated)

Overview with Blur My Shell Overview in light mode Overview in dark mode

Panel

Panel look

Quick settings (Fresh green leaves with fragile veins / Close-Up Photo of Wrinkled Parchment Paper)

Quick settings look

Modal dialog look

Calendar & notifications

Calendar & notifications look

Dash (Dash To Dock)

  • Position and size:
    • Icon size: 42px.
  • Appearance:
    • Shrink the dash.
    • Default opacity.

Dash look

๐Ÿšง Requirements

  • GNOME 42-50. Correct functionality on other versions is not guaranteed.
  • User Themes extension.
  • Python 3.10 or higher.

๐Ÿ’ก Installation

Important


If you have another theme installed globally (changed the appearance of the login window (GDM)), please remove it before installing this theme.

  1. Open the terminal.
  2. Clone the git repository and change the directory:
    git clone https://github.com/imarkoff/Marble-shell-theme.git
    cd Marble-shell-theme
    
  3. Run the program (install all accent colors, light and dark mode):
    python install.py -a
    
  4. After successful file creation open Extensions app, go to User Themes - ยทยทยท - Settings. User Themes in Extensions
  5. Select the shell theme you want.

Tip

For updating the theme, run the git pull command in the Marble-shell-theme directory and run the program again. If Marble theme is used, updates will be applied automatically.

Tip

If you want to install only one color, use the --red, --yellow, --green, --blue, --purple, --gray option.

Want to install a custom color, group buttons in the panel, use launchpad icon or some other tweaks? See the installation tweaks section for more information.

If you want to remove the theme, see the uninstallation section.

๐Ÿ–ฅ๏ธ GDM theme

GDM theme

Image: Network Abstract.

Config: sudo python install.py --gdm --blue --filled --gdm-image /path/to/image.jpg --gdm-blur=40 --gdm-darken=30

Warning


I am not responsible for any damage caused by the installation of the theme. If you have any problems, please open an issue.

๐Ÿšง Additional requirements

  • glib2-devel (libglib2.0-dev on Debian-based distros).
  • imagemagick (if you want to apply filters to the background image).
  1. Open the terminal.
  2. Go to the directory with the theme.
  3. Run the program with the --gdm option
    sudo python install.py --gdm (--your color) (--is filled)
    
    • Example:
      sudo python install.py --gdm --blue --filled
      
      sudo python install.py --gdm --gray --gdm-image /path/to/image.jpg --gdm-blur=40 --gdm-darken=30
      
  4. After successful file restart GDM service:
    sudo systemctl restart gdm
    
  • ๐Ÿ—‘๏ธ If you want to remove the theme or theme is broken, run the program with the --remove option:
    sudo python install.py --gdm -r
    
  • โ˜ ๏ธ If you got a death screen, you can switch to the console with the Ctrl + Alt + F3 key combination, log in, go to the Marble-shell-theme directory and run the command above. If it doesn't help, try reinstalling gnome-shell package.

๐Ÿฎ Installation tweaks

Tip

Wanna use accent color from your favorite wallpaper? Use Chromaflow.

Install default color

OptionDescription
-a, --allInstall all available colors
--redred theme only
--yellowyellow theme only
--greengreen theme only
--blueblue theme only
--purplepurple theme only
--graygray theme only

Tip

You can install several themes in one string: python install.py --red --green --blue

Tip

If you don't like these colors, you can change them in the colors.json file (after the elements).

Install custom color

OptionSecondary optionDescription
--hue(0 - 360)Generate theme from Hue prompt [0 - 360]
--nameNAMECustom theme name

Theme colors

OptionDescription
--filledMake accent color more vibrant
-O, --opaqueMake background color opaque (by default is translucent)

Optional theme tweaks

OptionSecondary optionDescription
--modelight / darklight / dark theme only
--sat(0 - 250)custom color saturation (<100% - reduce, >100% - increase)

GDM tweaks

OptionSecondary optionDescription
--gdm-image/absolute/path/to/image/set background image to GDM
--gdm-blur0+apply blur to image (px)
--gdm-darken0 - 100darken image (%)
--gdm-lighten0 - 100lighten image (%)

Panel tweaks

Panel default size Panel default size

Panel without button background Panel without buttons background

Grouped buttons in the panel Grouped buttons in the panel

Floating panel Floating panel

Always dark panel (ignores theme's dark/light mode) Always dark panel

OptionSecondary optionDescription
--panel-default-sizeset default panel size
--panel-no-pillremove panel button background
--panel-text-color#abcdefcustom panel HEX(A) text color
--panel-dark, --dark-panelapply dark theme to the panel
--wider-panelmake the panel a bit wider
--panel-grouped-buttonsgroup buttons in the panel
--floating-panelmake the panel floating (transparent panel background)

Overview tweaks

Launchpad icon

Dash with launchpad icon

CommandDescription
--launchpadChange Show Apps icon to macOS Launchpad icon

Examples

CommandDescription
-aInstall all accent colors with light & dark mode
--all --mode darkInstall all accent colors with dark mode only
--purple --mode=lightInstall purple accent color with light mode only
--hue 150 --name coldgreenInstall custom coldgreen accent color, light & dark mode
--red --green --sat=70red, green accent colors, 70% of the stock saturation
--hue=200 --name=grayblue --sat=50 --mode=darkcustom grayblue accent color, 50% of the stock saturation, dark mode
--gdm --blue --gdm-image /path/to/image.jpg --gdm-blur=40Install GDM theming in blue color with own GDM background image and blur

๐Ÿ—‘๏ธ Uninstallation / Reinstallation

  • To remove the theme, run the program with the --remove option:
    python install.py -ra
    
  • To reinstall the theme, run the program with the --reinstall option:
    python install.py -ri -a  # (other installation options)
    

Tip

If you want to remove the GDM theme, use the --gdm option with the --remove option.

The program allows you to specify the color of the theme and the mode to remove. For example, to remove purple and green themes in light mode, use the command:

python install.py -r --purple --green --mode light

Also, you can use the command above to reinstall purple and green themes in light mode with the --reinstall option.

python install.py -ri --purple --green --mode light

Options

OptionDescription
-r, --removeRemove the theme
-ri, --reinstallReinstall the theme