Skip to content

About

Cross-platform digital forensics toolkit built with Electron, React, and TypeScript. Watchlists, artifact analysis, case management, and file comparison for cybersecurity investigations.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

πŸ›‘οΈ ArtifactScope

Cross-platform digital forensics β€” entirely on your machine.

A modern desktop toolkit for investigators, incident responders, and security researchers. Inspect files, recover artifacts, hunt indicators, and document chain of custody from a single fast, keyboard-driven UI.

Platform Electron React TypeScript Tailwind SQLite License


β”Œβ”€ Case management  β€’  19 analyzers  β€’  Hash DB  β€’  Tamper-evident log  β€’  PDF reports ─┐
β”‚                                                                                       β”‚
β”‚   ⌘K to jump anywhere   Β·   ? for shortcuts   Β·   No telemetry, no cloud calls        β”‚
β”‚                                                                                       β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

✨ Highlights

  • 🎯 Command palette β€” ⌘K / Ctrl+K opens fuzzy search; paste a hash or path and it offers an instant action.
  • ⌨️ Keyboard-first β€” Vim-style g d / g c / g f / g w / g x shortcuts; ? reveals the full cheatsheet + changelog; / focuses the on-page search.
  • πŸ“₯ Drop-anywhere β€” drag any file onto the window and it opens in File Analyzer automatically.
  • πŸ‘οΈ Watchlist β€” track hashes, IPs, domains, URLs, or regex patterns. Auto-alerts fire whenever a match shows up in any analysis.
  • πŸ§ͺ Case templates β€” start a new case from Phishing / Malware / Insider / Fraud / Breach presets.
  • πŸ”¬ Compare two files β€” side-by-side diff of hashes, magic, size, entropy, and timestamps.
  • πŸ“Š Activity heatmap β€” GitHub-style 35-day investigation activity calendar on the dashboard.
  • ⭐ Pin your tools β€” star any tool to lock it to the top of the sidebar.
  • πŸ“ Per-case notes β€” auto-saving notepad alongside each investigation.
  • πŸ”— Tamper-evident audit log β€” every action is hash-chained; integrity verifies in one click.
  • πŸ—‚οΈ Case workflow β€” evidence, chain of custody, activity, and notes bound together per investigation.
  • πŸ”¬ 20+ forensic analyzers β€” files, images, logs, PCAPs, registries, email, archives, SQLite, disk images, comparison, and more.
  • 🧬 Hash database β€” local known-good / known-bad / suspicious lookup, NSRL-compatible import, batch lookup with results table + CSV export.
  • πŸ“€ One-click export β€” CSV / JSON exporters on every data view.
  • 🎨 Polished UI β€” Tailwind + Framer Motion, accent picker, cozy/compact density, loading skeletons, animated page transitions.
  • πŸ›‘οΈ Local-first & private β€” no telemetry; databases live in your user-data directory; no network calls unless you wire up an API key.

πŸ“Έ At a Glance

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  β–€ ArtifactScope    [⌘K Search tools, jump anywhere…]    Case Β· #2026-001  ?    β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Overview     β”‚   Open Cases   Critical    Hash DB     Known Bad                 β”‚
β”‚   Dashboard  β”‚      4            1         12,481        37                     β”‚
β”‚   Cases      β”‚                                                                  β”‚
β”‚   Activity   β”‚  Quick Actions    Active Case          Recent Activity           β”‚
β”‚ Analyze      β”‚  β”Œβ”€β”¬β”€β”¬β”€β”          Operation Thunder    β€’ Analyzed sample.exe     β”‚
β”‚   File       β”‚  β”‚Fβ”‚Gβ”‚Mβ”‚          #2026-001 Β· Open     β€’ Added evidence …        β”‚
β”‚   Image      β”‚  β”œβ”€β”Όβ”€β”Όβ”€β”€          Det. Jane Smith                                β”‚
β”‚   Strings    β”‚  β”‚Hβ”‚Oβ”‚Tβ”‚                                                         β”‚
β”‚   Archive    β”‚  β””β”€β”΄β”€β”΄β”€β”˜                                                         β”‚
β”‚ Artifacts    β”‚                                                                  β”‚
β”‚   Browser    β”‚  Recent Files                                                    β”‚
β”‚   System     β”‚  invoice.pdf   capture.pcap   hive.dat   …                       β”‚
β”‚   Registry   β”‚                                                                  β”‚
β”‚   Email      β”‚  Recent Cases                                                    β”‚
β”‚ Investigate  β”‚  β–Έ Operation Thunder      open  high      2h ago                 β”‚
β”‚   Logs       β”‚  β–Έ Phishing Campaign A    open  medium    1d ago                 β”‚
β”‚   Network    β”‚                                                                  β”‚
β”‚   Timeline   β”‚                                                                  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Screenshots coming soon. The build is fully working β€” run npm run dev to see it live.


