A fork of the Materia GTK theme.

Important information: Google announced that, from September 2026, Android devices will require ALL apps to be signed by Google, effectively leading to an iOS situation. Value your right to a computer that does what you want; do not tolerate this monopolistic practice! Contact me if you don't understand why it is bad. Click to learn more.

Update README.md

by roundabout, Saturday, 24 December 2016, 07:38:56 (1482565136), pushed by roundabout, Sunday, 11 May 2025, 13:22:04 (1746969724)

Author identity: nana-4 <hnmaigo@gmail.com>

48bb183f065ea162998fed6431f9736c1900e8ca

README.md

@@ -1,22 +1,23 @@

                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            Flat-Plat
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            =========
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        A Material Design-like theme for GNOME/GTK+ based desktop environments.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        Flat-Plat is a [Material Design](https://material.io/)-like theme for GNOME/GTK+ based desktop environments.  
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        It supports GTK3, GTK2, Metacity, GNOME Shell, Unity, MATE, LightDM and GDM.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            Features
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            --------
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        <img src="../images/Button.gif" alt="Button" align="right" />
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        <img src="../images/Button.gif" alt="Button" align="right"/>
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            * Supports ripple effect animations (only GTK3 apps).
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            * Supports both light and dark variants.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            * Supports dark or light titlebar versions.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            * Supports compact version for low resolution.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            * Supports [Dash to Dock](https://github.com/micheleg/dash-to-dock) extension's theming.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            * Supports [Workspaces to Dock](https://github.com/passingthru67/workspaces-to-dock) extension's theming.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        * Supports Chrome/Chromium theme and scrollbars extensions.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        * Supports Chrome/Chromium theme and scrollbars extension.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            * Appears more beautifully when you use a font family including `Medium` and `Light` weights.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            Requirements
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            ------------
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        * GTK+ 3.14, 3.16, 3.18, 3.20 or 3.22
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        * GTK+ 3.14 or later
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            * `gnome-themes-standard`
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            * pixmap (or pixbuf) engine
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            * murrine engine
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        

@@ -28,6 +29,9 @@ Requirements

                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            Installation
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            ------------
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        Arch Linux users can install from [the AUR package](https://aur.archlinux.org/packages/flatplat-theme/) maintained by [@cthbleachbit](https://github.com/cthbleachbit).
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        ### Manual Installation
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            1. Download an archive from the table.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                              |   | :black_circle:Dark titlebar | :black_circle:Dark titlebar (compact) | :white_circle:Light titlebar | :white_circle:Light titlebar (compact) |
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        

@@ -38,46 +42,57 @@ Installation

                                
                                
                                
                            
                                
                                    
                                        
                                            
                                              | GNOME 3.16 | n/a | n/a | [:arrow_down:v3.16.20160821](../../releases/download/v3.16.20160821/Flat-Plat-3.16.20160821.tar.gz) | n/a |
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                              | GNOME 3.14 | n/a | n/a | [:arrow_down:v3.14.20160921](../../releases/download/v3.14.20160921/Flat-Plat-3.14.20160921.tar.gz) | n/a |
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                              > **:beginner: Tips:**
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                          > * Choose from _GNOME 3.22_ if you are using ~~Unity 7.6 (Ubuntu 17.04)~~ or MATE 1.16.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                          > * Choose from _GNOME 3.22_ if you are using MATE 1.16.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                              > * Choose from _GNOME 3.20_ if you are using Unity 7.5 (Ubuntu 16.10) or MATE 1.14.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                              > * Choose from _GNOME 3.18_ if you are using Unity 7.4 (Ubuntu 16.04).
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            2. Extract it to the theme directory.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                              * for system-wide installation to `/usr/share/themes`
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                              * for user-specific installation to `~/.themes`
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        3. Select the theme via `gnome-tweak-tool` (or something else).
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        4. [Optional] Set the font size to `10.5` (= 14px) or `9.75` (= 13px).
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        3. Select the theme via `gnome-tweak-tool` or other suitable tools.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        4. [Optional] Set the font size to `10.5` (= 14px at 96dpi) or `9.75` (= 13px at 96dpi).
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            5. [Optional] Open the `chrome` folder and drag and drop the `.crx` files onto the Chrome/Chromium extensions page (`chrome://extensions/`).
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            #### Note if you want to clone from the repository
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            The `master` branch is currently being built for GNOME 3.22.  
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            If you want to use [other versions](../../branches/all), you need to specify the branch as follows:
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            git clone -b 3.18 https://github.com/nana-4/Flat-Plat.git
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        ```sh
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        git clone -b 3.18 https://github.com/nana-4/Flat-Plat.git
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        ```
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            GDM (Lock/Login Screen)
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            -----------------------
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        You can change the GDM theme by rewriting a system file.  
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        You can change the GDM theme by replacing the default GNOME Shell theme.  
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            But please **be careful** because if it fails, the desktop environment may not operate correctly.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            > **:warning: Warning:**
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            > * When applying this, other third-party GNOME Shell themes would look broken.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            > * If GNOME Shell has been updated, you will need to install this again.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            > * Not supported for GNOME 3.14.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        ### Install
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        ### Installation
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            1. Backup the existing `.gresource` file. _(Skip this step if you just update it.)_
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                                sudo cp -i /usr/share/gnome-shell/gnome-shell-theme.gresource /usr/share/gnome-shell/gnome-shell-theme.gresource~
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                          ```sh
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                          sudo cp -i /usr/share/gnome-shell/gnome-shell-theme.gresource /usr/share/gnome-shell/gnome-shell-theme.gresource~
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                          ```
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            2. Replace it with the new one.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                                cd /usr/share/themes/Flat-Plat || cd ~/.themes/Flat-Plat
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                                sudo cp -div gnome-shell/gnome-shell-theme.gresource /usr/share/gnome-shell
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        3. Restart GNOME Shell (press `Alt`+`F2`, then type `r`).
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                          ```sh
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                          cd /usr/share/themes/Flat-Plat || cd ~/.themes/Flat-Plat
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                          sudo cp -div gnome-shell/gnome-shell-theme.gresource /usr/share/gnome-shell
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                          ```
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        3. Restart GNOME Shell (press <kbd>Alt</kbd>+<kbd>F2</kbd>, then type `r`).
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        ### Uninstall
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        ### Uninstallation
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            1. Restore to original theme from the backup.
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                                sudo mv -iv /usr/share/gnome-shell/gnome-shell-theme.gresource~ /usr/share/gnome-shell/gnome-shell-theme.gresource
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        2. Restart GNOME Shell (press `Alt`+`F2`, then type `r`).
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                          ```sh
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                          sudo mv -iv /usr/share/gnome-shell/gnome-shell-theme.gresource~ /usr/share/gnome-shell/gnome-shell-theme.gresource
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                          ```
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        2. Restart GNOME Shell (press <kbd>Alt</kbd>+<kbd>F2</kbd>, then type `r`).
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            Screenshots
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            -----------
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        

@@ -106,7 +121,9 @@ Planned Features

                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            License
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                            
                                            -------
                                        
                                        
                                            
                                            
                                            
                                            
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        Flat-Plat is available under the terms of the GPL. See the `COPYING` file for details.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        > **:octocat: Notes:**
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        > * Included symbolic icons are based on [Material Design icons](https://github.com/google/material-design-icons) by Google.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        > * Chrome/Chromium scrollbars extension was forked from [Adwaita-chrome-scrollbar](https://github.com/gnome-integration-team/chrome-gnome-scrollbar) by GNOME Integration Team.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        Flat-Plat is available under the terms of the GPL. See the [`COPYING`](COPYING) file for details.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        Acknowledgments
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        ---------------
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        * The included symbolic icons are based on [Material Design icons](https://github.com/google/material-design-icons) by Google.
                                        
                                        
                                        
                                    
                                
                                
                                
                            
                                
                                    
                                        
                                        * Chrome/Chromium scrollbars extension was forked from [Adwaita-chrome-scrollbar](https://github.com/gnome-integration-team/chrome-gnome-scrollbar) by GNOME Integration Team.