{"id":17004247,"url":"https://github.com/ppfeufer/aa-intel-tool","last_synced_at":"2026-01-05T22:20:01.668Z","repository":{"id":104336445,"uuid":"364708424","full_name":"ppfeufer/aa-intel-tool","owner":"ppfeufer","description":"D-Scans and more in Alliance Auth.","archived":false,"fork":false,"pushed_at":"2024-10-07T18:55:59.000Z","size":2938,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-31T10:43:41.791Z","etag":null,"topics":["allianceauth","chat-scan","d-scan","eve-online","fleet-composition","intel"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ppfeufer.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"ppfeufer"}},"created_at":"2021-05-05T21:18:57.000Z","updated_at":"2024-10-07T18:56:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"ce266574-7818-4988-8b8a-698bd48f3ce7","html_url":"https://github.com/ppfeufer/aa-intel-tool","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-intel-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-intel-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-intel-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-intel-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ppfeufer","download_url":"https://codeload.github.com/ppfeufer/aa-intel-tool/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223502361,"owners_count":17155938,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["allianceauth","chat-scan","d-scan","eve-online","fleet-composition","intel"],"created_at":"2024-10-14T04:43:09.832Z","updated_at":"2026-01-05T22:20:01.662Z","avatar_url":"https://github.com/ppfeufer.png","language":"Python","funding_links":["https://ko-fi.com/ppfeufer"],"categories":[],"sub_categories":[],"readme":"# AA Intel Tool\u003ca name=\"aa-intel-tool\"\u003e\u003c/a\u003e\n\n[![Badge: Version]][aa intel tool on pypi]\n[![Badge: License]][aa intel tool license]\n[![Badge: Supported Python Versions]][aa intel tool on pypi]\n[![Badge: Supported Django Versions]][aa intel tool on pypi]\n![Badge: pre-commit]\n[![Badge: pre-commit.ci status]][pre-commit.ci status]\n[![Badge: Code Style: black]][black code formatter documentation]\n[![Badge: Support Discord]][support discord]\n[![Badge: Automated Tests]][automated tests on github]\n[![Badge: Code Coverage]][aa intel tool on codecov]\n[![Badge: Translation Status]][weblate engage]\n[![Badge: Contributor Covenant]][code of conduct]\n\n[![Badge: Buy me a coffee]][ppfeufer on ko-fi]\n\nD-Scans and more in [Alliance Auth].\n\n______________________________________________________________________\n\n\u003c!-- mdformat-toc start --slug=github --maxlevel=6 --minlevel=2 --\u003e\n\n- [Overview](#overview)\n  - [Features](#features)\n  - [Screenshots](#screenshots)\n    - [Chat Scan](#chat-scan)\n    - [D-Scan](#d-scan)\n    - [Fleet Composition](#fleet-composition)\n- [Installation](#installation)\n  - [Step 1: Install the Package](#step-1-install-the-package)\n  - [Step 2: Configure Alliance Auth](#step-2-configure-alliance-auth)\n    - [Add the App to Alliance Auth](#add-the-app-to-alliance-auth)\n    - [Add the Scheduled Task](#add-the-scheduled-task)\n    - [(Optional) Allow Public Views](#optional-allow-public-views)\n  - [Step 4: Preload Eve Universe Data](#step-4-preload-eve-universe-data)\n  - [Step 5: Finalizing the Installation](#step-5-finalizing-the-installation)\n  - [Step 6: Update Your Webserver Configuration](#step-6-update-your-webserver-configuration)\n    - [Apache 2](#apache-2)\n    - [Nginx](#nginx)\n- [Settings](#settings)\n- [Changelog](#changelog)\n- [Translation Status](#translation-status)\n- [Contributing](#contributing)\n\n\u003c!-- mdformat-toc end --\u003e\n\n______________________________________________________________________\n\n## Overview\u003ca name=\"overview\"\u003e\u003c/a\u003e\n\n### Features\u003ca name=\"features\"\u003e\u003c/a\u003e\n\nThe following modules can be enabled or disabled.\nSee [Settings](#settings) section for details.\n\n- Chat scan module (Disabled by default due to its possible high number of ESI calls)\n- D-Scan module\n\n### Screenshots\u003ca name=\"screenshots\"\u003e\u003c/a\u003e\n\n#### Chat Scan\u003ca name=\"chat-scan\"\u003e\u003c/a\u003e\n\n![Image: Chat Scan Module]\n\n#### D-Scan\u003ca name=\"d-scan\"\u003e\u003c/a\u003e\n\n![Image: D-Scan Module]\n\n#### Fleet Composition\u003ca name=\"fleet-composition\"\u003e\u003c/a\u003e\n\n![Image: Fleet Composition Module]\n\n## Installation\u003ca name=\"installation\"\u003e\u003c/a\u003e\n\n\u003e [!NOTE]\n\u003e\n\u003e **AA Intel Tool \u003e= 2.0.0 needs at least Alliance Auth v4.0.0!**\n\u003e\n\u003e Please make sure to update your Alliance Auth instance _before_ you install this\n\u003e module or update to the latest version, otherwise an update to Alliance Auth will\n\u003e be pulled in unsupervised.\n\u003e\n\u003e The last version compatible with Alliance Auth v3 is `1.2.0`.\n\n**Important**: Please make sure you meet all preconditions before you proceed:\n\n- AA Intel Tool is a plugin for [Alliance Auth]. If you don't have Alliance Auth running\n  already, please install it first before proceeding. (see the official\n  [Alliance Auth installation guide] for details)\n- AA Intel Tool needs [Eve Universe] to function. Please make sure it is installed,\n  before continuing.\n\n### Step 1: Install the Package\u003ca name=\"step-1-install-the-package\"\u003e\u003c/a\u003e\n\nMake sure you're in the virtual environment (venv) of your Alliance Auth\ninstallation Then install the latest release directly from PyPi.\n\n```shell\npip install aa-intel-tool\n```\n\n### Step 2: Configure Alliance Auth\u003ca name=\"step-2-configure-alliance-auth\"\u003e\u003c/a\u003e\n\n#### Add the App to Alliance Auth\u003ca name=\"add-the-app-to-alliance-auth\"\u003e\u003c/a\u003e\n\nThis is fairly simple, configure your AA settings (`local.py`) as follows:\n\nAdd `eveuniverse` (if not already done so for a different app) and `aa_intel_tool` to\nthe list of `INSTALLED_APPS`.\n\n```python\n# Add any additional apps to this list.\nINSTALLED_APPS += [\n    \"eveuniverse\",\n    \"aa_intel_tool\",  # https://github.com/ppfeufer/aa-intel-tool\n]\n```\n\n#### Add the Scheduled Task\u003ca name=\"add-the-scheduled-task\"\u003e\u003c/a\u003e\n\nTo remove old scans from your DB, add the following task.\nThe retention time can be adjusted through the `INTELTOOL_SCAN_RETENTION_TIME` setting.\n\n```python\nif \"aa_intel_tool\" in INSTALLED_APPS:\n    # Run at 01:00 each day\n    CELERYBEAT_SCHEDULE[\"AA Intel Tool :: Housekeeping\"] = {\n        \"task\": \"aa_intel_tool.tasks.housekeeping\",\n        \"schedule\": crontab(minute=\"0\", hour=\"1\"),\n    }\n```\n\n#### (Optional) Allow Public Views\u003ca name=\"optional-allow-public-views\"\u003e\u003c/a\u003e\n\nThis app supports AA's feature of public views. To allow this feature, please add\n`\"aa_intel_tool\",` to the list of `APPS_WITH_PUBLIC_VIEWS` in your `local.py`:\n\n```python\n# By default, apps are prevented from having public views for security reasons.\n# To allow specific apps to have public views, add them to APPS_WITH_PUBLIC_VIEWS\n#   » The format is the same as in INSTALLED_APPS\n#   » The app developer must also explicitly allow public views for their app\nAPPS_WITH_PUBLIC_VIEWS = [\n    \"aa_intel_tool\",  # https://github.com/ppfeufer/aa-intel-tool\n]\n```\n\n\u003e [!NOTE]\n\u003e\n\u003e If you don't have a list for `APPS_WITH_PUBLIC_VIEWS` yet, then add the whole\n\u003e block from here. This feature has been added in Alliance Auth v3.6.0 so you\n\u003e might not yet have this list in your `local.py`.\n\n### Step 4: Preload Eve Universe Data\u003ca name=\"step-4-preload-eve-universe-data\"\u003e\u003c/a\u003e\n\nAA Intel Tool utilizes the EveUniverse module, so it doesn't need to ask ESI for ship\ninformation. To set this up, you now need to run the following command.\n\n```shell\npython manage.py aa_intel_tool_load_eve_types\n```\n\n### Step 5: Finalizing the Installation\u003ca name=\"step-5-finalizing-the-installation\"\u003e\u003c/a\u003e\n\nRun static files collection and migrations.\n\n```shell\npython manage.py collectstatic\npython manage.py migrate\n```\n\nRestart your supervisor services for Auth.\n\n### Step 6: Update Your Webserver Configuration\u003ca name=\"step-6-update-your-webserver-configuration\"\u003e\u003c/a\u003e\n\nBy default, webservers have a timout of about 30 seconds for requests. So we have to\ntweak that a little bit, since parsing intel data can take a while, and we don't want\nthe webserver to spoil our fun, right?\n\n#### Apache 2\u003ca name=\"apache-2\"\u003e\u003c/a\u003e\n\nOpen your vhost configuration and add the following 2 lines right after the\n`ProxyPreserveHost On` directive:\n\n```apache\nProxyTimeout 600\nTimeout      600\n```\n\nRestart your Apache2 service.\n\n#### Nginx\u003ca name=\"nginx\"\u003e\u003c/a\u003e\n\nOpen your vhost configuration and add the following lines inside the `location / {`\ndirective:\n\n```nginx\nproxy_connect_timeout 600;\nproxy_read_timeout    600;\nproxy_send_timeout    600;\nsend_timeout          600;\n```\n\nRestart your Nginx service.\n\n## Settings\u003ca name=\"settings\"\u003e\u003c/a\u003e\n\nTo customize the app, the following settings are available and can be made in\nyour `local.py`.\n\n\u003e [!WARNING]\n\u003e\n\u003e Enable the chat scan module at your own risk. This module has the potential to\n\u003e generate a huge number of ESI calls, which CCP might not be too happy about.\n\n| Name                              | Description                                                                                                                             | Default |\n| :-------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------- | :------ |\n| INTELTOOL_ENABLE_MODULE_CHATSCAN  | Enable or disable the chat scan module.                                                                                                 | False   |\n| INTELTOOL_ENABLE_MODULE_DSCAN     | Enable or disable the d-scan module.                                                                                                    | True    |\n| INTELTOOL_ENABLE_MODULE_FLEETCOMP | Enable or disable the fleet composition module.                                                                                         | True    |\n| INTELTOOL_SCAN_RETENTION_TIME     | Set the time in days for how long the scans will be kept in the database. Set to 0 to keep scans indefinitely.                          | 30      |\n| INTELTOOL_CHATSCAN_MAX_PILOTS     | Set the limit of pilots for chat scans, since these can take quite a long time to process. Set to 0 to disable.                         | 500     |\n| INTELTOOL_DSCAN_GRID_SIZE         | Set the grid size for D-Scans.\u003cbr/\u003eThis defines the size of the grid in km in which ships and structures are considered to be \"on grid\" | 10000   |\n\n\u003e [!NOTE]\n\u003e\n\u003e **A word about the chat scan limitations:**\n\u003e\n\u003e It is advised to keep the `INTELTOOL_CHATSCAN_MAX_PILOTS` to a sane number. Large\n\u003e chat scans can take quite some time to parse and from a certain number of pilots, the\n\u003e bottleneck might be your browser refusing to render the results page.\n\u003e (Source: Trust me, bro …)\n\n## Changelog\u003ca name=\"changelog\"\u003e\u003c/a\u003e\n\nSee [CHANGELOG.md]\n\n## Translation Status\u003ca name=\"translation-status\"\u003e\u003c/a\u003e\n\n[![Translation status](https://weblate.ppfeufer.de/widget/alliance-auth-apps/aa-intel-tool/multi-auto.svg)](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)\n\nDo you want to help translate this app into your language or improve the existing\ntranslation? - [Join our team of translators][weblate engage]!\n\n## Contributing\u003ca name=\"contributing\"\u003e\u003c/a\u003e\n\nDo you want to contribute to this project? That's cool!\n\nPlease make sure to read the [Contribution Guidelines].\\\n(I promise, it's not much, just some basics)\n\n\u003c!-- Inline Links --\u003e\n\n[aa intel tool license]: https://github.com/ppfeufer/aa-intel-tool/blob/master/LICENSE\n[aa intel tool on codecov]: https://codecov.io/gh/ppfeufer/aa-intel-tool\n[aa intel tool on pypi]: https://pypi.org/project/aa-intel-tool/\n[alliance auth]: https://gitlab.com/allianceauth/allianceauth \"Alliance Auth on GitLab\"\n[alliance auth installation guide]: https://allianceauth.readthedocs.io/en/latest/installation/allianceauth.html\n[automated tests on github]: https://github.com/ppfeufer/aa-intel-tool/actions/workflows/automated-checks.yml\n[badge: automated tests]: https://github.com/ppfeufer/aa-intel-tool/actions/workflows/automated-checks.yml/badge.svg \"Automated Tests\"\n[badge: buy me a coffee]: https://ko-fi.com/img/githubbutton_sm.svg \"Buy Me a Coffee!\"\n[badge: code coverage]: https://codecov.io/gh/ppfeufer/aa-intel-tool/branch/master/graph/badge.svg \"Code Coverage\"\n[badge: code style: black]: https://img.shields.io/badge/code%20style-black-000000.svg \"Code Style: black\"\n[badge: contributor covenant]: https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg \"Contributor Covenant\"\n[badge: license]: https://img.shields.io/github/license/ppfeufer/aa-intel-tool \"License\"\n[badge: pre-commit]: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white \"pre-commit\"\n[badge: pre-commit.ci status]: https://results.pre-commit.ci/badge/github/ppfeufer/aa-intel-tool/master.svg \"pre-commit.ci status\"\n[badge: support discord]: https://img.shields.io/discord/399006117012832262?label=discord \"Support Discord\"\n[badge: supported django versions]: https://img.shields.io/pypi/djversions/aa-intel-tool?label=django \"Supported Django Versions\"\n[badge: supported python versions]: https://img.shields.io/pypi/pyversions/aa-intel-tool \"Supported Python Versions\"\n[badge: translation status]: https://weblate.ppfeufer.de/widget/alliance-auth-apps/aa-intel-tool/svg-badge.svg \"Translation Status\"\n[badge: version]: https://img.shields.io/pypi/v/aa-intel-tool?label=release \"Version\"\n[black code formatter documentation]: http://black.readthedocs.io/en/latest/\n[changelog.md]: https://github.com/ppfeufer/aa-intel-tool/blob/master/CHANGELOG.md\n[code of conduct]: https://github.com/ppfeufer/aa-intel-tool/blob/master/CODE_OF_CONDUCT.md\n[contribution guidelines]: https://github.com/ppfeufer/aa-intel-tool/blob/master/CONTRIBUTING.md \"Contribution Guidelines\"\n[eve universe]: https://gitlab.com/ErikKalkoken/django-eveuniverse \"Eve Universe\"\n[image: chat scan module]: https://raw.githubusercontent.com/ppfeufer/aa-intel-tool/master/docs/images/presentation/chat-scan.jpg \"Chat Scan Module\"\n[image: d-scan module]: https://raw.githubusercontent.com/ppfeufer/aa-intel-tool/master/docs/images/presentation/d-scan.jpg \"D-Scan Module\"\n[image: fleet composition module]: https://raw.githubusercontent.com/ppfeufer/aa-intel-tool/master/docs/images/presentation/fleet-composition.jpg \"Fleet Composition Module\"\n[ppfeufer on ko-fi]: https://ko-fi.com/ppfeufer \"Buy Me a Coffee!\"\n[pre-commit.ci status]: https://results.pre-commit.ci/latest/github/ppfeufer/aa-intel-tool/master \"pre-commit.ci\"\n[support discord]: https://discord.gg/fjnHAmk \"Alliance Auth Support Discord\"\n[weblate engage]: https://weblate.ppfeufer.de/engage/alliance-auth-apps/ \"Weblate Translations\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fppfeufer%2Faa-intel-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fppfeufer%2Faa-intel-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fppfeufer%2Faa-intel-tool/lists"}