🧰 Capabilities

πŸ—‚οΈ Case Management

Feature Description
Cases Create, prioritize, tag, and filter investigations. Active case follows you across tools.
Evidence Per-case evidence registry with hashes, source paths, and notes.
Chain of Custody Every transfer/review action is logged with timestamp + actor and hash-chained.
Activity Log Append-only, hash-chained log of every operation. Verify integrity on demand.

πŸ”¬ File & Artifact Analyzers

Tool What it does
File Analyzer MD5/SHA-1/SHA-256/SHA-512 hashing, magic-byte detection, extension-mismatch alerts, entropy scoring, string extraction, EXIF, hex view, automatic hash-DB lookup, JSON export.
Image Forensics EXIF, GPS extraction, manipulation hints, thumbnail/embedded data review.
Strings / IOC Hunter Extract printable strings and surface IPs, URLs, emails, hashes, BTC wallets, JWTs, and custom regex.
Archive Analyzer Inspect ZIP / TAR contents, flag suspicious entries, detect path-traversal payloads.
Disk Image Walk partitions and recover file metadata from raw .dd / .img files.

🌐 Artifact Recovery

Tool What it does
Browser Artifacts History, downloads, cookies, and visit timelines from Chrome / Edge / Firefox profiles.
System Info Live OS, CPU, memory, network, and process snapshots β€” for triage on the responder's own box.
Registry Analyzer (Windows) Parse hives, browse keys, inspect values.
Email Analyzer .eml / .msg parsing with header authentication (SPF/DKIM/DMARC) and attachment inventory.

πŸ” Investigation

Tool What it does
Log Analyzer Multi-format log ingestion (syslog, JSON, generic) with severity grouping, pattern search, and CSV export.
Network / PCAP Packet capture summaries, conversation views, protocol breakdowns, suspicious-flow flags.
Filesystem Timeline Unified MAC time view across a directory tree with CSV export.
SQLite Browser Open any .sqlite / .db and run ad-hoc SQL safely.

πŸ“š Knowledge & Reporting

Tool What it does
Hash Database Local known-good / known-bad / suspicious lookup with NSRL-compatible CSV import. Batch lookup mode.
Reports Generate branded PDF reports per case β€” evidence, hashes, findings, custody chain.
Settings Investigator defaults, accent color, density, hash algorithm preferences, VirusTotal API key.

⌨️ Keyboard Shortcuts

Press ? anytime for the full cheat-sheet. Highlights:

Shortcut Action
⌘/Ctrl+K Open command palette
? Show shortcuts overlay
Esc Close palette or dialog
g d Dashboard
g c Cases
g a Activity log
g f File analyzer
g h Hash database
g t Timeline
g s Settings
g w Watchlist
g x Compare files
/ Focus on-page search / filter
Drop a file Opens it in File Analyzer
Paste a hash in ⌘K Quick hash-DB lookup or add to watchlist
Paste a path in ⌘K Instantly analyze that file
⭐ Click star icon Pin / unpin a tool to the sidebar top

πŸš€ Getting Started

Prerequisites

  • Node.js β‰₯ 18
  • npm β‰₯ 9
  • Native build toolchain for better-sqlite3:
    • macOS β€” Xcode Command Line Tools (xcode-select --install)
    • Linux β€” sudo apt install build-essential python3
    • Windows β€” Visual Studio Build Tools (Desktop development with C++)

Install & Run

git clone https://github.com/at0m-b0mb/ArtifactScope.git
cd ArtifactScope
npm install
npm run dev

The Electron window will open with hot-reload across renderer and main.

Build for Distribution

