{"id":17004252,"url":"https://github.com/ppfeufer/aa-timezones","last_synced_at":"2025-09-10T07:37:09.955Z","repository":{"id":38009801,"uuid":"263946583","full_name":"ppfeufer/aa-timezones","owner":"ppfeufer","description":"App for displaying different time zones with Alliance Auth","archived":false,"fork":false,"pushed_at":"2025-03-12T10:57:14.000Z","size":4401,"stargazers_count":6,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-12T11:34:52.341Z","etag":null,"topics":["allianceauth","django","eveonline","python","timezone-conversion","timezones"],"latest_commit_sha":null,"homepage":"","language":"CSS","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":"2020-05-14T15:03:18.000Z","updated_at":"2025-03-12T10:57:11.000Z","dependencies_parsed_at":"2024-01-13T00:29:54.575Z","dependency_job_id":"50bf26c8-ff62-4f81-8f77-1138e27d81a3","html_url":"https://github.com/ppfeufer/aa-timezones","commit_stats":{"total_commits":220,"total_committers":4,"mean_commits":55.0,"dds":"0.045454545454545414","last_synced_commit":"fc5dcae47e1718cfe4196c2795ca89adad7278ca"},"previous_names":[],"tags_count":53,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-timezones","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-timezones/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-timezones/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-timezones/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ppfeufer","download_url":"https://codeload.github.com/ppfeufer/aa-timezones/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244986326,"owners_count":20542996,"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","django","eveonline","python","timezone-conversion","timezones"],"created_at":"2024-10-14T04:43:10.067Z","updated_at":"2025-09-10T07:37:09.942Z","avatar_url":"https://github.com/ppfeufer.png","language":"CSS","funding_links":["https://ko-fi.com/ppfeufer","https://ko-fi.com/N4N8CL1BY"],"categories":[],"sub_categories":[],"readme":"# AA Time Zones\u003ca name=\"aa-time-zones\"\u003e\u003c/a\u003e\n\n[![Version](https://img.shields.io/pypi/v/aa-timezones?label=release)](https://pypi.org/project/aa-timezones/)\n[![License](https://img.shields.io/github/license/ppfeufer/aa-timezones)](https://github.com/ppfeufer/aa-timezones/blob/master/LICENSE)\n[![Python](https://img.shields.io/pypi/pyversions/aa-timezones)](https://pypi.org/project/aa-timezones/)\n[![Django](https://img.shields.io/pypi/djversions/aa-timezones?label=django)](https://pypi.org/project/aa-timezones/)\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-timezones/master.svg)](https://results.pre-commit.ci/latest/github/ppfeufer/aa-timezones/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/790364535294132234?label=discord)](https://discord.gg/zmh52wnfvM)\n[![Checks](https://github.com/ppfeufer/aa-timezones/actions/workflows/automated-checks.yml/badge.svg)](https://github.com/ppfeufer/aa-timezones/actions/workflows/automated-checks.yml)\n[![codecov](https://codecov.io/gh/ppfeufer/aa-timezones/branch/master/graph/badge.svg?token=ZSRTW5FR4C)](https://codecov.io/gh/ppfeufer/aa-timezones)\n[![Translation status](https://weblate.ppfeufer.de/widget/alliance-auth-apps/aa-timezones/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-timezones/blob/master/CODE_OF_CONDUCT.md)\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/N4N8CL1BY)\n\nApp for displaying different time zones with Alliance Auth\n\n______________________________________________________________________\n\n\u003c!-- mdformat-toc start --slug=github --maxlevel=6 --minlevel=2 --\u003e\n\n- [Installation](#installation)\n  - [Step 1: Install the App](#step-1-install-the-app)\n  - [Step 2: Update Your Alliance Auth Settings](#step-2-update-your-alliance-auth-settings)\n  - [Step 3: Finalizing the Installation](#step-3-finalizing-the-installation)\n- [(Optional) Public Views](#optional-public-views)\n- [Updating](#updating)\n- [Configure the Timezone Panels](#configure-the-timezone-panels)\n- [Adjusting Time](#adjusting-time)\n- [Discord Bot Command](#discord-bot-command)\n- [Changelog](#changelog)\n- [Translation Status](#translation-status)\n- [Contributing](#contributing)\n\n\u003c!-- mdformat-toc end --\u003e\n\n______________________________________________________________________\n\n![Time Zones](https://raw.githubusercontent.com/ppfeufer/aa-timezones/master/docs/images/presentation/aa-timezones.jpg)\n\n## Installation\u003ca name=\"installation\"\u003e\u003c/a\u003e\n\n\u003e [!NOTE]\n\u003e\n\u003e **AA Time Zones \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.16.2`.\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```bash\npip install aa-timezones\n```\n\n### Step 2: Update Your Alliance Auth Settings\u003ca name=\"step-2-update-your-alliance-auth-settings\"\u003e\u003c/a\u003e\n\nConfigure your AA settings (`local.py`) as follows:\n\n- Add `'timezones',` to `INSTALLED_APPS`\n\n### Step 3: Finalizing the Installation\u003ca name=\"step-3-finalizing-the-installation\"\u003e\u003c/a\u003e\n\nRun migrations \u0026 copy static files\n\n```bash\npython manage.py collectstatic\npython manage.py migrate\n```\n\nRestart your supervisor services for AA\n\nOnce done, it's time to add all the time zone information, so you can define your\nown set of panels later. To do so, simply run:\n\n```bash\npython manage.py timezones_load_tz_data\n```\n\n## (Optional) Public Views\u003ca name=\"optional-public-views\"\u003e\u003c/a\u003e\n\nThis app supports AA's feature of public views, since time zones conversion is not\nany mission-critical information. To allow users to view the time zone conversion page\nwithout the need to log in, please add `\"timezones\",` to the list of\n`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    \"timezones\",  # https://github.com/ppfeufer/aa-timezones\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## Updating\u003ca name=\"updating\"\u003e\u003c/a\u003e\n\nTo update your existing installation of AA Time Zones, first enable your virtual\nenvironment.\n\nThen run the following commands from your AA project directory (the one that\ncontains `manage.py`).\n\n```bash\npip install -U aa-timezones\n```\n\n```bash\npython manage.py collectstatic\n```\n\n```bash\npython manage.py migrate\n```\n\nNow restart your AA supervisor services.\n\n## Configure the Timezone Panels\u003ca name=\"configure-the-timezone-panels\"\u003e\u003c/a\u003e\n\nPer default, there are 10 additional time zone panels that are displayed (see first\nimage). If you want to change those, you can create your own set of panels in your\nadmin backend.\n\n**NOTE:** \"Local time\" and \"EVE time\" will always be displayed as the first two panels,\nno matter what.\n\n## Adjusting Time\u003ca name=\"adjusting-time\"\u003e\u003c/a\u003e\n\nYou can easily adjust the time that is displayed for all timezones. This is useful\nfor reinforcement timers or pre-planned fleets. To do so, click on the \"Adjust Time\"\nbutton below the time zone panels, and you will see 2 different ways to set a new time.\n\n![Adjusting Time](https://raw.githubusercontent.com/ppfeufer/aa-timezones/master/docs/images/weblate/aa-timezones_adjust-time-settings.jpg)\n\nThe first one is meant for timers, like reinforcement timers, anchoring timers or\nthe like. Its maximum is 7 days, 59 minutes and 59 seconds into the future. That\nshould cover pretty much all timers you can find in Eve Online.\n\nThe second one is best suited for pre-planned fleets. Here you can set a fixed date\nand time based on the selected time zone. The default selected time zone is \"EVE\ntime\" but you can change it to all the available options. Keep in mind the selected\ntime zone is the one the time and date will be adjusted to. So if you are going to\nuse it to plan fleets, it is recommended to keep this set to \"EVE time\".\n\nTo set the adjusted time, simply click on \"Set Time\" in the row you altered. This\nwill then adjust all time zone panels to the time you selected and will also alter\nthe link in your browser, so you can share it with others directly.\n\n## Discord Bot Command\u003ca name=\"discord-bot-command\"\u003e\u003c/a\u003e\n\n**For this to work, you'll need to have `allianceauth-discordbot` installed, configured\nand running.** ([See this link](https://github.com/pvyParts/allianceauth-discordbot))\n\n| Command | Effect                                                                                                                                                                                                                     |\n| :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `/time` | Displays the current EVE time and what time it is in the configured time zones\u003cbr\u003e![Discord Bot Response](https://raw.githubusercontent.com/ppfeufer/aa-timezones/master/docs/images/presentation/discordbot-response.jpg) |\n\n## Changelog\u003ca name=\"changelog\"\u003e\u003c/a\u003e\n\nSee [CHANGELOG.md](https://github.com/ppfeufer/aa-timezones/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-timezones/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[contribution guidelines]: https://github.com/ppfeufer/aa-timezones/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-timezones","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fppfeufer%2Faa-timezones","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fppfeufer%2Faa-timezones/lists"}