{"id":50056004,"url":"https://github.com/just5ky/goon-tracker","last_synced_at":"2026-05-21T13:14:56.334Z","repository":{"id":351277731,"uuid":"1210316020","full_name":"just5ky/goon-tracker","owner":"just5ky","description":"Real-time Escape from Tarkov Goon location tracker — OBS overlay + web dashboard, powered by the tarkov.dev community API.","archived":false,"fork":false,"pushed_at":"2026-05-04T04:10:14.000Z","size":1002,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-04T06:17:50.347Z","etag":null,"topics":["eft","escape-from-tarkov","obs","overlay","tarkov","twitch"],"latest_commit_sha":null,"homepage":"http://goons.justsky.in/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/just5ky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-04-14T09:43:03.000Z","updated_at":"2026-05-04T04:10:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/just5ky/goon-tracker","commit_stats":null,"previous_names":["just5ky/goon-tracker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/just5ky/goon-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/just5ky%2Fgoon-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/just5ky%2Fgoon-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/just5ky%2Fgoon-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/just5ky%2Fgoon-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/just5ky","download_url":"https://codeload.github.com/just5ky/goon-tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/just5ky%2Fgoon-tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33301856,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-21T12:23:38.849Z","status":"ssl_error","status_checked_at":"2026-05-21T12:22:11.673Z","response_time":62,"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":["eft","escape-from-tarkov","obs","overlay","tarkov","twitch"],"created_at":"2026-05-21T13:14:51.278Z","updated_at":"2026-05-21T13:14:56.328Z","avatar_url":"https://github.com/just5ky.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Goon Tracker\n\nReal-time Escape from Tarkov Goon location tracker — OBS overlay + web dashboard, powered by the [tarkov.dev](https://tarkov.dev) community API.\n\n---\n\n## Features\n\n- Live OBS overlay showing current Goon map location\n- Web dashboard with last 10 reported locations\n- **PvE and PvP mode toggle** — switch on the website or overlay, saved automatically\n- Auto-refreshes every 6 minutes (respects tarkov.dev 5-min cache)\n- Dual in-game Tarkov clock (both server pools, millisecond precision)\n- Staleness colour coding (fresh / warning / stale)\n- Random Knight / Big Pipe / Bird's Eye image rotation\n\n---\n\n## Who Are the Goons?\n\nThe Goons (Knight, Big Pipe, and Bird's Eye) are a roaming squad of Scavs that spawn on a single map per raid cycle. Knowing their last reported location gives you a heads-up before loading in.\n\n---\n\n## How to Report Sightings\n\n**In-game:** Use [Tarkov Monitor](https://tarkov.dev/tarkov-monitor) — a background app that submits your goon sightings to tarkov.dev automatically while you play. Runs silently alongside the game.\n\n**Discord:** The [Stash Discord Bot](https://tarkov.dev/stash-discord-bot) lets you look up and report goon locations directly from any Discord server.\n\n---\n\n## Setup\n\n### 1. Add character images\n\nDrop three images into the `images/` folder. Filenames must match exactly:\n\n| File | Character |\n|---|---|\n| `images/knight.png` | Knight |\n| `images/bigpipe.png` | Big Pipe |\n| `images/birdseye.png` | Bird's Eye |\n\nAny format works (`.png`, `.jpg`, `.webp`) as long as the extension matches.\n\n---\n\n### 2. OBS Overlay\n\n1. In OBS, add a **Browser Source**\n2. Check **Local file** and point to `overlay.html`\n   - Local path: `file:///C:/path/to/goon-tracker/overlay.html`\n   - Or if hosted: `https://yourdomain.com/overlay.html`\n3. Set width `355`, height `104` (adjust to taste)\n4. Enable **Shutdown source when not visible** (optional, saves resources)\n\n![](/images/overlay.png)\n\nThe overlay refreshes automatically every 6 minutes.\n\n#### PvE vs PvP mode\n\nUse the **PvE / PvP** buttons inside the overlay to switch modes. Your selection is saved in the browser and persists across reloads.\n\nTo lock a mode via URL (no in-overlay clicking needed):\n\n| Mode | URL |\n|---|---|\n| PvE (default) | `https://yourdomain.com/overlay.html` |\n| PvP | `https://yourdomain.com/overlay.html?mode=regular` |\n\nThe URL parameter takes priority over any saved preference.\n\n---\n\n### 3. Website\n\nOpen `index.html` in a browser or host the folder on any static server. Use the **PvE / PvP** toggle in the header to switch between game modes. The selection is saved automatically.\n\n---\n\n### 4. Colour Guide\n\n| Colour | Meaning |\n|---|---|\n| White | Reported within the last 30 minutes |\n| Amber | Reported 30 minutes – 2 hours ago |\n| Red | Reported more than 2 hours ago — likely stale |\n\n---\n\n## Hosting\n\n### GitHub Pages\n\n1. Push this repo to GitHub\n2. Go to **Settings → Pages → Source** → `Deploy from branch` → `main` / `/ (root)`\n3. Edit `CNAME` to set your custom domain (or remove it to use `yourusername.github.io/repo-name`)\n4. Add a DNS `CNAME` record pointing your domain to `yourusername.github.io`\n\nOBS overlay URL: `https://yourdomain.com/overlay.html`\n\n### Docker + Traefik\n\n```bash\n# Edit docker-compose.yml — set your domain and Traefik network name\ndocker compose up -d --build\n```\n\nSee [docker-compose.yml](docker-compose.yml) for Traefik label configuration.\n\n---\n\n## Data Source\n\nAll data sourced from the [tarkov.dev GraphQL API](https://api.tarkov.dev) — a free, community-maintained Escape from Tarkov database. Goon reports are player-submitted.\n\n```graphql\n{\n  goonReports(gameMode: pve, lang: en, limit: 10) {\n    timestamp\n    map {\n      name\n      raidDuration\n      wiki\n    }\n  }\n}\n```\n\nThe `gameMode` field accepts `pve` or `pvp`.\n\n---\n\n## Project Structure\n\n```\ngoon-tracker/\n├── index.html       — web dashboard (last 10 reports)\n├── overlay.html     — OBS browser source\n├── style.css        — shared base styles\n├── site.css         — dashboard styles\n├── overlay.css      — overlay styles\n├── site.js          — dashboard logic\n├── overlay.js       — overlay logic\n├── app.js           — standalone overlay logic (legacy, not loaded by default)\n├── nginx.conf       — nginx config for Docker\n├── Dockerfile\n├── docker-compose.yml\n└── images/          — drop knight.png, bigpipe.png, birdseye.png here\n```\n\n---\n\n## Contributing\n\nIssues and PRs welcome — see [bug reports](.github/ISSUE_TEMPLATE/bug_report.yml) and [feature requests](.github/ISSUE_TEMPLATE/feature_request.yml) templates.\n\nThis project is open source: [github.com/just5ky/goon-tracker](https://github.com/just5ky/goon-tracker)\n\n---\n\n## Credits\n\n- Data: [tarkov.dev](https://tarkov.dev) community API\n- Reporting: [Tarkov Monitor](https://tarkov.dev/tarkov-monitor)\n- Game: Escape from Tarkov by Battlestate Games\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjust5ky%2Fgoon-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjust5ky%2Fgoon-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjust5ky%2Fgoon-tracker/lists"}