Zoom and Magnification on Fedora
You are reviewing a dense configuration file in the terminal and the font size is too small to distinguish between 0 and O. Or you are reading a PDF contract and the fine print blurs. You need the screen content to enlarge immediately, without navigating through menus. Fedora includes a magnifier in GNOME, but the controls live in three places: the Settings application, keyboard shortcuts, and the gsettings command line.
How the magnifier works
GNOME Magnifier captures the framebuffer and renders a scaled overlay on top of your desktop. The backend is the gnome-magnifier process. It listens to D-Bus signals from the shell to change state. When you toggle zoom, the compositor draws a new layer that tracks your input device.
The magnifier supports two rendering modes. Lens mode draws a floating window that follows the pointer. Full-screen mode scales the entire display area. The magnifier also supports three tracking modes: follow mouse, follow keyboard focus, and follow none. These modes are independent. You can have full-screen zoom that tracks the keyboard focus, which is useful for terminal work where the mouse pointer is irrelevant.
The magnifier relies on the same graphics stack as the shell. It uses EGL to attach to the compositor's rendering pipeline. If the graphics driver fails to provide a compatible surface, the magnifier window will appear black. This separation means the zoom works inside X11 applications, Wayland compositors, and the boot splash screen if the kernel parameter video=efifb:off is not blocking the framebuffer.
Check the process list before blaming the settings. If gnome-magnifier isn't running, the UI toggle is just a ghost.
Activate and configure zoom
Here is how to activate zoom instantly and verify the backend process is responding.
# Press Super+Alt+8 to toggle zoom. This sends a D-Bus signal to the shell.
# Check if the magnifier daemon is running. If this returns nothing, the service failed to start.
pgrep -a gnome-magnifier
# Inspect the current zoom factor. The default is 2.0x.
gsettings get org.gnome.desktop.a11y.magnifier magnification
Use gsettings to adjust zoom behavior without opening the Settings application. The gsettings command writes to the user database in ~/.config/dconf/user. These overrides take precedence over system defaults shipped in /usr/share/glib-2.0/schemas/.
# Set the zoom factor to 3.0x. Values between 1.0 and 20.0 are valid.
gsettings set org.gnome.desktop.a11y.magnifier magnification 3.0
# Change the lens mode. 'follow-mouse' is default. Use 'follow-keyboard' for terminal work.
gsettings set org.gnome.desktop.a11y.magnifier lens-mode follow-keyboard
# Enable full-screen zoom. The default 'lens' mode shows a window.
gsettings set org.gnome.desktop.a11y.magnifier zoom-mode full-screen
# Enable screen cursor highlighting. This draws a border around the mouse pointer.
gsettings set org.gnome.desktop.a11y.magnifier show-clicks true
Here is how to rebind the zoom toggle if the default key conflicts with another application. GNOME stores keybindings as arrays of strings.
# List current shortcut bindings for accessibility.
gsettings list-recursively org.gnome.desktop.wm.keybindings | grep zoom
# Set a custom toggle shortcut. Use 'F9' as an example.
gsettings set org.gnome.desktop.wm.keybindings toggle-magnifier "['F9']"
# Verify the new binding is active.
gsettings get org.gnome.desktop.wm.keybindings toggle-magnifier
The gsettings command is the safe interface for configuration. Editing ~/.config/dconf/user directly risks corrupting the binary database. Always use gsettings or dconf write. The database merges layers automatically. User settings override system defaults. System defaults override schema defaults.
Test the shortcut in a TTY. If zoom works in the GUI but not on the console, the issue is Wayland-specific, not a configuration error.
Verify the configuration
Run gsettings get org.gnome.desktop.a11y.magnifier zoom-mode to confirm the setting persisted. Move your mouse to the corner of the screen. The magnified region should track the pointer. If you set lens-mode to follow-keyboard, click inside a terminal window and press Tab. The magnifier should jump to the focused element.
If the zoom window appears but the content is black, check journalctl -xeu gnome-shell for rendering errors. The magnifier shares the EGL context with the shell. A black window usually indicates a driver mismatch or a compositor bug.
# Check for EGL errors in the shell logs.
journalctl -xeu gnome-shell | grep -i egl
# Look for surface creation failures.
journalctl -xeu gnome-shell | grep -i "Failed to create"
If the output shows EGL_BAD_CONFIG, the magnifier cannot attach to the graphics pipeline. This is common with proprietary NVIDIA drivers on older kernels. Ensure you are running the nvidia-driver package with Wayland support enabled. The black screen is a graphics stack symptom, not an accessibility bug.
Check the driver logs before changing zoom settings. A black magnifier window is a graphics stack symptom, not an accessibility bug.
Common pitfalls and recovery
If you see GDBus.Error:org.gnome.Shell.Error: Magnifier already running in the terminal, the shell believes the zoom is active even if you cannot see it. The state machine is desynced. This happens when the magnifier process crashes but the shell flag remains set.
gnome-magnifier[4521]: GLib-GIO-ERROR: GDBus.Error:org.gnome.Shell.Error: Magnifier already running
Kill the process and reset the flag. The shell will respawn the magnifier automatically on the next toggle.
# Kill the stuck magnifier process. The shell will respawn it automatically on the next toggle.
killall gnome-magnifier
# Reset the accessibility state to clear the desync.
gsettings reset org.gnome.desktop.a11y.magnifier zoom-enabled
# Force the shell to reload the accessibility configuration.
gsettings reset org.gnome.desktop.a11y.magnifier zoom-mode
Another common issue is the zoom factor drifting. If you change the factor via gsettings but the UI shows a different value, the dconf database might have a stale lock. Run dconf reset -f /org/gnome/desktop/a11y/magnifier/ to wipe all magnifier settings and restore defaults. This is a nuclear option. Use it only when the configuration is corrupted.
# Wipe all magnifier settings and restore defaults.
dconf reset -f /org/gnome/desktop/a11y/magnifier/
# Verify the reset took effect.
gsettings list-recursively org.gnome.desktop.a11y.magnifier
Reset the key before reinstalling packages. A stale dconf value survives dnf reinstall.
When to use magnification tools
Use GNOME Magnifier when you need visual enlargement of the entire desktop or specific windows.
Use Orca when you require audio feedback and screen reading capabilities alongside magnification.
Use browser zoom shortcuts when the content is confined to a web page and you do not need system-wide scaling.
Use xrandr scaling when you are running an X11 session and need to change the resolution multiplier for all applications.
Stay on the default lens mode when you want to see context around the magnified area. Switch to full-screen mode when you need maximum detail and do not care about peripheral vision.