Skip to main content

Lightweight Django Admin plugin to see who is logged in and active. Supports, GeoIp , user-agents and django-ipware.

Project description

A lightweight Django Admin plugin showing who’s logged in from where using the cache. Supports Telize, django-ipware, user-agents and GeoIP




  • Make sure you have Django’s Cache backend set up.

  • Install using pip: pip install django-whoshere

  • Add django_whoshere to INSTALLED_APPS in

        # other apps
  • Add django_whoshere.middelware.TrackMiddleware to your MIDDLEWARE_CLASSES. Make sure it comes after your Authentication middleware.

    # other middleware
   # more middleware



No configuration is needed but these settings are provided for convenience:

  • WHOSHERE_TIMEOUT = 300 Sets the timeout for user activity. Defaults to 300 seconds.

  • WHOSHERE_LABEL = 'Active Users' Overrides the admin link label. Defaults to ‘Active Users’

  • WHOSHERE_PREFIX = 'whoshere' Prefix used in cache keys. Defaults to ‘whoshere’.

  • WHOSHERE_TELIZE = True You can set this to ‘False’ to turn off geolocation lookups with Telize. Is always off if GeoIp is installed.

Template tags

Besides the admin interface, WhosHere’s functions are also available as template tags:

{% load whoshere %}

There are now {% active_user_count %} users logged in.

{% active_users as users %}
{% for user in users %}
   <li>{{ user.username }} ({{ }})</li>
{% endfor %}

<p>Your IP address is {% your_ip %}</p>
<p>Your browser and platform is {% your_agent %}</p>
<p>You live in {% your_city %}, {% your_country %}</p>


Originally this plugin started with GeoIP support only, but this means you have to install the rather large database that it comes with. Not a problem if you already use it for other things, but not a lightweight solution if you only use it for WhosHere. As an alternative WhosHere uses the free Telize API over HTTPS by default to find the location of your logged in users. This comes with some caveats:

  • The Telize API is opensource, but you are sending users IP addresses, albeit anonymously, to a third party.

  • Being a free API it can sometimes be unavailable or slow

  • Your server needs HTTPS access to a remote location

You can turn off Telize lookups with WHOSHERE_TELIZE = False in your or by installing and configuring GeoIP.


  • Middleware is kept as small as possible and only adds IP and User Agent to the cache for the current logged in user.

  • No database tables are used. Instead WhosHere uses a proxy model of the User model.

  • Proxy models will create migrations but do not affect your database

  • Telize lookups are cached for performance

  • Using the excellent requests library for better SSL support


  • Add tests

  • Think of other things to add

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-whoshere- (8.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page