This guide is for those who are using LMDE and want to get their hands dirty with Gnome Shell 3.2 in all its glory. If you want to use Cinnamon, that handles things a bit differently (everything works out of the box), so you won't need to use this guide for that.
This How To was originally created when the packages were only in Sid, but since then Update Pack 4 has been released which has them included. You will also need to dip into Debian Testing in order to update gnome-tweak-tool, as the version supplied with Update Pack 4 is broken. Finally, your mileage may vary so please use the guide responsibly. Thank you.
Step 1: Updating Gnome Shell to 3.2
Anyway, the first thing to do is to grab the Gnome 3.2 packages if you don't have them already. Update Pack 4 is now available in Latest, so I'd recommend that you update to that if you are still on Update Pack 3 or earlier. Make sure you read the Update Pack Info to get a heads up on any possible quirks, crashes or random gremlins crawling out of your computer before you proceed. You can find that by clicking on the green 'i' icon in the Update Manager window.
You probably should reboot afterwards as the update is huge and affects many system files.
Step 2: Getting gnome-tweak-tool to play nice
Now, it's time to get gnome-tweak-tool to work. The version included with Update Pack 4 has a couple of known bugs which means that it won't work properly (or at all) without a few tweaks. There is a newer version in the Debian Testing repository that has fixed these bugs, so the easiest way would be to update the package to the Testing version.
What you will need to do is to temporarily enable the Testing respository and upgrade just the gnome-tweak-tool package, or install the package if you don't have it already, then disable Testing again. It shouldn't pull in any additional dependencies so it should be safe. Version 3.2.2-3 of gnome-tweak-tool and later will work properly.
Once that is done, you should be able to open Advanced Settings. From here you can control the font, theme, window button placement and some other things you can't tweak in the vanilla Gnome Shell interface (without having to go into gconf-editor).
Step 3: Installing extensions from the Gnome website
Now let's get some extensions working. The Gnome Shell Extensions website is live, which has been the subject of a great number of threads.
Just in case you don't know, the link is https://extensions.gnome.org/.
Here we install the Gnome Shell Integration plugin. I'd recommend using Firefox for this, as apparently the plugin doesn't yet work perfectly for WebKit-based browsers. This is where I then ran into my second problem. Installing any extension from the website did not work. The dialog popped up, but clicking Install did nothing. It turns out that there is a missing dependency it doesn't tell you about. Install unzip from the repository and that should fix the problem. Once you have extensions installed, you can control them in Advanced Settings.
It is possible to uninstall extensions using an interface, but this is only provided at the Gnome Shell Extensions website if you click on Installed Extensions. The website doesn't always work for me however as sometimes my extensions fail to show up. It also cannot uninstall extensions that have been installed system-wide. In those cases, you may need to manually uninstall them. For that, you must navigate to ~/.local/share/gnome-shell/extensions or /usr/share/gnome-shell/extensions, depending on where you installed it. Once there, delete the directory containing the extension you want to uninstall. When Gnome Shell is restarted, it should no longer be listed in Advanced Settings.
Step 4: Using custom shell themes
Finally, let's swap out the shell theme for something a bit shinier. This requires the user-theme extension. The Gnome website lists it, but that version is not compatible, as it has a different uuid to what gnome-tweak-tool is looking for. Instead, the best way to grab the extension is to install the gnome-shell-extensions package from the repository. This will install a few other extensions along with user-theme, but you can enable or disable them at will.
Now, in order to get the extension to appear in Advanced Settings, we need to reload the shell. Press Alt+F2. In the dialog, type 'r' and hit return. Sometimes it will crash and force you to logout. That sometimes happens when reloading the shell. After that, open Advanced Settings and in the Shell Extensions pane, enable the User Theme Extension. Close Advanced Settings. You might need to reload the shell again for this to take effect, although lately it seems to load up on the fly for me.
Once the shell is reloaded, open Advanced Settings again and navigate to the Theme pane. The Shell theme option should be active now.
The next step is to look for a theme to install. Mint-X already looks fantastic; it now seems to be based on Mint-Z, but it doesn't come with a shell theme on LMDE. So if you find the default shell theme a bit boring, you are going to want to look for one. There is a good selection on http://gnome-look.org, so find one that suits your tastes and enjoy.
In order to install a shell theme, you need to extract the theme directory to ~/.themes. The theme directory should be the one containing the gnome-shell directory. Once you have it installed, it should then be listed in Advanced Settings.
If you have used this guide before the 1.5 update (see edits at bottom of post)
Up until the 1.5 edit, the version of gnome-tweak-tool was broken and didn't work out of the box without a few tweaks to some system files. If you have used the guide before this and made those tweaks, there might be a bit of cruft left behind or a future update to either gnome-tweak-tool or gnome-shell-extensions could cause the other package to break. So this is how to return those files to normal.
First of all, uninstall both gnome-tweak-tool and gnome-shell-extensions. Next we need to delete the directory that used to be the old location for gnome-tweak-tool, if it exists. Even completely uninstalling the package will not remove this. Open up a terminal and look for the directory:
- Code: Select all
ls | grep gtweak
If the gtweak directory shows up, it will need to be deleted. If it's not there, then obviously you won't need to do this next bit.
- Code: Select all
sudo rm -r gtweak
Now that the system is clean, reinstall gnome-shell-extensions, and then grab the Testing version of gnome-tweak-tool.
Hope this has helped. I thought it was best to mention each issue I encountered, and if it helps other people out too, then great! If you spot that something is wrong in the guide, tell me and I'll correct it. Have fun!
1.7 - 12/04/06 16:29 - Update Pack 4 is now released with all packages apart from gnome-tweak-tool working out of the box. Add link to gnome-look.org; not sure why I didn't do that earlier.
1.6 - 12/03/05 04:05 - The fixed version of gnome-tweak-tool is now in Testing. Also, the Mint-Z theme seems to have been removed from the repository.
1.5 - 12/02/26 02:24 - A fixed version of gnome-tweak-tool has landed in Sid. There is no longer a need to tweak any system files now. Added instructions for those who used this guide before this update.
1.4 - 12/02/23 21:43 - Update Pack 4 is available for testing, which includes all the required packages. Add installation of the Mint-Z theme. Add note about Cinnamon. Elaborate on the user-theme uuid issue.
1.3 - 12/02/22 23:26 - The gnome-shell-extensions package has now migrated to Testing.
1.2.1 - 12/02/17 15:00 - Looks like the uuid of the user-theme extension from the Sid repository also needs to be changed for Advanced Settings to detect it. Add reasoning for this.
1.2 - 12/02/17 14:22 - There is a much easier way to install the user-theme extension which means simply installing a package from Sid. (thanks luis.nando!)
1.1 - 12/02/16 10:20 - Gnome 3.2 has landed in Testing, so it is no longer required to update to Sid.
1.0.2 - 12/02/16 10:02 - Add note that glib2.0-dev is needed in order to compile the user-theme extension.
1.0.1 - 12/01/02 04:30 - Fix quotation marks.