{"id":50314383,"url":"https://github.com/antrakt92/applicantscout-addon","last_synced_at":"2026-05-28T23:01:42.090Z","repository":{"id":357459489,"uuid":"1228991288","full_name":"Antrakt92/ApplicantScout-Addon","owner":"Antrakt92","description":"WoW Mythic+ applicant exporter for the ApplicantScout Companion overlay.","archived":false,"fork":false,"pushed_at":"2026-05-27T19:33:41.000Z","size":675,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-27T21:17:57.973Z","etag":null,"topics":["curseforge","lua","mythic-plus","raiderio","warcraftlogs","world-of-warcraft","wow-addon"],"latest_commit_sha":null,"homepage":"https://github.com/Antrakt92/ApplicantScout-Companion/releases/latest","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Antrakt92.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-04T15:31:54.000Z","updated_at":"2026-05-27T19:33:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Antrakt92/ApplicantScout-Addon","commit_stats":null,"previous_names":["antrakt92/applicantscout"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/Antrakt92/ApplicantScout-Addon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Antrakt92%2FApplicantScout-Addon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Antrakt92%2FApplicantScout-Addon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Antrakt92%2FApplicantScout-Addon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Antrakt92%2FApplicantScout-Addon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Antrakt92","download_url":"https://codeload.github.com/Antrakt92/ApplicantScout-Addon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Antrakt92%2FApplicantScout-Addon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33629560,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-28T02:00:06.440Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["curseforge","lua","mythic-plus","raiderio","warcraftlogs","world-of-warcraft","wow-addon"],"created_at":"2026-05-28T23:00:45.574Z","updated_at":"2026-05-28T23:01:42.070Z","avatar_url":"https://github.com/Antrakt92.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ApplicantScout: LFG \u0026 Party Overlay\n\n\u003cp\u003e\n  \u003ca href=\"https://github.com/Antrakt92/ApplicantScout-Addon/releases/latest\"\u003e\u003cimg alt=\"Latest addon release\" src=\"https://img.shields.io/github/v/release/Antrakt92/ApplicantScout-Addon?style=for-the-badge\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/Antrakt92/ApplicantScout-Companion/releases/latest\"\u003e\u003cimg alt=\"Companion required\" src=\"https://img.shields.io/badge/Companion-required-ff5e7a?style=for-the-badge\"\u003e\u003c/a\u003e\n  \u003cimg alt=\"Retail Midnight 12.x\" src=\"https://img.shields.io/badge/Retail-Midnight%2012.x-7c5cff?style=for-the-badge\"\u003e\n  \u003cimg alt=\"Warcraft Logs plus RaiderIO\" src=\"https://img.shields.io/badge/WCL%20%2B%20RaiderIO-overlay-00b8ff?style=for-the-badge\"\u003e\n\u003c/p\u003e\n\n\u003e Pick applicants faster. Know the group you just joined.\n\nApplicantScout is the in-game half of a Warcraft Logs + RaiderIO overlay for\nWoW Group Finder. It captures applicant and current party/raid roster snapshots\nfrom Blizzard's UI, sends them through normal WoW screenshots, and pairs with\nthe Windows companion overlay for the actual WCL/RaiderIO table.\n\nIt is built for two moments that usually cost time: choosing who to invite while\nyour listing fills, and understanding a group you just joined before the key\nstarts or the first raid pull happens.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/visual/applicantscout-curseforge-raid-party-overlay.jpg\" alt=\"ApplicantScout Party view with Warcraft Logs, RaiderIO, raid progress, and role context\" width=\"49%\"\u003e\n  \u003cimg src=\"docs/visual/applicantscout-curseforge-mplus-overlay.jpg\" alt=\"ApplicantScout Mythic Plus overlay with key fit, WCL percentiles, and RaiderIO score context\" width=\"40%\"\u003e\n\u003c/p\u003e\n\n\u003e [!IMPORTANT]\n\u003e ApplicantScout is a two-part tool. Installing only the WoW addon will not show\n\u003e Warcraft Logs or RaiderIO context. You need the addon plus\n\u003e [ApplicantScout Companion](https://github.com/Antrakt92/ApplicantScout-Companion/releases/latest).\n\n## Why People Install It\n\n### When you host\n\n- See applicant evidence beside the invite decision instead of rebuilding a\n  mini spreadsheet from Warcraft Logs, RaiderIO, and the default LFG list.\n- Keep grouped applicants visible as a package while still seeing each member's\n  own WCL/RaiderIO signal.\n- Keep raid evidence primary for raid listings and M+ evidence primary for\n  Mythic+ listings.\n- Treat missing logs as missing evidence, not as secretly good or secretly bad.\n- Use familiar Warcraft Logs-style colors for faster scanning.\n\n### When you join\n\n- Open Party view and get roster context a few moments after you join someone\n  else's group.\n- See score spread, raid progress, dungeon context, missing evidence, and role\n  mix before the run really starts.\n- Use leader-key calibration from ApplicantScout's built-in LibKS-compatible\n  shim, without requiring BigWigs or another key-tracker addon.\n\nApplicantScout is not an auto-invite bot and does not automate gameplay. It is\na decision surface for humans.\n\n## Quick Setup\n\n1. Install ApplicantScout through CurseForge, or download the packaged addon ZIP\n   from [the latest addon release](https://github.com/Antrakt92/ApplicantScout-Addon/releases/latest).\n2. Install ApplicantScout Companion from\n   [the latest companion release](https://github.com/Antrakt92/ApplicantScout-Companion/releases/latest).\n   Use `ApplicantScoutCompanionSetup-*.exe`; the portable ZIP is mainly for\n   manual/dev use.\n3. Launch the companion and enter your Warcraft Logs Client ID/Secret.\n4. Set the active WoW `_retail_\\Screenshots` folder in companion Settings.\n5. Reload WoW, then host a Mythic+ or raid listing, or join a group and use\n   Party view to review the current roster.\n\nManual addon installs should extract the packaged ZIP so the TOC is at\n`_retail_\\Interface\\AddOns\\ApplicantScout\\ApplicantScout.toc`. Do not use\nGitHub's automatic source-code ZIP for normal installs; it extracts to the wrong\nfolder name for WoW.\n\n## What The Overlay Can Show\n\n- Warcraft Logs raid and Mythic+ percentiles.\n- RaiderIO current score, optional main-score context, and local RaiderIO\n  dungeon/raid evidence when the RaiderIO addon data is available.\n- Role, item level, grouped-applicant packages, and per-player rows.\n- Raid-fit cells for Normal/Heroic/Mythic raid listings.\n- Target-key fit, dungeon history, and low-evidence markers for Mythic+.\n- Current party/raid roster context after invites or after joining a group.\n- Optional playstyle and Auto Hi controls for in-game quality-of-life.\n\n## How It Works\n\nWoW addons cannot query Warcraft Logs directly from inside the game client.\nApplicantScout keeps the in-game addon small and uses public UI/screenshot APIs:\n\n1. The addon watches your active Group Finder listing and current party/raid\n   roster.\n2. It renders compact QR snapshots and triggers normal WoW screenshots.\n3. The companion watches the configured Screenshots folder, decodes\n   ApplicantScout `APS1` payloads, fetches WCL data, reads optional local\n   RaiderIO data, and updates the overlay.\n4. The QR frame appears only during the screenshot capture window so it stays\n   out of the way between snapshots.\n\nApplicantScout temporarily raises screenshot quality and uses JPG format while\nenabled, then restores your prior screenshot settings when you turn it off with\n`/apscout off`.\n\n## Privacy And Trust\n\nApplicantScout does not read WoW memory, inject code, automate gameplay, or send\nchat messages as a transport.\n\nTrust notes for the companion:\n\n- It does not ask for Blizzard credentials or account access.\n- It watches only the configured WoW `Screenshots` folder for ApplicantScout QR\n  payloads.\n- If the RaiderIO addon is installed, it can read local RaiderIO addon database\n  files under `_retail_\\Interface\\AddOns\\RaiderIO\\db` to enrich score/progress\n  context.\n- It stores Warcraft Logs API credentials locally under your Windows user\n  profile.\n- Decoded RaiderIO lookup payloads can be cached under\n  `%LOCALAPPDATA%\\applicant-scout\\cache\\raiderio-local`.\n- It is source-available in the public companion repository.\n- Current Windows builds are unsigned, so SmartScreen can warn on first install;\n  the release also publishes a `.sha256` sidecar for file integrity, not\n  publisher identity.\n\nBefore sharing support material publicly, redact `/apscout status` output,\n`/apscout taintcheck` output, companion logs, QR screenshots, manual decode\noutput, `config.env`, `token.json`, and `character-cache.json`. These can\ninclude WCL Client ID/Secret, OAuth access token, character names, realm names,\nlisting titles/comments, screenshots folder paths, keystone/listing metadata,\nand WCL/RaiderIO evidence.\n\nQR screenshots may remain if the companion is absent, interrupted, pointed at\nthe wrong folder, or the Screenshots folder is synced/shared before cleanup.\n\n## Handy Slash Commands\n\n```text\n/apscout on | off       enable/disable capture\n/apscout toggle         flip enabled state\n/apscout config         open/close settings panel\n/apscout status         show current state + QR diagnostics\n/apscout playstyle [off|learning|relaxed|competitive|carry] set M+ default playstyle\n/apscout reset          clear transport cache, queue fresh snapshot\n/apscout shotnow        force snapshot now while enabled (debug / manual sync)\n/apscout qrvisible      toggle QR frame always-visible (debug aid)\n/apscout qrmove         toggle QR move mode (Alt+drag QR frame)\n/apscout qrreset        reset QR frame position to top-left\n/apscout taintcheck     probe C_LFGList field secret-tagging\n/apscout debug [on|off] toggle debug logging\n/apscout competitive [on|off] legacy alias for Competitive / Off\n```\n\n## Compatibility\n\n- WoW Retail Midnight: Interface `120005, 120007`.\n- Latest ApplicantScout addon release.\n- Latest ApplicantScout Companion release.\n- Wire payload: compact v8 (`APS1`) with optional RaiderIO, raid/M+ roster,\n  leader-keystone context, and temporary LFG-lockdown handling.\n- Classic-era clients are not supported.\n\n## Troubleshooting\n\n- Overlay stays empty: open companion Settings and confirm the Screenshots path\n  points at the active `_retail_\\Screenshots` folder.\n- WoW side looks idle: run `/apscout status` while hosting a listing.\n- Need a manual sync: keep ApplicantScout enabled and run `/apscout shotnow`.\n- Applicant state looks stale: run `/apscout reset` while transport is active.\n- WCL cells stay empty: open companion Settings and use Test WCL.\n- QR frame is in the way: run `/apscout qrmove`, Alt-drag it, then run\n  `/apscout qrmove` again to lock placement.\n\n## Local Development\n\nPackage a development-only addon ZIP from a clean checkout:\n\n```powershell\n.\\scripts\\package-addon.ps1\n```\n\nThe script emits `dist\\ApplicantScout-\u003cversion\u003e.zip`, verifies that the archive\ncontains a top-level `ApplicantScout\\` addon folder, and refuses dirty release\ninputs by default. Marketplace releases are produced by the BigWigs packager\nfrom `.pkgmeta`; use the local ZIP only for smoke testing.\n\nFor workspace-wide Lua syntax and LuaLS diagnostics, run this from the private\nWOW coordination repo:\n\n```powershell\n.\\scripts\\check-wow-lua.ps1 -Project ApplicantScout\n```\n\n## Support\n\n- Addon source and in-game issues:\n  [github.com/Antrakt92/ApplicantScout-Addon](https://github.com/Antrakt92/ApplicantScout-Addon)\n- Companion, installer, WCL setup, and overlay issues:\n  [github.com/Antrakt92/ApplicantScout-Companion](https://github.com/Antrakt92/ApplicantScout-Companion)\n\n## License\n\nApplicantScout is MIT licensed; see `LICENSE`.\n\nThe bundled `libs/qrencode.lua` library retains its upstream 3-clause BSD\nlicense. See `THIRD-PARTY-NOTICES.md` and the source header in\n`libs/qrencode.lua`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantrakt92%2Fapplicantscout-addon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fantrakt92%2Fapplicantscout-addon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantrakt92%2Fapplicantscout-addon/lists"}