aa-killtracker

1.4.0 verified Mon Apr 27 auth: no python

An app for running killmail trackers with Alliance Auth and Discord. Current version: 1.4.0. Release cadence: irregular, minor updates.

pip install aa-killtracker

Common errors

error ModuleNotFoundError: No module named 'aa_killtracker' ↓

cause The package renamed its app to 'killtracker' in version 1.0.0.

fix

Use 'import killtracker' or 'from killtracker import ...' (without 'aa_' prefix).

error django.core.exceptions.ImproperlyConfigured: Application labels aren't unique, duplicates: killtracker ↓

cause Another app with same label 'killtracker' is installed (e.g., killtracker from another package).

fix

Remove duplicate or rename the conflicting app's label in its AppConfig.

error AttributeError: 'ESIClient' object has no attribute 'get_killmails' ↓

cause The ESI endpoint used by older versions changed. The library expects updated ESI client.

fix

Update Alliance Auth to >=3.0 and ensure ESI client is using latest version.

Warnings

breaking In version 1.x, the app name changed from 'aa_killtracker' to 'killtracker'. If you still have 'aa_killtracker' in INSTALLED_APPS, it will break. ↓

fix Replace 'aa_killtracker' with 'killtracker' in INSTALLED_APPS.

gotcha The Discord bot requires specific intents to be enabled in your Discord Developer Portal. Missing intents cause silent failures. ↓

fix Enable 'Server Members Intent' and 'Message Content Intent' in Discord Developer Portal.

deprecated Function 'killtracker.tasks.update_killmails()' is deprecated in 1.4.0. Use 'killtracker.tasks.update_killmails_batch()' instead. ↓

fix Replace with 'from killtracker.tasks import update_killmails_batch'.

Install

pip install aa-killtracker[discord]

Imports

Killtracker

wrong

from aa_killtracker.models import Killtracker

correct

from killtracker.models import Killtracker

Old import path used underscore. Use 'killtracker' (no aa_ prefix).

Killmail
wrong
```
from killtracker.models import KillMail
```
correct
```
from killtracker.models import Killmail
```
Model name is 'Killmail', not 'KillMail' (camelcase vs lowercase).

Quickstart

Add to Django settings INSTALLED_APPS. Requires Alliance Auth >= 3.0. Run migrations and collectstatic after.

from django.conf import settings
INSTALLED_APPS = settings.INSTALLED_APPS + ['killtracker', 'django_celery_beat']