Awesome Open Source
Awesome Open Source

Discord overlay is deprecated

We are now developing Discover Overlay. We strongly advise you try that instead!

Discord Overlay for Linux

A QT browser window to overlay Discord activity over the screen. Screenshot Witch It Configuration


Python pip will deal with dependencies, but for posterity the script needs

qt5-webengine pyqt5 python-pyqtwebengine python-pyxdg



git clone
cd DiscordOverlayLinux
python -m pip install PyQtWebEngine
python -m pip install .


On first use a window will show with two buttons "Layout" and "Position"

The first allows you to choose which widget you want to use as your overlay, and make any changes to the style.

The second shows you which display and where on it the overlay will be placed.

Extra Overlays can be added at will

Known Issues

  • Unexpected Discord crashes will leave the overlay in the state it was last showing.
  • As this uses Discords StreamKit under the hood there is no way to interact with the overlay itself.

Tested configurations

  • Wayfire/Wayland - Works
  • Openbox/X11 - Works
  • Gnome/X11 - Works
  • Gnome/Wayland - Works

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (47,659
linux (2,134
discord (292
overlay (67

Find Open Source By Browsing 7,000 Topics Across 59 Categories