{"id":17004222,"url":"https://github.com/ppfeufer/aa-discord-announcements","last_synced_at":"2026-01-05T20:11:15.792Z","repository":{"id":54574811,"uuid":"522326100","full_name":"ppfeufer/aa-discord-announcements","owner":"ppfeufer","description":"Discord Announcements via Alliance Auth (https://gitlab.com/allianceauth/allianceauth). Write announcements and manage who can write announcements on your corporation or alliance Discord through Alliance Auth.","archived":false,"fork":false,"pushed_at":"2025-04-07T18:22:36.000Z","size":1239,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-07T19:23:56.202Z","etag":null,"topics":["allianceauth","discord"],"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":"2022-08-07T21:14:50.000Z","updated_at":"2025-04-07T18:22:30.000Z","dependencies_parsed_at":"2024-01-12T01:19:09.102Z","dependency_job_id":"26eba1b2-df81-44d2-a8a5-e93d1f3644b4","html_url":"https://github.com/ppfeufer/aa-discord-announcements","commit_stats":{"total_commits":371,"total_committers":6,"mean_commits":"61.833333333333336","dds":0.5175202156334231,"last_synced_commit":"b6a6b9f16ed60bf16507d4420c867b809bb831ad"},"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-discord-announcements","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-discord-announcements/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-discord-announcements/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-discord-announcements/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ppfeufer","download_url":"https://codeload.github.com/ppfeufer/aa-discord-announcements/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248529855,"owners_count":21119580,"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","discord"],"created_at":"2024-10-14T04:43:06.096Z","updated_at":"2026-01-05T20:11:15.786Z","avatar_url":"https://github.com/ppfeufer.png","language":"Python","funding_links":["https://ko-fi.com/ppfeufer","https://ko-fi.com/N4N8CL1BY"],"categories":[],"sub_categories":[],"readme":"# AA Discord Announcements\u003ca name=\"aa-discord-announcements\"\u003e\u003c/a\u003e\n\n[![Version](https://img.shields.io/pypi/v/aa-discord-announcements?label=release)](https://pypi.org/project/aa-discord-announcements/)\n[![License](https://img.shields.io/github/license/ppfeufer/aa-discord-announcements)](https://github.com/ppfeufer/aa-discord-announcements/blob/master/LICENSE)\n[![Python](https://img.shields.io/pypi/pyversions/aa-discord-announcements)](https://pypi.org/project/aa-discord-announcements/)\n[![Django](https://img.shields.io/pypi/djversions/aa-discord-announcements?label=django)](https://pypi.org/project/aa-discord-announcements/)\n![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white)\n[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/ppfeufer/aa-discord-announcements/master.svg)](https://results.pre-commit.ci/latest/github/ppfeufer/aa-discord-announcements/master)\n[![Code Style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](http://black.readthedocs.io/en/latest/)\n[![Discord](https://img.shields.io/discord/399006117012832262?label=discord)](https://discord.gg/fjnHAmk)\n[![Checks](https://github.com/ppfeufer/aa-discord-announcements/actions/workflows/automated-checks.yml/badge.svg)](https://github.com/ppfeufer/aa-discord-announcements/actions/workflows/automated-checks.yml)\n[![codecov](https://codecov.io/gh/ppfeufer/aa-discord-announcements/branch/master/graph/badge.svg?token=9I6HQB6W6J)](https://codecov.io/gh/ppfeufer/aa-discord-announcements)\n[![Translation status](https://weblate.ppfeufer.de/widget/alliance-auth-apps/aa-discord-announcements/svg-badge.svg)](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)\n[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](https://github.com/ppfeufer/aa-discord-announcements/blob/master/CODE_OF_CONDUCT.md)\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/N4N8CL1BY)\n\nDiscord Announcements via [Alliance Auth](https://gitlab.com/allianceauth/allianceauth)\n\nWrite announcements and manage who can write announcements on your corporation or\nalliance Discord through Alliance Auth.\n\n______________________________________________________________________\n\n\u003c!-- mdformat-toc start --slug=github --maxlevel=6 --minlevel=2 --\u003e\n\n- [Installation](#installation)\n  - [Bare Metal Installation](#bare-metal-installation)\n    - [Step 1: Install the App](#step-1-install-the-app)\n    - [Step 2: Update Your AA Settings](#step-2-update-your-aa-settings)\n    - [Step 3: Finalizing the Installation](#step-3-finalizing-the-installation)\n  - [Docker Installation](#docker-installation)\n    - [Step 1: Add the App](#step-1-add-the-app)\n    - [Step 2: Update Your AA Settings](#step-2-update-your-aa-settings-1)\n    - [Step 3: Build Auth and Restart Your Containers](#step-3-build-auth-and-restart-your-containers)\n    - [Step 4: Run Migrations and Collect Static Files](#step-4-run-migrations-and-collect-static-files)\n  - [Common Installation Steps](#common-installation-steps)\n    - [Setting up Permission](#setting-up-permission)\n    - [Setting up the App](#setting-up-the-app)\n- [Changelog](#changelog)\n- [Translation Status](#translation-status)\n- [Contributing](#contributing)\n\n\u003c!-- mdformat-toc end --\u003e\n\n______________________________________________________________________\n\n## Installation\u003ca name=\"installation\"\u003e\u003c/a\u003e\n\nThis app is a plugin for Alliance Auth. If you don't have Alliance Auth running already,\nplease install it first before proceeding.\n(See the official [AA installation guide](https://allianceauth.readthedocs.io/en/latest/installation/allianceauth.html) for details)\n\n\u003e [!NOTE]\n\u003e\n\u003e You also want to make sure that you have the\n\u003e [Discord service](https://allianceauth.readthedocs.io/en/latest/features/services/discord.html)\n\u003e installed, configured and activated before installing this app.\n\n### Bare Metal Installation\u003ca name=\"bare-metal-installation\"\u003e\u003c/a\u003e\n\n#### Step 1: Install the App\u003ca name=\"step-1-install-the-app\"\u003e\u003c/a\u003e\n\nMake sure you're in the virtual environment (venv) of your Alliance Auth installation.\nThen install the latest version:\n\n```shell\npip install aa-discord-announcements\n```\n\n#### Step 2: Update Your AA Settings\u003ca name=\"step-2-update-your-aa-settings\"\u003e\u003c/a\u003e\n\nConfigure your AA settings (`local.py`) as follows:\n\n- Add `\"aa_discord_announcements\",` to `INSTALLED_APPS`\n\n#### Step 3: Finalizing the Installation\u003ca name=\"step-3-finalizing-the-installation\"\u003e\u003c/a\u003e\n\nCopy static files and run migrations\n\n```shell\npython manage.py collectstatic\npython manage.py migrate\n```\n\nRestart your supervisor services for AA\n\n### Docker Installation\u003ca name=\"docker-installation\"\u003e\u003c/a\u003e\n\n#### Step 1: Add the App\u003ca name=\"step-1-add-the-app\"\u003e\u003c/a\u003e\n\nAdd the app to your `conf/requirements.txt`\n\n```text\naa-discord-announcements==2.7.1\n```\n\n#### Step 2: Update Your AA Settings\u003ca name=\"step-2-update-your-aa-settings-1\"\u003e\u003c/a\u003e\n\nConfigure your AA settings (`conf/local.py`) as follows:\n\n- Add `\"aa_discord_announcements\",` to `INSTALLED_APPS`\n\n#### Step 3: Build Auth and Restart Your Containers\u003ca name=\"step-3-build-auth-and-restart-your-containers\"\u003e\u003c/a\u003e\n\n```shell\ndocker compose build\ndocker compose --env-file=.env up -d\n```\n\n#### Step 4: Run Migrations and Collect Static Files\u003ca name=\"step-4-run-migrations-and-collect-static-files\"\u003e\u003c/a\u003e\n\n```shell\ndocker compose exec allianceauth_gunicorn bash\nauth collectstatic\nauth migrate\n```\n\n### Common Installation Steps\u003ca name=\"common-installation-steps\"\u003e\u003c/a\u003e\n\n#### Setting up Permission\u003ca name=\"setting-up-permission\"\u003e\u003c/a\u003e\n\nNow you can set up permissions in Alliance Auth for your users.\nAdd `aa_discord_announcements | general | Can access this app` to the states and/or\ngroups you would like to have access.\n\n#### Setting up the App\u003ca name=\"setting-up-the-app\"\u003e\u003c/a\u003e\n\nIn your admin backend you'll find a new section called `Discord Announcements`.\nThis is where you set all your stuff up, like the webhooks you want to ping and who\ncan ping them. It's pretty straight forward, so you shouldn't have any issues. Go nuts!\n\n## Changelog\u003ca name=\"changelog\"\u003e\u003c/a\u003e\n\nSee [CHANGELOG.md](https://github.com/ppfeufer/aa-discord-announcements/blob/master/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-discord-announcements/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!-- Links --\u003e\n\n[contribution guidelines]: https://github.com/ppfeufer/aa-discord-announcements/blob/master/CONTRIBUTING.md \"Contribution Guidelines\"\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-discord-announcements","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fppfeufer%2Faa-discord-announcements","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fppfeufer%2Faa-discord-announcements/lists"}