Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/bouligo/cuterecon/llms.txt

Use this file to discover all available pages before exploring further.

QtRecon uses a JSON configuration file to manage all settings, tools, automation rules, and preferences. This file controls how the application behaves and which tools are available for reconnaissance.

​
Configuration file location

The configuration file is located at: 
$XDG_CONFIG_HOME/qtrecon/conf.json
On most Linux systems, this resolves to ~/.config/qtrecon/conf.json.

​
Editing the configuration

You can edit the configuration file in two ways:

GUI editor

Press F10 within QtRecon to open the built-in configuration editor

Manual editing

Edit conf.json directly with your preferred text editor
When editing manually, ensure the JSON syntax remains valid. Invalid JSON will prevent QtRecon from starting.

​
Configuration sections overview

The configuration file is organized into the following main sections:

​
Core settings

Defines file system paths used by QtRecon.
"paths": {
  "nmap_output_dir": "/tmp/QtRecon"
}
Specifies system binaries required for QtRecon’s core functionality.
"core_binaries": {
  "nmap": {
    "binary": "/usr/bin/nmap",
    "args": []
  },
  "terminal": {
    "binary": "/usr/bin/konsole",
    "args": ["-e"]
  },
  "graphical_su": {
    "binary": "/usr/bin/pkexec",
    "args": []
  }
}
Defines custom tools and scripts available in QtRecon. See Tool setup for details.
Maps port numbers to available tools that can be used against those ports.
"ports_associations": {
  "tcp": {
    "80": ["nikto", "sqlmap"],
    "443": ["nikto", "sqlmap"]
  }
}
Defines which tools should automatically execute when specific ports are discovered. See Autorun rules for details.
Application preferences and behavior settings.
"user_prefs": {
  "enable_autorun": true,
  "enable_autorun_on_xml_import": false,
  "confirm_before_tab_removal": true,
  "autosave": false,
  "autosave_interval": 600000,
  "preferred_interfaces": ["tun0", "vpn0", "eth0"],
  "preferred_lport": 8444
}
Custom variables for use in tool configurations. See Variables for details.
Pre-defined code snippets and command templates for common tasks like reverse shells and privilege escalation.
Default Nmap scanning options.
"nmap_options": {
  "ports": "T:-,U:53,161,631",
  "type": "-sS",
  "speed": "-T3",
  "skip_host_discovery": false,
  "version_probing": true,
  "default_scripts": true,
  "os_detection": true,
  "tcp_and_udp": true,
  "additional_args": "-v --min-rate 500"
}

​
Example configuration

A complete example configuration is available at: 
/usr/share/qtrecon/conf.json.example
Copy this file to $XDG_CONFIG_HOME/qtrecon/conf.json to get started with a working configuration.
Start with the example configuration and customize it gradually as you add your own tools and workflows.

​
Next steps

Tool setup

Configure custom tools and binaries

Autorun rules

Set up automatic tool execution

Variables

Use variables for dynamic tool arguments

Build docs developers (and LLMs) love

Get started for freeTalk to us