megadose · TURROKS · May 20, 2023 · May 20, 2023 · May 20, 2023 · May 20, 2023
diff --git a/.env b/.env
@@ -0,0 +1 @@
+INTERPRETER=./venv/bin/python3
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,279 @@
+# Created by https://www.toptal.com/developers/gitignore/api/python,pycharm
+# Edit at https://www.toptal.com/developers/gitignore?templates=python,pycharm
+
+### PyCharm ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+*.mtz
+
+# AWS User-specific
+.idea/**/aws.xml
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# SonarLint plugin
+.idea/sonarlint/
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+### PyCharm Patch ###
+# Comment Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-215987721
+
+# *.iml
+# modules.xml
+# .idea/misc.xml
+# *.ipr
+
+# Sonarlint plugin
+# https://plugins.jetbrains.com/plugin/7973-sonarlint
+.idea/**/sonarlint/
+
+# SonarQube Plugin
+# https://plugins.jetbrains.com/plugin/7238-sonarqube-community-plugin
+.idea/**/sonarIssues.xml
+
+# Markdown Navigator plugin
+# https://plugins.jetbrains.com/plugin/7896-markdown-navigator-enhanced
+.idea/**/markdown-navigator.xml
+.idea/**/markdown-navigator-enh.xml
+.idea/**/markdown-navigator/
+
+# Cache file creation bug
+# See https://youtrack.jetbrains.com/issue/JBR-2257
+.idea/$CACHE_FILE$
+
+# CodeStream plugin
+# https://plugins.jetbrains.com/plugin/12206-codestream
+.idea/codestream.xml
+
+# Azure Toolkit for IntelliJ plugin
+# https://plugins.jetbrains.com/plugin/8053-azure-toolkit-for-intellij
+.idea/**/azureSettings.xml
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# End of https://www.toptal.com/developers/gitignore/api/python,pycharm
diff --git a/.idea/holehe-maltego.iml b/.idea/holehe-maltego.iml
diff --git a/Misc/installation-image/import.png b/Misc/installation-image/import.png
diff --git a/Misc/installation-image/interpreter.png b/Misc/installation-image/interpreter.png
diff --git a/Misc/installation-image/mtz_file.png b/Misc/installation-image/mtz_file.png
diff --git a/Misc/installation-image/mtz_location.png b/Misc/installation-image/mtz_location.png
diff --git a/README.md b/README.md
@@ -1,10 +1,49 @@
 # [Holehe](https://github.com/megadose/holehe/) Maltego Transform
 #### For BTC Donations : 1FHDM49QfZX6pJmhjLE5tB2K6CaTLMZpXZ
-holehe allows you to check if the mail is used on different sites like twitter, instagram and will retrieve information on sites with the forgotten password function.
+holehe allows you to check if the mail is used on different sites like Twitter, instagram and will retrieve information 
+on sites with the forgotten password function.
 Educational purposes only
 
-## 🛠️ For the Installation check the [wiki](https://github.com/megadose/holehe-maltego/wiki/Installation)
 ## Example
 ![](Misc/demo.gif)
+
+## Installation
+
+Install the required libraries by running
+
+`pip install -r requirements.txt`
+
+A Maltego configuration file **Maltego-HOLEHE.mtz** can be automatically generated to easily import the Transforms and 
+Transform Set into your client.
+
+First you need to update your ENV file with the Path to your Python Interpreter.
+
+1. Open the project's directory "holehe-maltego".
+2. Locate the .env file (Enable show Hidden files if using your OS explorer) and add the path to your Python 
+interpreter without spaces.
+
+![interpreter.png](Misc/installation-image/interpreter.png)
+
+Now we are ready to generate the Maltego-HOLEHE.mtz configuration file
+
+1. Open your Terminal and go to your project's main directory.
+2. Run `python3 project.py list`
+
+![mtz_file.png](Misc/installation-image/mtz_file.png)
+
+That's all you need, you should now have the new configuration file inside your project.
+
+![mtz_location.png](Misc/installation-image/mtz_location.png)
+
+Simply import the file into your client by going to Import | Export > Import Config > Select mtz file.
+
+![import.png](Misc/installation-image/import.png)
+
+Your new configuration file includes a Transform set called "HOLEHE" which will arrange your new Transforms into a 
+submenu, making them easier to find and use.
+
+If you are a more advanced user and want to manually add the Transforms to your client, you can check 
+the [wiki](https://github.com/megadose/holehe-maltego/wiki/Installation)
+
 ## 📝 License
 [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.fr.html)
diff --git a/extensions.py b/extensions.py
@@ -1,14 +1,16 @@
-from maltego_trx.decorator_registry import TransformRegistry
+from maltego_trx.decorator_registry import TransformRegistry, TransformSet
 
 registry = TransformRegistry(
-        owner="Mario Rojas",
-        author="Mario Rojas <mariro_ch@hotmail.com>",
+        owner="Megadose/Mario Rojas (aka Turroks)",
+        author="Megadose/Mario Rojas (aka Turroks)",
         host_url="https://transforms.mro.com",
         seed_ids=["holehe"]
 )
 
 # The rest of these attributes are optional
 
+holehe_set = TransformSet('HOLEHE', "Maltego HOLEHE Transforms")
+
 # metadata
 registry.version = "0.1"
 

diff --git a/project.py b/project.py
@@ -1,3 +1,4 @@
+import os
 import sys
 import transforms
 
@@ -6,10 +7,12 @@
 from maltego_trx.handler import handle_run
 from extensions import registry
 
+
 # register_transform_function(transform_func)
 register_transform_classes(transforms)
 
 registry.write_transforms_config()
 registry.write_settings_config()
+registry.write_local_mtz("./Maltego-HOLEHE.mtz", command=os.getenv("INTERPRETER"), debug=False)
 
 handle_run(__name__, sys.argv, app)
diff --git a/requirements.txt b/requirements.txt
@@ -1,3 +1,4 @@
 trio
 holehe
-maltego-trx
+maltego-trx
+python-dotenv
diff --git a/transforms.csv b/transforms.csv
@@ -1,2 +1,2 @@
-Owner,Author,Disclaimer,Description,Version,Name,UIName,URL,entityName,oAuthSettingId,transformSettingIDs,seedIDs
-Mario Rojas,Mario Rojas <mariro_ch@hotmail.com>,,Returns accounts associated with an email address.,0.1,todetailsholehe,Email to Registered Accounts [HOLEHE],https://transforms.mro.com/run/todetailsholehe,maltego.EmailAddress,,,holehe
+Owner,Author,Disclaimer,Description,Version,Name,UIName,URL,entityName,oAuthSettingId,transformSettingIDs,seedIDs,outputEntities
+Megadose/Mario Rojas (aka Turroks),Megadose/Mario Rojas (aka Turroks),,Returns accounts associated with an email address.,0.1,todetailsholehe,Email to Registered Accounts [HOLEHE],https://transforms.mro.com/run/todetailsholehe,maltego.EmailAddress,,,holehe,maltego.Unknown