Skip to content

tarkovtracker-org/RatScanner

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

595 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rat Scanner

RatScanner logo

Actively maintained by TarkovTracker.org.

Based on RatScanner, originally created by Moritz / Blightbuster (see Attribution & license).

Versioning: uses an independent semver line starting at v4.0.0. Historical / original RatScanner used 3.x — if a report says 3.9.x, it is not this build.

GitHub Discord Download

External item scanner for Escape from Tarkov. Screenshots identify items; pricing and related data come from the tarkov.dev API. This fork deepens TarkovTracker.org integration and continues active development.

Support / issues: Discord · TarkovTracker Discord · this GitHub repo Demo: Tutorial video · FAQ

Can I get banned for using Rat Scanner?

Battlestate Games does not support or affiliate with this project. The original tool has been used by many players for years without proven bans. Use at your own risk.

What it does

Scan items in-game and view average price, value per slot, and (when connected) quest / hideout relevance.

How it works

Entirely external — no game memory access. A screenshot is taken, image processing identifies the item, and results appear in the window and overlay tooltip.

How to use

Game may need Borderless or Windowed mode for the overlay.

Name scanning

Scan the inspection name of an item.

  • Left-click the magnifier icon in the inspect window

Limitations:

  • Uses / durability assumed at 100%
  • Weapons and modable items only show the base item

Name scanning demo

Icon scanning

Scan the icon of an item.

  • Hold the modifier key while left-clicking (default Shift; changeable in settings)

Limitations:

  • Weapons can no longer be scanned by icon
  • Uses / durability assumed at 100%
  • Shared icons (especially keys) can match incorrectly
  • Stash lighting can interfere with the top-left stash area

Icon scanning demo

Minimal UI

Title bar button switches to minimal UI. Double-click the window to return. Opacity and fields are configurable in settings.

Minimal UI how-to demo

Download

Get the latest RatScanner.zip or a specific release.

Extract and run RatScanner.exe. Confirm resolution in settings (default Full HD).

Help: FAQ · Discord · TarkovTracker Discord · common start issues

Setting up the repository for development

Requirements: 64-bit Windows, .NET 10 SDK.

  1. Clone this repo: https://github.com/tarkovtracker-org/RatScanner
  2. From the repo root, run dev.bat (downloads icons/OCR data and restores packages on first run)

Day-to-day coding

What you want Command
Auto rebuild + restart on save dev.bat
Run once dev.bat -Once
Re-download icons/OCR data dev.bat -ForceSetup
Release config (local loop) dev.bat -Release

dev.bat ensures src\App\Data\, restores packages, then runs dotnet watch (restart-on-save). WPF hot reload is limited; that loop is the reliable workflow.

Repository layout

src/App/           # Main WPF app
src/ScanEngine/    # Scan engine (historical RatEye; in-tree)
tests/             # Unit tests
scripts/           # dev + data setup
powershell -ExecutionPolicy Bypass -File scripts\setup-data.ps1
dotnet restore RatScanner.sln
dotnet watch --project src\App\RatScanner.csproj --non-interactive --no-hot-reload run
dotnet run --project src\App\RatScanner.csproj

Or open RatScanner.sln and press F5.

Compiling only

dotnet build RatScanner.sln

Tests and formatting

dotnet test RatScanner.sln
dotnet tool restore
dotnet csharpier check .

Publishing (slow; not for day-to-day)

publish.bat

Output: publish\RatScanner.exe, RatScanner.zip (includes LICENSE). Prefer dev.bat while coding.

Contributing

See CONTRIBUTING.md. PRs and issues: tarkovtracker-org/RatScanner.

Default integration branch is master. Day-to-day work uses short-lived feat/… / fix/… branches and PRs against the fork.

Agent / contributor architecture docs: root AGENTS.md (control plane) and docs/agent-context/ (focused context). Nested AGENTS.md files under src/App, src/ScanEngine, and tests apply path-scoped rules. Implementation and project files override stale documentation.

Community & support

Maintained by TarkovTracker.org — integration and ongoing development.

Site https://tarkovtracker.org
Source & releases github.com/tarkovtracker-org/RatScanner
Discord (RatScanner) discord.gg/aHZf7aP
Discord (TarkovTracker) discord.gg/M8nBgA2sT6
Market data tarkov.dev

Attribution & license

Based on RatScanner, originally created by Moritz / Blightbuster. Historical source: github.com/RatScanner/RatScanner.

Current development is by TarkovTracker.org. For help, use the Discord, TarkovTracker Discord, or this repository.

Terms are in LICENSE (based on Elastic License 2.0). In short:

  • Use, copy, and distribute under those terms.
  • Do not sell, rent, or commercially distribute the software.
  • Anyone who receives a copy must also receive the license terms (LICENSE is included with releases).
  • Modified copies must include a prominent notice that the software was modified (this section and the in-app About page).
  • Do not remove or obscure licensing notices shipped with the software.

Battlestate Games is not affiliated with this project.


About

Rat Scanner - TarkovTracker.org Edition. Forked from the original project. A helpful companion app for Escape from Tarkov.

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages