{"id":29086531,"url":"https://github.com/into-the-grey/raidassist","last_synced_at":"2026-01-31T08:33:19.129Z","repository":{"id":301214838,"uuid":"1008541470","full_name":"Into-The-Grey/RaidAssist","owner":"Into-The-Grey","description":"A Destiny 2 desktop overlay and progress tracker. Track red borders, catalysts, exotics, and more—right on your screen. Alpha release; feedback welcome!","archived":false,"fork":false,"pushed_at":"2025-07-12T06:04:12.000Z","size":20503,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-12T06:24:15.751Z","etag":null,"topics":["catalyst-tracker","companion-app","desktop-app","destiny2","game-overlay","gaming-tools","manifest","milestones","notifications","open-source","overlay","progress-tracker","pyside2","python","raid-tracker"],"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/Into-The-Grey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-25T17:49:07.000Z","updated_at":"2025-07-12T06:05:42.000Z","dependencies_parsed_at":"2025-06-25T18:42:16.287Z","dependency_job_id":"778b4708-43ea-4a6e-a373-c1c9543ee9f1","html_url":"https://github.com/Into-The-Grey/RaidAssist","commit_stats":null,"previous_names":["into-the-grey/raidassist"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/Into-The-Grey/RaidAssist","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Into-The-Grey%2FRaidAssist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Into-The-Grey%2FRaidAssist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Into-The-Grey%2FRaidAssist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Into-The-Grey%2FRaidAssist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Into-The-Grey","download_url":"https://codeload.github.com/Into-The-Grey/RaidAssist/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Into-The-Grey%2FRaidAssist/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28935418,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T07:49:44.436Z","status":"ssl_error","status_checked_at":"2026-01-31T07:49:34.274Z","response_time":128,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["catalyst-tracker","companion-app","desktop-app","destiny2","game-overlay","gaming-tools","manifest","milestones","notifications","open-source","overlay","progress-tracker","pyside2","python","raid-tracker"],"created_at":"2025-06-28T00:30:26.156Z","updated_at":"2026-01-31T08:33:19.124Z","avatar_url":"https://github.com/Into-The-Grey.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CodeQL Advanced](https://github.com/Into-The-Grey/RaidAssist/actions/workflows/codeql.yml/badge.svg)](https://github.com/Into-The-Grey/RaidAssist/actions/workflows/codeql.yml)\n[![Python CI](https://github.com/Into-The-Grey/RaidAssist/actions/workflows/python-tests.yml/badge.svg)](https://github.com/Into-The-Grey/RaidAssist/actions/workflows/python-tests.yml)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](LICENSE)\n[![Open Source](https://badgen.net/badge/open/source/blue?icon=github)](https://github.com/Into-The-Grey/RaidAssist)\n[![Platform: Windows](https://img.shields.io/badge/platform-Windows-blue?logo=windows)](https://github.com/Into-The-Grey/RaidAssist)\n\n# RaidAssist\n\n**RaidAssist** is a next-generation Destiny 2 desktop companion app and overlay for completionists, hardcore players, and Guardians who never want to alt-tab. It runs on Windows and is fully open source.\n\n---\n\n## ✨ Features (Alpha: v0.3.0)\n\n* **Plug-and-play OAuth \u0026 Secure Auth:** One-click first-run authentication—browser auto-launch, secure Bungie login, automatic local HTTPS callback (`https://localhost:7777/callback`). No user config or secrets required. Self-signed SSL certs included for easy OAuth.\n* **Dashboard Tabs** — See all your Red Border weapons, Catalyst progress, and Exotic collection in real time. Manifest-driven and auto-cached.\n* **Search \u0026 Filter** — Instantly filter by any name, archetype, or type.\n* **Overlay Mode** — Always-on-top, draggable, resizable overlay for in-game use. Transparency and styling options included.\n* **Global Hotkey** — Toggle overlay instantly (Ctrl+Alt+O by default).\n* **System Tray Integration** — Minimize to tray, get pop-up desktop notifications for completion milestones.\n* **Tooltips** — Manifest-powered tooltips: archetype, ammo, type, description, and source.\n* **API Tester** — Run any Bungie API endpoint, with OAuth and pretty formatting.\n* **Auto-Refresh \u0026 Settings** — User-settable refresh interval, background updates, easy status view.\n* **Export** — Save your progress (JSON/CSV) for backup, analytics, or sharing.\n* **Portable by design** — All app state, logs, and cache in `/RaidAssist`—easy to backup, wipe, or reset.\n\n---\n\n## 🛡️ Bungie API Authentication\n\nRaidAssist uses OAuth 2.0 PKCE (Proof Key for Code Exchange) for secure authentication with the Bungie API.\n\n### 🚀 For End Users\n\n* **Download the latest release** - OAuth credentials are pre-configured\n* **First run:** App opens your browser for Bungie login\n* **Automatic:** Secure token exchange happens automatically\n* **Safe:** No API keys or secrets to manage\n\n### 🔧 For Developers\n\nOAuth setup is required for development:\n\n1. **Get Bungie API credentials** at [bungie.net/Application](https://www.bungie.net/en/Application)\n2. **Copy environment template:** `cp .env.example .env`\n3. **Fill in your credentials** in the `.env` file\n4. **Verify setup:** `python verify_oauth_setup.py`\n\nSee [docs/OAUTH_SETUP.md](docs/OAUTH_SETUP.md) for detailed setup instructions.\n\n#### Security Notes\n\n* OAuth flow uses PKCE - no client secrets required\n* Local HTTPS server with self-signed certificates for callback\n* Only session tokens stored locally, never your credentials\n* All authentication handled by Bungie's official OAuth system\n\n---\n\n## 🚧 Status: v0.3.0-alpha (July 2025)\n\n* **First Windows EXE with zero-config OAuth onboarding**\n* **All logs, cache, and settings are portable and easy to reset**\n* **EXE packaging, UI, and performance improvements in progress**\n* **Bugs and feedback welcome!**\n\n---\n\n## 🔥 Roadmap: Next Features\n\nSee [ROADMAP.md](/docs/repo/ROADMAP.md) for details. Highlights include:\n\n* Multi-account/profile support\n* Raid/dungeon/activity tracking\n* Custom overlay widgets/layouts\n* Vendor and milestone reminders\n* Discord/social integration\n* Loadout/builds management\n* UI/UX and accessibility upgrades\n\n---\n\n## 🛠️ Installation \u0026 Quick Start\n\n1. **Requirements:**\n\n   * Windows (for Destiny 2 compatibility)\n   * Python 3.8+ (for dev builds only)\n   * Download the EXE from Releases or Actions for plug-and-play use\n   * [requirements.txt](/requirements.txt) lists Python dependencies\n\n2. **Install:**\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **First run:**\n\n   ```bash\n   python ui/interface.py\n   ```\n\n   *(App opens browser for Bungie login—no config or .env needed! EXE is in Releases and Actions.)*\n\n\u003e **Latest EXE is downloadable in Releases and Actions Artifacts.**\n\n---\n\n## 🧑‍💻 Developer Info \u0026 Contributing\n\n* [Developer Setup Guide](./DEVELOPER_SETUP.md)\n* [Collaboration Guide](./CONTRIBUTING.md)\n* [Code of Conduct](./CODE_OF_CONDUCT.md)\n\nAll app state, cache, logs, and settings are stored in `/RaidAssist` (see dev docs for structure).\n\n---\n\n## 📝 License\n\n**GPL v3.0** — See [LICENSE](LICENSE) for full terms. Fork, build, or modify, but keep license and credit.\n\n---\n\n## 📷 Screenshots\n\n![Dashboard Screenshot](docs/images/dashboard.png)\n![Overlay Demo GIF](docs/images/overlay-demo.gif)\n\n---\n\n**Questions, bugs, or feature ideas?**\n\n* Open an [issue](https://github.com/Into-The-Grey/RaidAssist/issues)\n* PRs and suggestions are always welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finto-the-grey%2Fraidassist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finto-the-grey%2Fraidassist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finto-the-grey%2Fraidassist/lists"}