extension.js

// You can do whatever you want with this code, but I hope that, if you want to
// improve it, you will talk to me so we can discuss and implement your idea into
// this very same extension. It's just to keep things neat and clean, instead of
// polluting EGO with plenty of similar extensions that do almost the same thing.
//
// If you want to debug this extension, open 'metadata.json' and set 'debug' to true.
// You can read the debugging messages in the terminal if you give the following:
// $ journalctl -f -o cat /usr/bin/gnome-shell

import Shell from 'gi://Shell';
import Meta from 'gi://Meta';
import * as Main from 'resource:///org/gnome/shell/ui/main.js';
import { Extension, gettext as _ } from 'resource:///org/gnome/shell/extensions/extension.js';

// Global variables
let ignoredWindows = [];

// Debug logging function
function logDebug(message) {
	console.debug(message);
}

// Populates the ignoredWindows array with windows that should not be minimized. 
// It iterates through the list of open windows and adds those that meet 
// the exclusion criteria to ignoredWindows.
function populateIgnoredWindows(windows) {
	for (let i = 0; i < windows.length; ++i) {
		let title = windows[i].title ?? '';
		let window_type = windows[i].window_type ?? '';
		let wm_classInitial = windows[i].wm_class ?? '';
		let wm_class = wm_classInitial.toLowerCase();
		
		logDebug(`Analyzing window ${i}:`);
		logDebug(`\t Title: ${title}`);
		logDebug(`\t Window Type: ${window_type}`);
		logDebug(`\t wm_class: ${wm_class}`);
		
		// Add windows to ignoredWindows based on type or title
		if (window_type === Meta.WindowType.DESKTOP) {
			logDebug(`\t ${title} ignored: window type is DESKTOP`);
			ignoredWindows.push(windows[i]);
			continue;
		}
		
		if (window_type === Meta.WindowType.DOCK) {
			logDebug(`\t ${title} ignored: window type is DOCK`);
			ignoredWindows.push(windows[i]);
			continue;
		}
		
		if (window_type === Meta.WindowType.MODAL_DIALOG) {
			logDebug(`\t ${title} ignored: window type is MODAL DIALOG`);
			ignoredWindows.push(windows[i]);
			continue;
		}
		
		if (title.startsWith('DING')) {
			logDebug(`\t ${title} ignored: title starts with DING`);
			ignoredWindows.push(windows[i]);
			continue;
		}
		
		if (wm_class.endsWith('notejot')) {
			logDebug(`\t ${title} ignored: wm_class ends with notejot`);
			ignoredWindows.push(windows[i]);
			continue;
		}
		
		if (wm_class === 'conky') {
			logDebug(`\t ${title} ignored: wm_class is conky`);
			ignoredWindows.push(windows[i]);
			continue;
		}
		
		if (wm_class === 'gjs') {
			logDebug(`\t ${title} ignored: wm_class is Gjs`);
			ignoredWindows.push(windows[i]);
			continue;
		}
		
		if (title.startsWith('@!') && (title.endsWith('BDH') || title.endsWith('BDHF'))) {
			logDebug(`\t ${title} ignored: title starts with @! and ends with BDH or BDHF`);
			ignoredWindows.push(windows[i]);
			continue;
		}
	}
}

// Removes the windows that should be ignored (in ignoredWindows) from the 
// full list of windows provided as input.
function pruneWindows(windows) {
	return windows.filter(window => !ignoredWindows.includes(window));
}

// Minimizes all windows except the currently focused window. 
// It first populates the ignoredWindows array and then prunes 
// the windows list to remove any windows that should be ignored.
function minimizeWindowsExceptFocused() {
	let metaWorkspace = global.workspace_manager.get_active_workspace();
	let windows = metaWorkspace.list_windows();
	
	populateIgnoredWindows(windows);
	windows = pruneWindows(windows);
	
	let focusedWindow = global.display.get_focus_window();
	if (focusedWindow) {
		logDebug(`Focusing on window: ${focusedWindow.title}`);
		for (let i = 0; i < windows.length; i++) {
			if (windows[i] !== focusedWindow) {
				logDebug(`Minimizing window: ${windows[i].title}`);
				windows[i].minimize();
			}
		}
	}
}

// Resets the ignoredWindows array. 
// This can be called when enabling or disabling the extension 
// to ensure the state is clean.
function resetToggleStatus() {
	ignoredWindows = [];
}

export default class extends Extension {
	// Called when the extension is enabled. 
	// Sets up the keybinding to minimize windows except the focused one.
	enable() {
		resetToggleStatus();
		Main.wm.addKeybinding(
			'hide-unfocused-shortcut',
			this.getSettings(),
			Meta.KeyBindingFlags.NONE,
			Shell.ActionMode.ALL, 
			() => {
				if (Main.overview.visible) {
					return; // Do nothing if the overview is open
				}
				minimizeWindowsExceptFocused();
			}
		);
	}
	
	// Called when the extension is disabled. 
	// Cleans up by resetting the ignored windows and removing the keybinding.
	disable() {
		resetToggleStatus();
		Main.wm.removeKeybinding('hide-unfocused-shortcut');
	}
}