Skip to content

Dj Signals Panel

Display registered Django signals and receivers, showing what fires and where.

DJ Signals Panel

Overview

Dj Signals Panel is a Django admin extension that gives you full visibility into your project's signal landscape - which signals are registered, which receivers are connected, and what that receiver code actually does.

It works great standalone, and also pairs seamlessly as a panel inside Django Control Room - a centralized dashboard that brings all your Django admin panels together in one place. Visit djangocontrolroom.com to learn more.

Features

  • Signal discovery - automatically discovers all registered Django signals across your project and installed apps
  • Receiver inspection - lists every connected receiver for each signal, including function name, module, file location, and sender
  • Source code viewer - inline syntax-highlighted source for each receiver, directly in the admin (opt-in via SHOW_SOURCE)
  • Additive module discovery - use SIGNAL_MODULES to include signals from modules not picked up automatically
  • Search & filter - search signals by name, module, or app; filter by app with a dropdown
  • Summary stats - at-a-glance counts for total signals, total receivers, and signals with no receivers
  • Dark mode support - respects Django admin's built-in dark/light mode toggle
  • django-unfold theme adapter - opt-in stylesheet that remaps colors to match django-unfold's accent/neutral palette (see Theme adapters)
  • django-jazzmin theme adapter - opt-in stylesheet that remaps colors to match django-jazzmin's Bootstrap 5 / Bootswatch palette (see Theme adapters)
  • AI Agent Integration (MCP) - exposes list_signals, get_receivers, find_signal_by_sender, and inspect_receiver tools so AI agents (Cursor, Claude, etc.) can introspect your signal landscape via dj-control-room's MCP server (see Panel Tools)
  • No migrations required - purely read-only introspection, zero database changes

Screenshots

Django Admin Integration

A DJ SIGNALS PANEL section appears in the Django admin alongside your models.

Admin Home

Browse all registered signals with summary stats. Search by name, module, or app and filter by app using the dropdown.

Signal List

Signal Detail

Drill into any signal to see its metadata and every connected receiver. Expand View Location to see the file path/line for each receiver, or View Source for syntax-highlighted source code inline (requires SHOW_SOURCE: True).

Signal Detail

django-unfold Theme

When running under django-unfold, enable the bundled unfold.css theme adapter via EXTRA_CSS to match the panel's colors to the host site's accent and neutral palette. This is opt-in - it is not applied automatically just because django-unfold is installed.

Signal List with django-unfold theme

Requirements

  • Python 3.9+
  • Django 4.2+

License

MIT License - see LICENSE for details.