Source

maximus-gnome-shell-extension /

Filename Size Date modified Message
maximus@mathematical.coffee.gmail.com
18 B
781 B
935 B
585 B
4.3 KB
25.8 KB
17.8 KB

Maximus GNOME Shell Extension

The Maximus GNOME Shell Extension attempts to emulate the Maximus package for the Ubuntu Netbook Remix.

That is, it removes decoration (i.e. the title bar) from maximised windows, saving vertical real estate. For example, Google Chrome does this by default. Useful for netbooks with small screens.

With Maximus Without Maximus
Using Maximus Without Maximus (title bar shows)

NOTE: with the titlebar of a window hidden, you may find it difficult to unmaximise/move a window. In this case, I recommend either remembering your system's keyboard shortcut for un/maximising a window (e.g. Alt+F10 on Fedora), or use the Window Options GNOME shell extension which adds a drop-down menu to the title bar in the top panel with these options (shameless plug, I wrote that one). You might also like the Window Buttons extension which adds the close, minimize, maximize buttons to the top panel.

Changelog (see Changelog file for further details):

  • v10 (e.g.o), v2.2 (tagged):
  • changed the default method to hide the titlebar to hopefully be more stable, if the user is not using the Ambiance or Radiance themes (the old set_hide_titlebar bookmark)
  • much code cleaning
  • various misc. fixes.
  • v4 (e.g.o), v1.3 (tagged):
  • added blacklists/whitelists
  • fixed bug where Maximus wouldn't work on windows with non EN-utf8 characters in the title (bug #4)
  • made it harder to get stuck in fullscreen mode (particularly thunderbird)
  • better behaviour when maximizing from fullscreen to halfscreen.

Written 2012 by mathematical.coffee mathematical.coffee@gmail.com.
Project webpage: at bitbucket.


Configuration

On GNOME 3.4+: use the prefs widget. On GNOME 3.2, modify extension.js:

Half-maximised windows

By default, only fully-maximised windows are undecorated. If you also want to undecorate half-maximised windows, edit the line in extension.js to change this line:

const undecorateHalfMaximised = false;

to this (change the false to true):

const undecorateHalfMaximised = true;

Blacklists and whitelists

From dev-version 1.3 onwards (v4 on e.g.o), there is support for a window blacklist/whitelist.

If a window is on the blacklist, then all windows except those in the blacklist will be affected by Maximus. If a window is on the whtielist, then only the windows in the whitelist will be affected by Maximus.

To set whether the list is a blacklist or whitelist, modify this line at the top of extension.js:

/*** Whitelists/blacklists ***/
const BLACKLIST = true; // if it's a white list, change this to FALSE

To add apps to the blacklist or whitelist, add them to the APP_LIST variable in extension.js. You have to add the window's application name (like 'thunderbird.desktop') for it to work.

To see what an application's window manager class is, open up an instance of it. Then press Alt + F2 and type lg. Go to the 'Windows' tab and note the app of the window in question (press Esc to exit).

Add this in to APP_LIST.


Installation

One-click install from extensions.gnome.org!

From this website:

  1. Download the .zip file on the Downloads page.
  2. Open gnome-tweak-tool, go to "Shell Extensions", "Install Extension" and select the .zip file.

Branch Info (for developers)

  • 'stable' branch works with GNOME 3.2+. No fancy prefs widget.
  • 'gnome3.4' branch: GNOME3.4+ with prefs widget.
  • 'default' branch: the gnome3.4+ development branch (has prefs.js). i.e. dev branch for 'gnome3.4'.
  • 'polyglot-dev' branch: the gnome3.2+ development branch (same as above but no prefs.js). i.e. dev branch for 'stable'.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.