Install

Install Python 3.7 or newer
Clone LTC to a local folder and change into the path

git clone https://github.com/MaltegoTech/maltego-ltc.git
cd maltego-ltc

Install dependencies in virtualenv

virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

If you got an Error regarding SSL on a Mac using brew you may have to add these FLAGS for devices using Apple Silicon you may try this (as default homebrew bin directory differs)

  export LDFLAGS="-L/opt/homebrew/opt/openssl@1.1/lib"
  export CPPFLAGS="-I/opt/homebrew/opt/openssl@1.1/include"

Update the path in the Config file

source venv/bin/activate
python3 project.py list

Import the Maltego Config file local.mtz into Maltego. If you just want to use specific modules, it is possible to just import the module mtz e.g. holehe.local.mtz
Edit maltego-ltc/venv/lib/python3.11/site-packages/pygle/config.py if you want to use wigle insert your API Key there, if not just insert fake info (otherwise you will get an parse error)

Update

source venv/bin/activate
git pull
pip install -r requirements.txt
python3 project.py list

The just switch to Maltego and import to Module mtz or the local.mtz to import all transforms from all Modules.

Bring your own Transforms to maltego-ltc

Pull the last version of maltego-ltc and create a new branch (git checkout -b branch_name)

Before you start writing transforms create your own "Module" to do so use the python script create_module.py. It will create a sub-dir with the necessary files in the "modules"-folder.

When done coding create a pull-request.

Update or create of MTZ files

To recreate the local.mtz files, just run python3 project.py list

Modules

We advise the following structure. In any case, the transforms need to be in a dir called transforms.

modules
└── <module_name>
    └── transforms
        └── <transform_name>.py

You can optionally specify a whitelist or blacklist in project.py. To disable them set them to None

Create a module

To create a module

use the python script create_module.py. The script needs following positional arguments: name author owner.

usage: create_module.py [-h] name author owner

positional arguments:
  name        The module name
  author      your email address, alias or Fullname
  owner       You, or the organization you write this module for

e.g.

source venv/bin/activate
python3 create_module.py my_module me@myself.com "Me Inc."

Edit in the top-level of the extensions.py file and add following lines:

from modules.{name}.extensions import {name}_registry

registry.include_registry("{name}", {name}_registry

e.g. name = 'cisa'

from meta_registry import MetaRegistry
from modules.cisa.extensions import cisa_registry

registry = MetaRegistry()
registry.include_registry("cisa", cisa_registry)