v1.4.0

projectdiscovery/katanav1.4.0Jan 6, 2026by dogancanbakir

AI Summary

Major release introducing headless mode support for the crawler, allowing users to perform browser-based crawling with optional browser display and diagnostic capabilities. Also includes a bug fix for concurrency issues in the hybrid crawler.

Key Highlights

  • Added headless mode support for browser-based crawling
  • New -show-browser option to display the browser during crawling
  • New -enable-diagnostics flag for debugging state failures
  • Fixed concurrency not working as expected in the hybrid crawler

New Features

  • Headless mode support with -headless flag
  • Browser display option (-show-browser)
  • Debug diagnostics for investigating state failures (-enable-diagnostics)

Full Release Notes

## What's Changed

### 🎉 New Features
* Added headless mode support by @Ice3man543 in https://github.com/projectdiscovery/katana/pull/1396

You can try out the headless crawler today with the below steps:

```
# Simple headless crawl, show the browser as well
katana -u https://cloud.projectdiscovery.io -headless -show-browser

# Deeper exploration
katana -u https://ginandjuice.shop -headless -depth 5 -aff

# With debug logging (for investigating state failures, etc) writes diagnostic information in a new directory for debugging purposes along with more verbose logging.
katana -debug -u https://www.github.com -headless -enable-diagnostics
```

### 🐞 Bug Fixes
* Fixed concurrency not working as expected in the hybrid crawler by @majiayu000 in https://github.com/projectdiscovery/katana/pull/1488



## New Contributors
* @majiayu000 made their first contribution in https://github.com/projectdiscovery/katana/pull/1488

**Full Changelog**: https://github.com/projectdiscovery/katana/compare/v1.3.0...v1.4.0