BQM (Bloodhound Query Merger)

Deduplicate custom BloudHound queries from different datasets and merge them in one customqueries.json file.

BQM (Bloodhound Query Merger)

GitHub forks GitHub stars GitHub license Rawsec's CyberSecurity Inventory

GitHub Workflow Status GitHub commit activity

BQM logo

Tool to deduplicate custom BloudHound queries from different datasets and merge them in one customqueries.json file.


BloodHound allows you to store custom queries in ~/.config/bloodhound/customqueries.json. Most pentester are then downloading a custom queries file from an external project. The issue? There are several projects offering very good queries files but they are all very different and complementary and BloodHound supports only one custom queries file. The solution? What if a tool would index all custom queries files, download them for you, remove duplicate queries and merge them all in one file you can use in BloodHound? That’s what BQM offers, no more query file compromise, more AD compromise!


  • Inventory many query datasets
  • Fetch all query datasets
  • Remove duplicate queries
  • Merge all queries in one file
  • List all available datasets
  • Merge existing customqueries.json to the output
  • Merge local custom queries files as well as remote ones
  • Merge local bqm query sets file
  • Offline support
  • Folder support


No install, just clone the repository and run! No dependencies, just pure Ruby.

git clone && cd bqm
ruby bin/bqm -h

Packaging status

See INSTALL for options with package managers.


Usage: bqm [options]
    -o, --output-path PATH           Path where to store the query file
    -l, --list                       List available datasets
    -i FILE,DIRECTORY,...,           Local custom queries files/directories
        --ignore-default             Ignore the default query-sets.json
    -v, --verbose                    Display the name of the merged files/sets

Example: bqm -o ~/.config/bloodhound/customqueries.json
Example: bqm -o /tmp/customqueries.json -i /tmp/a.json,/home/user/folder


$ bqm -o ~/.config/bloodhound/customqueries.json
[+] The output path /home/noraj/.config/bloodhound/customqueries.json already exists
[?] Do you want to overwrite it? [y/n]
[?] What to do with the existing queries? (merge / discard) [m/d]
[+] Fetching and merging datasets
[+] Removing duplicates
[+] All queries have been merged in /home/noraj/.config/bloodhound/customqueries.json

See DOC for more explanation about some options.


Datasets used by BQM are referenced in data/query-sets.json. They are coming from the following projects:


Made by Alexandre ZANNI (@noraj) for ACCEIS.


Logo made with DesignEvo.