Skip to content

greylensresearch/honeyplot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

Honeyplot

A visual investigation and link-analysis tool for journalists, researchers, and analysts.

Honeyplot is a browser-based tool for mapping relationships between entities, built for open-source researchers, investigative journalists and analysts.

Features

🗂️ Entity Library

Drag-and-drop icons from a categorized sidebar onto the canvas. Entities are organized into groups:

Group Examples
People Person, Group, Government Official, Missing Person, Trafficked Person
Companies Company, Shell Company, Front Company
Financial Transaction, Contract, Cash, Security, Legal Matter, Trademark
Defense Soldier, Military Aircraft, Munitions, Nuclear Technology
Vehicles Car, Truck, Ship, Sailboat, Aircraft
Technology Phone Number, Email, Online Account, File
Infrastructure Port, Oil Well, Church, Temple, Cultural Landmark
Currencies Bitcoin, Dollar, Euro, Ruble, Pound
Products Drugs, Consumable, Crops, Fish, Endangered Species

🔗 Relationship Mapping

Connect any two entities with a directed arrow by long-pressing (or long-touching on mobile) a node and dragging to another. Double-click any arrow to add a label describing the relationship.

diagram-3

🏷️ Node Enrichment

Double-click any node to open an editor and set:

  • Title — a name or identifier for the entity
  • StatusConfirmed, Unconfirmed, or Rumoured, shown as a color-coded dot

🗺️ Map View

Toggle into Map View to switch from the abstract canvas to a geographic basemap (CartoDB light tiles + ArcGIS hillshade). All entity icons can be dragged from the sidebar and pinned to real-world locations. Double-click a map marker to add a label. Use the built-in layer controls to toggle hillshade and labels.

Screenshot 2026-03-07 at 19 00 38

🔍 Minimap

A live minimap in the bottom-right corner gives you a bird's-eye overview of the full canvas as you pan and zoom.

💾 Auto-Save

All canvas state — nodes, edges, labels, statuses, map markers, and viewport position — is automatically saved to localStorage and restored on reload. No manual saving required.

↩️ Undo

Undo the last 5 node additions, edge additions, or map marker drops using the Undo button.

📸 Export to PNG

Right-click anywhere on the canvas to export the current diagram as a diagram.png file at your device's pixel ratio.

How to Use

Building a diagram

  1. Click a group label in the left sidebar to expand its icon set.
  2. Drag an icon onto the canvas to place a node.
  3. Double-click a node to give it a title and status.
  4. To connect two nodes, long-press the source node until a temporary arrow appears, then drag to the target node.
  5. Double-click an arrow to add a relationship label.
  6. Scroll to zoom, drag the canvas to pan.

Switching to Map View

  1. Click Map View in the sidebar.
  2. Drag entity icons onto the map to place georeferenced markers.
  3. Double-click a marker to label it.
  4. Click Return to go back to the canvas.

Exporting

  • Right-click anywhere on the canvas to download a PNG of the current diagram.

Controls

Button Action
Map View / Return Toggle between canvas and geographic map
Undo Remove the last placed node, edge, or map marker
Clear Remove all nodes and edges (or all map markers in Map View)

Technical Notes

  • Built with Konva.js for canvas rendering and Leaflet for map mode.
  • Map tiles from CartoDB and ArcGIS World Hillshade.
  • State is persisted in localStorage keyed by storage version and path, so diagrams are scoped to the page they're opened from.
  • No cookies, no analytics, no network requests (other than CDN assets on first load).

About

Honeyplot is a browser-based tool for mapping relationships between entities, built for open-source researchers, investigative journalists and analysts.

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages