Skip to content

gabriellaraujocoding/xed-extra-plugins

Repository files navigation

Xed Extra Plugins

Xed Extra Plugins brings modern IDE-like features to Xed while preserving the speed, simplicity, and lightweight nature of a native GTK editor.

This repository is organized as one folder per plugin. Each folder contains its own .plugin descriptor and one or more .py files (plus a plugin-specific README).

Included plugins

  • xed-find-in-files: searches occurrences of an expression inside all files from a folder (grouped by file).
  • xed-git: highlights lines changed since the last commit (green=added, orange=modified, red=removed).
  • xed-indentation-guides: VS Code-like indentation guides inside the editor based on leading whitespace and tab width.
  • xed-quick-highlight: highlights occurrences of the currently selected text.
  • xed-smart-overview: fixes unexpected jumps and inconsistent dragging in Xed’s overview/minimap.
  • xed-source-code-browser: symbol tree (functions/classes/macros/variables, etc.) for the current document using ctags.
  • xed-split-pane: split workflow with a pinned LEFT pane + normal tabbed editor on the RIGHT.
  • xed-terminal: embedded VTE terminal in the bottom panel (tabs + preferences).

Download

Choose one of the options below:

Option 1: Git clone (recommended)

HTTPS:

git clone --depth 1 https://github.com/gabriellaraujocoding/xed-extra-plugins.git

SSH (only if you have GitHub SSH keys configured):

git clone --depth 1 git@github.com:gabriellaraujocoding/xed-extra-plugins.git

Option 2: Download ZIP (no Git required)

  1. Open the repository on GitHub
  2. Click the green Code button
  3. Click Download ZIP

Option 3: Download from Releases

  1. Open the Releases page on GitHub
  2. Open the latest release
  3. Download Source code (zip)

Install

Create the Xed plugins directory:

mkdir -p ~/.local/share/xed/plugins

Copy the plugin folder(s) you want:

cp -r xed-find-in-files ~/.local/share/xed/plugins/
cp -r xed-git ~/.local/share/xed/plugins/
cp -r xed-indentation-guides ~/.local/share/xed/plugins/
cp -r xed-quick-highlight ~/.local/share/xed/plugins/
cp -r xed-smart-overview ~/.local/share/xed/plugins/
cp -r xed-source-code-browser ~/.local/share/xed/plugins/
cp -r xed-split-pane ~/.local/share/xed/plugins/
cp -r xed-terminal ~/.local/share/xed/plugins/

Enable the plugins and restart Xed:

  • Edit → Preferences → Plugins

Uninstall

Remove the folder(s) and restart Xed:

rm -rf ~/.local/share/xed/plugins/xed-find-in-files
rm -rf ~/.local/share/xed/plugins/xed-git
rm -rf ~/.local/share/xed/plugins/xed-indentation-guides
rm -rf ~/.local/share/xed/plugins/xed-quick-highlight
rm -rf ~/.local/share/xed/plugins/xed-smart-overview
rm -rf ~/.local/share/xed/plugins/xed-source-code-browser
rm -rf ~/.local/share/xed/plugins/xed-split-pane
rm -rf ~/.local/share/xed/plugins/xed-terminal

Dependencies

On Linux Mint / Ubuntu / Debian, these plugins require:

Common (all plugins):

  • python3
  • python3-gi
  • gir1.2-gtk-3.0

Plugin-specific:

  • xed-find-in-files: optional ripgrep (recommended: faster searches), optional git
  • xed-git: gir1.2-ggit-1.0 + gir1.2-gtksource-3.0
  • xed-indentation-guides: gir1.2-gtksource-3.0
  • xed-quick-highlight: gir1.2-gtksource-3.0
  • xed-smart-overview: gir1.2-gtksource-3.0
  • xed-source-code-browser: ctags (recommended: universal-ctags)
  • xed-split-pane: no extra dependencies
  • xed-terminal: libvte-2.91-0 + gir1.2-vte-2.91

Install dependencies (Linux Mint / Ubuntu / Debian)

sudo apt update

# common
sudo apt install -y python3 python3-gi gir1.2-gtk-3.0

# GtkSourceView plugins: xed-git, xed-indentation-guides, xed-quick-highlight, xed-smart-overview
sudo apt install -y gir1.2-gtksource-3.0

# xed-git
sudo apt install -y gir1.2-ggit-1.0

# xed-source-code-browser
sudo apt install -y universal-ctags

# xed-terminal
sudo apt install -y libvte-2.91-0 gir1.2-vte-2.91

# xed-find-in-files (optional but recommended)
sudo apt install -y ripgrep

Package names may vary slightly on other distributions.

Quick checks

# common
python3 --version
python3 -c "import gi; from gi.repository import GLib; print('PyGObject OK')"
python3 -c "import gi; gi.require_version('Gtk','3.0'); from gi.repository import Gtk; print('GTK OK')"

# GtkSourceView (xed-git, xed-indentation-guides, xed-quick-highlight)
python3 -c "import gi; gi.require_version('GtkSource','3.0'); from gi.repository import GtkSource; print('GtkSource OK')"

# VTE (xed-terminal)
python3 -c "import gi; gi.require_version('Vte','2.91'); from gi.repository import Vte; print('VTE OK')"

# Ggit (xed-git)
python3 -c "import gi; gi.require_version('Ggit','1.0'); from gi.repository import Ggit; print('Ggit OK')"

# ctags (xed-source-code-browser)
ctags --version

# ripgrep (xed-find-in-files, optional)
rg --version

Debug

Run Xed from a terminal with the plugin debug variable:

  • xed-find-in-files:
    XED_DEBUG_FIND_IN_FILES=1 xed
  • xed-git:
    XED_DEBUG_GIT=1 xed
  • xed-indentation-guides:
    XED_DEBUG_INDENTATION_GUIDES=1 xed
  • xed-quick-highlight:
    XED_DEBUG_QUICK_HIGHLIGHT=1 xed
  • xed-smart-overview:
    XED_DEBUG_SMART_OVERVIEW=1 xed
  • xed-source-code-browser:
    XED_DEBUG_SOURCE_CODE_BROWSER=1 xed
  • xed-split-pane:
    XED_DEBUG_SPLIT_PANE=1 xed
  • xed-terminal:
    XED_DEBUG_TERMINAL=1 xed

Credits

  • Developed and maintained for Xed by Gabriell Araujo (2025-2026).
  • xed-git is based on the original gedit Git plugin by Ignacio Casal Quinteiro and Garrett Regier.
  • xed-quick-highlight is based on the original gedit Quick Highlight plugin by Martin Blanchard.
  • xed-source-code-browser is based on the original Pluma Source Code Browser plugin by Micah Carrick and MATE Developers.
  • xed-terminal is based on the original gedit embedded terminal plugin by Paolo Borelli.
  • Other plugins are inspired by ideas from Geany, Gedit, Pluma, and Visual Studio Code.

Licenses

This repository contains multiple licenses (per-plugin). You can also rely on each file’s SPDX-License-Identifier header.

Plugin folder SPDX license
xed-find-in-files GPL-2.0-or-later
xed-git GPL-2.0-or-later
xed-indentation-guides GPL-2.0-or-later
xed-quick-highlight GPL-2.0-or-later
xed-smart-overview GPL-2.0-or-later
xed-source-code-browser BSD-3-Clause
xed-split-pane GPL-2.0-or-later
xed-terminal GPL-2.0-or-later

The full license text for each plugin is available in each plugin folder (see the LICENSE file).

Screenshots

xed-find-in-files

xed-find-in-files

xed-git

xed-git

xed-indentation-guides

xed-indentation-guides

xed-quick-highlight

xed-quick-highlight

xed-source-code-browser

xed-source-code-browser

xed-split-pane

xed-split-pane xed-split-pane

xed-terminal

xed-terminal

About

Xed Extra Plugins brings modern IDE-like features to Xed while preserving the speed, simplicity, and lightweight nature of a native GTK editor.

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

 
 
 

Contributors

Languages