npm run build         # bundle main + preload + renderer
npm run build:mac     # macOS .dmg
npm run build:win     # Windows .exe installer
npm run build:linux   # Linux AppImage / .deb

Output lands in dist/ (installer-ready) and out/ (unpacked).

Quality Gates

npm run typecheck     # strict TS across main + renderer

πŸ—οΈ Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Renderer  (React 18 + Tailwind + Framer Motion)   β”‚  ← UI, pages, stores, shortcuts
β”‚    └─ src/renderer/src                             β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  Preload   (contextBridge)                         β”‚  ← typed IPC surface
β”‚    └─ src/preload/index.ts β†’ window.bridge         β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  Main      (Electron + Node)                       β”‚
β”‚    β”œβ”€ src/main/forensics  β€” analyzers              β”‚
β”‚    β”œβ”€ src/main/db         β€” SQLite stores          β”‚
β”‚    └─ src/main/util       β€” logging, paths, …      β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Stack

  • Electron 32 + electron-vite β€” desktop shell & build pipeline
  • React 18 + React Router 6 + Zustand β€” UI and state
  • Tailwind CSS + lucide-react + framer-motion β€” design system
  • better-sqlite3 β€” local case database, hash DB, activity log
  • recharts β€” visualizations
  • exifreader, node-stream-zip β€” artifact parsers

πŸ” Privacy & Data

  • All databases live under the OS-appropriate user-data directory (~/Library/Application Support/ArtifactScope, %APPDATA%\ArtifactScope, ~/.config/ArtifactScope).
  • No telemetry. No background network calls unless you configure an external integration (e.g., VirusTotal API key in Settings).
  • Custody, evidence, and activity rows are hash-chained β€” any tampering breaks the chain at the next integrity check (Activity Log β†’ Verify Integrity).
  • Generated PDF reports are local files you choose to share, not auto-uploaded.

πŸ—ΊοΈ Project Layout

src/
β”œβ”€β”€ main/                # Electron main process
β”‚   β”œβ”€β”€ db/              # SQLite stores: cases, evidence, custody, hashdb, activity
β”‚   β”œβ”€β”€ forensics/       # File / image / log / pcap / registry / email / disk analyzers
β”‚   β”œβ”€β”€ util/            # Logging, paths, progress events
β”‚   β”œβ”€β”€ ipc.ts           # IPC channel registry
β”‚   └── index.ts         # App bootstrap & window lifecycle
β”œβ”€β”€ preload/
β”‚   └── index.ts         # contextBridge β€” exposes the typed `window.bridge` API
└── renderer/
    └── src/
        β”œβ”€β”€ components/  # ui/ + layout/ primitives, CommandPalette, ShortcutsHelp, WelcomeModal
        β”œβ”€β”€ pages/       # One file per tool (Dashboard, FileAnalyzer, HashDB, …)
        β”œβ”€β”€ lib/         # api wrapper, formatters, classnames, storage, export, shortcuts
        β”œβ”€β”€ stores/      # Zustand stores (case, UI)
        └── styles/      # Tailwind entry & globals

🧭 Roadmap

Planned, in rough priority order:

  • Hash DB integrations β€” VirusTotal, MalwareBazaar lookup with caching.
  • YARA-rule support in the IOC Hunter.
  • Memory dump triage (Volatility profiles).
  • Multi-investigator mode with per-user accountability.
  • Report templates β€” Markdown / Word in addition to PDF.
  • Light theme to complement the existing accent picker.
  • Plugin SDK for custom analyzers.
  • Encrypted case archives for hand-off between investigators.

🀝 Contributing

Issues and PRs welcome. Please:

  1. Keep changes focused β€” one feature/fix per PR.
  2. Add types for any new IPC channel in src/preload/index.ts.
  3. Run npm run typecheck and npm run build before opening a PR.
  4. Match the existing component patterns in src/renderer/src/components/ui.

πŸ“„ License

MIT Β© ArtifactScope contributors.


Built for forensic officers, blue-teamers, and curious minds.
Local-first by design β€” your evidence never leaves your machine unless you choose to share it.

About

Cross-platform digital forensics toolkit built with Electron, React, and TypeScript. Watchlists, artifact analysis, case management, and file comparison for cybersecurity investigations.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages