diff --git a/AUTHORS.md b/AUTHORS.md
new file mode 100644
index 0000000..46e853a
--- /dev/null
+++ b/AUTHORS.md
@@ -0,0 +1,15 @@
+About the authors
+==================
+
+Lead developers
+---------------
+
+This software is a personal project leaded by Yaiza Rubio ([@yrubiosec](https://twitter.com/yrubiosec)) and Félix Brezo ([@febrezo](https://twitter.com/febrezo)), both of whom conform the [i3visio](http://i3visio.com) team.
+
+Contributors
+------------
+
+* Eva Suárez ([@EvaSuarez22](https://twitter.com/EvaSuarez22))
+* Lucas Sánchez
+* Fran J. Gómez ([@ffranz](https://twitter.com/ffranz))
+* Abilio Almeida ([@aabilio](https://github.com/aabilio))
diff --git a/MANIFEST.in b/MANIFEST.in
new file mode 100644
index 0000000..b5cf62a
--- /dev/null
+++ b/MANIFEST.in
@@ -0,0 +1,8 @@
+recursive-include config *cfg
+recursive-include config/plugins *sample
+recursive-include osrframework/transforms/lib/osrframework-maltego-settings *
+recursive-include osrframework/transforms/lib *txt
+recursive-include osrframework/static *
+recursive-include osrframework/templates *
+include *md
+recursive-include doc *md
diff --git a/PKG-INFO b/PKG-INFO
new file mode 100644
index 0000000..ce0c578
--- /dev/null
+++ b/PKG-INFO
@@ -0,0 +1,130 @@
+Metadata-Version: 1.1
+Name: osrframework
+Version: 0.17.2
+Summary: OSRFramework - A set of GPLv3+ OSINT tools developed by i3visio analysts for online research.
+Home-page: http://github.com/i3visio/osrframework
+Author: Felix Brezo and Yaiza Rubio
+Author-email: contacto@i3visio.com
+License: COPYING
+Description: OSRFramework
+ ============
+
+ OSRFramework: Open Sources Research Framework
+
+ Copyright (C) 2014-2017 F. Brezo and Y. Rubio, i3visio
+
+ []()
+ []()
+
+ 1 - Description
+ ---------------
+
+ OSRFramework is a GNU AGPLv3+ set of libraries developed by i3visio to perform
+ Open Source Intelligence tasks. They include references to a bunch of different
+ applications related to username checking, DNS lookups, information leaks
+ research, deep web search, regular expressions extraction and many others.
+ At the same time, by means of ad-hoc Maltego transforms, OSRFramework provides
+ a way of making these queries graphically as well as several interfaces to
+ interact with like OSRFConsole or a Web interface.
+
+ 2 - License: GNU AGPLv3+
+ ------------------------
+
+ This is free software, and you are welcome to redistribute it under certain
+ conditions.
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU Affero General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU Affero General Public License for more details.
+
+ You should have received a copy of the GNU Affero General Public License
+ along with this program. If not, see .
+
+
+ For more details on this issue, check the [COPYING](COPYING) file.
+
+ 3 - Installation
+ ----------------
+
+ Fast way to do it on any system for a user with administration privileges:
+ ```
+ pip install osrframework
+ ```
+ You can upgrade to the latest release of the framework with:
+ ```
+ pip install osrframework --upgrade
+ ```
+ This will manage all the dependencies for you and install the latest version of
+ the framework.
+
+ If you needed further information on how to install OSRFramework on certain
+ systems, note that you may need to add `export PATH=$PATH:$HOME/.local/bin` to
+ your `~/.bashrc_profile`). This has been confirmed in some distributions,
+ including MacOS. In any case, we recommend you yo have a look at the
+ [INSTALL.md](doc/INSTALL.md) file where we provide additional details for these
+ cases.
+
+ 4 - Basic usage
+ ---------------
+
+ If everything went correctly (we hope so!), it's time for trying usufy.py,
+ mailfy.py and so on. But we are they? They are installed in your path meaning
+ that you can open a terminal anywhere and typing the name of the program (seems
+ to be an improvement from previous installations...). Examples:
+ ```
+ usufy.py -n i3visio febrezo yrubiosec -p twitter facebook
+ searchfy.py -q "i3visio"
+ mailfy.py -n i3visio
+ osrfconsole.py
+ ```
+
+ Type -h or --help to get more information about which are the parameters of each
+ application.
+
+ You can find the configuration files in a folder created in your user home to
+ define the default behaviour of the applications:
+ ```
+ # Configuration files for Linux and MacOS
+ ~/.config/OSRFramework/
+ # Configuration files for Windows
+ C:\Users\\OSRFramework\
+ ```
+
+ OSRFramework will look for the configuration settings stored there. You can add
+ new credentials there and if something goes wrong, you can always restore the
+ files stored in the `defaults` subfolder.
+
+ 5 - HACKING
+ -----------
+
+ If you want to extend the functionalities of OSRFramework and you do not know
+ where to start from, check the [HACKING.md](doc/HACKING.md) file.
+
+ 6 - AUTHORS
+ -----------
+
+ More details about the authors in the [AUTHORS.md](AUTHORS.md) file.
+
+Keywords: python osint harvesting profiling maltego username socialmedia forums
+Platform: UNKNOWN
+Classifier: Development Status :: 4 - Beta
+Classifier: Topic :: Software Development :: Libraries
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Programming Language :: Python :: 2 :: Only
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Telecommunications Industry
+Classifier: Natural Language :: English
+Classifier: Topic :: Communications
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Text Processing :: Markup :: HTML
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fd4e1a8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,104 @@
+OSRFramework
+============
+
+OSRFramework: Open Sources Research Framework
+
+Copyright (C) 2014-2017 F. Brezo and Y. Rubio, i3visio
+
+[]()
+[]()
+
+1 - Description
+---------------
+
+OSRFramework is a GNU AGPLv3+ set of libraries developed by i3visio to perform
+Open Source Intelligence tasks. They include references to a bunch of different
+applications related to username checking, DNS lookups, information leaks
+research, deep web search, regular expressions extraction and many others.
+At the same time, by means of ad-hoc Maltego transforms, OSRFramework provides
+a way of making these queries graphically as well as several interfaces to
+interact with like OSRFConsole or a Web interface.
+
+2 - License: GNU AGPLv3+
+------------------------
+
+This is free software, and you are welcome to redistribute it under certain
+conditions.
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU Affero General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU Affero General Public License for more details.
+
+ You should have received a copy of the GNU Affero General Public License
+ along with this program. If not, see .
+
+
+For more details on this issue, check the [COPYING](COPYING) file.
+
+3 - Installation
+----------------
+
+Fast way to do it on any system for a user with administration privileges:
+```
+pip install osrframework
+```
+You can upgrade to the latest release of the framework with:
+```
+pip install osrframework --upgrade
+```
+This will manage all the dependencies for you and install the latest version of
+the framework.
+
+If you needed further information on how to install OSRFramework on certain
+systems, note that you may need to add `export PATH=$PATH:$HOME/.local/bin` to
+your `~/.bashrc_profile`). This has been confirmed in some distributions,
+including MacOS. In any case, we recommend you yo have a look at the
+[INSTALL.md](doc/INSTALL.md) file where we provide additional details for these
+cases.
+
+4 - Basic usage
+---------------
+
+If everything went correctly (we hope so!), it's time for trying usufy.py,
+mailfy.py and so on. But we are they? They are installed in your path meaning
+that you can open a terminal anywhere and typing the name of the program (seems
+to be an improvement from previous installations...). Examples:
+```
+usufy.py -n i3visio febrezo yrubiosec -p twitter facebook
+searchfy.py -q "i3visio"
+mailfy.py -n i3visio
+osrfconsole.py
+```
+
+Type -h or --help to get more information about which are the parameters of each
+application.
+
+You can find the configuration files in a folder created in your user home to
+define the default behaviour of the applications:
+```
+# Configuration files for Linux and MacOS
+~/.config/OSRFramework/
+# Configuration files for Windows
+C:\Users\\OSRFramework\
+```
+
+OSRFramework will look for the configuration settings stored there. You can add
+new credentials there and if something goes wrong, you can always restore the
+files stored in the `defaults` subfolder.
+
+5 - HACKING
+-----------
+
+If you want to extend the functionalities of OSRFramework and you do not know
+where to start from, check the [HACKING.md](doc/HACKING.md) file.
+
+6 - AUTHORS
+-----------
+
+More details about the authors in the [AUTHORS.md](AUTHORS.md) file.
diff --git a/config/accounts.cfg b/config/accounts.cfg
new file mode 100644
index 0000000..70800a3
--- /dev/null
+++ b/config/accounts.cfg
@@ -0,0 +1,62 @@
+################################################################################
+#
+# Copyright 2016 Félix Brezo and Yaiza Rubio (i3visio, contacto@i3visio.com)
+#
+# This file is part of OSRFramework. You can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see .
+#
+################################################################################
+
+
+# ==============================================================================
+# The sections in this file should match with the parameter used to work with
+# this platform in the different tools of the framework.
+# ------------------------------------------------------------------------------
+
+[eqe]
+login =
+password =
+
+[flixster]
+login =
+password =
+
+[hi5]
+login =
+password =
+
+[pokerstrategy]
+login =
+password =
+
+[rapid]
+login =
+password =
+
+[researchgate]
+login =
+password =
+
+[spotify]
+login =
+password =
+
+[tripit]
+login =
+password =
+
+[thehoodup]
+login =
+password =
+
+# ==============================================================================
diff --git a/config/api_keys.cfg b/config/api_keys.cfg
new file mode 100644
index 0000000..668f1a6
--- /dev/null
+++ b/config/api_keys.cfg
@@ -0,0 +1,47 @@
+################################################################################
+#
+# Copyright 2016 Félix Brezo and Yaiza Rubio (i3visio, contacto@i3visio.com)
+#
+# This file is part of OSRFramework. You can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see .
+#
+################################################################################
+
+# NOTE: Lines starting with a '#' are comments provided to assist the user.
+
+# ==============================================================================
+# The sections in this file should match with the parameter used to work with
+# this platform in the different tools of the framework.
+# ------------------------------------------------------------------------------
+
+[twitter]
+# You can get these details in:
+consumer_key =
+consumer_secret =
+access_key =
+access_secret =
+
+# ==============================================================================
+
+
+# ==============================================================================
+# The following API keys may be used by other applications in the framework.
+# ------------------------------------------------------------------------------
+
+[md5crack_com]
+api_key =
+
+[pipl_com]
+api_key =
+
+# ==============================================================================
diff --git a/config/browser.cfg b/config/browser.cfg
new file mode 100644
index 0000000..6f1da38
--- /dev/null
+++ b/config/browser.cfg
@@ -0,0 +1,76 @@
+################################################################################
+#
+# Copyright 2016 Félix Brezo and Yaiza Rubio (i3visio, contacto@i3visio.com)
+#
+# This file is part of OSRFramework. You can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see .
+#
+################################################################################
+
+# NOTE: Lines starting with a '#' are comments provided to assist the user.
+
+# ==============================================================================
+# In this section we will define the browser configuration.
+# ------------------------------------------------------------------------------
+
+[Browser]
+
+# The User Agent to be used. More can be found at:
+#
+user_agent = Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Ubuntu Chromium/55.0.2883.87 Chrome/55.0.2883.87 Safari/537.36
+# Seconds considered to timeout a session. Increase this value to something
+# high like 2000 to debug petitions using proxies such as OWASP ZAP.
+timeout = 20000
+
+# ==============================================================================
+
+
+# ==============================================================================
+# In this section we will define the proxy settings. This part is optional.
+# ------------------------------------------------------------------------------
+
+# This is the protocol of the proxy: 'ProxyHTTP' is parsed to 'http'.
+[ProxyHTTP]
+
+# The hostname. It can be an IP Address '127.0.0.1' or a domain 'example.com'.
+host =
+# The port of the proxy.
+port =
+# The credentials to be used if needed. This part is optional.
+username =
+password =
+
+# A full example is below to contact to a running instance of OWASP ZAP:
+#host = localhost
+#port = 8080
+#username = user
+#password = 1234
+
+# This is the protocol of the proxy: 'ProxyHTTPS' is parsed to 'https'.
+[ProxyHTTPS]
+
+# The hostname. It can be an IP Address '127.0.0.1' or a domain 'example.com'.
+host =
+# The port of the proxy.
+port =
+# The credentials to be used if needed. This part is optional.
+username =
+password =
+
+# A full example is below to contact to a running instance of OWASP ZAP:
+#host = localhost
+#port = 8080
+#username = user
+#password = 1234
+
+# ==============================================================================
diff --git a/config/general.cfg b/config/general.cfg
new file mode 100644
index 0000000..e955215
--- /dev/null
+++ b/config/general.cfg
@@ -0,0 +1,184 @@
+################################################################################
+#
+# Copyright 2016 Félix Brezo and Yaiza Rubio (i3visio, contacto@i3visio.com)
+#
+# This file is part of OSRFramework. You can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see .
+#
+################################################################################
+
+# NOTES:
+# - Lines starting with a '#' are comments provided to assist the user.
+# - If something goes wrong and you cannot fix it, delete this file to let the
+# system restore a valid version.
+
+
+# ==============================================================================
+# In this section we will define the default OSRFramework server configuration.
+# ------------------------------------------------------------------------------
+
+[osrframework-server]
+
+# Host of the server. It can be localhost or things like 0.0.0.0 (which would
+# make it accesible from everywhere):
+host = localhost
+#host = 0.0.0.0
+# The port to be used:
+port = 30230
+# Whether to use it in debug mode. False is 0 and True is 1.
+debug = 0
+# This string should be something random to control who can configure the
+# searches. If this string is intercepted, anyone would be able to configure
+# OSRFramework using a specially crafted URL to do what they want, not what
+# the admin wanted. If None is provided, advanced searches will be blocked.
+secret_token =
+#secret_token = thisstringshould_besomething-random-NotJoking-so-ChangeMe
+upload_folder = /tmp/
+
+# ==============================================================================
+
+
+# ==============================================================================
+# In this section we will define the default domainfy configuration.
+# ------------------------------------------------------------------------------
+
+[domainfy]
+
+# Tlds to be checked by default. It can include several tld:
+tlds = global
+#tlds = global generic cc brand geographic
+# Folder where the output files will be created (without the file name):
+output_folder = ./
+# Name of the output file to be used (without the extension):
+file_header = profiles
+# Extensions to be created. It can include several extensions:
+extension = csv
+#extension = csv xls xlsx
+# Number of threads to be used. It should be an integer:
+threads = 32
+# Domains to be manually added
+user_defined =
+#user_defined = .i3visio.com
+# Domains to be manually excluded
+exclude_domains =
+#exclude_domains = .com .net .org
+
+# ==============================================================================
+
+# ==============================================================================
+# In this section we will define the default entify configuration.
+# ------------------------------------------------------------------------------
+
+[entify]
+
+# Folder where the output files will be created (without the file name):
+output_folder = ./
+# Name of the output file to be used (without the extension):
+file_header = profiles
+# Extensions to be created. It can include several extensions:
+extension = csv
+#extension = csv xls xlsx
+
+# ==============================================================================
+
+# ==============================================================================
+# In this section we will define the default mailfy configuration.
+# ------------------------------------------------------------------------------
+
+[mailfy]
+
+# Domains to be checked by default. It can include several extensions:
+domains = all
+#domains = gmail.com prontonmail.com
+# Folder where the output files will be created (without the file name):
+output_folder = ./
+# Name of the output file to be used (without the extension):
+file_header = profiles
+# Extensions to be created. It can include several extensions:
+extension = csv
+#extension = csv xls xlsx
+# Number of threads to be used. It should be an integer:
+threads = 32
+# Domains to be manually excluded
+exclude_domains =
+#exclude_domains = gmail.com hotmail.com
+
+# ==============================================================================
+
+# ==============================================================================
+# In this section we will define the default phonefy configuration.
+# ------------------------------------------------------------------------------
+
+[phonefy]
+
+# Platforms to be checked by default. It can include several extensions:
+platforms = all
+#platforms = listaspam
+# Folder where the output files will be created (without the file name):
+output_folder = ./
+# Name of the output file to be used (without the extension):
+file_header = profiles
+# Extensions to be created. It can include several extensions:
+extension = csv
+#extension = csv xls xlsx
+# Platforms to be manually excluded
+exclude_platforms =
+#exclude_platforms = twitter skype
+
+# ==============================================================================
+
+# ==============================================================================
+# In this section we will define the default searchfy configuration.
+# ------------------------------------------------------------------------------
+
+[searchfy]
+
+# Platforms to be checked by default. It can include several extensions:
+platforms = all
+#platforms = twitter facebook github
+# Folder where the output files will be created (without the file name):
+output_folder = ./
+# Name of the output file to be used (without the extension):
+file_header = profiles
+# Extensions to be created. It can include several extensions:
+extension = csv
+#extension = csv xls xlsx
+# Platforms to be manually excluded
+exclude_platforms =
+#exclude_platforms = twitter skype
+
+# ==============================================================================
+
+# ==============================================================================
+# In this section we will define the default usufy configuration.
+# ------------------------------------------------------------------------------
+
+[usufy]
+
+# Platforms to be checked by default. It can include several extensions:
+platforms = all
+#platforms = twitter facebook instagram github youtube
+# Folder where the output files will be created (without the file name):
+output_folder = ./
+# Name of the output file to be used (without the extension):
+file_header = profiles
+# Extensions to be created. It can include several extensions:
+extension = csv
+#extension = csv xls xlsx
+# Number of threads to be used. It should be an integer:
+threads = 16
+# Platforms to be manually excluded
+exclude_platforms =
+#exclude_platforms = twitter skype
+
+# ==============================================================================
diff --git a/config/plugins/pattern.py.sample b/config/plugins/pattern.py.sample
new file mode 100644
index 0000000..0eae874
--- /dev/null
+++ b/config/plugins/pattern.py.sample
@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+#
+##################################################################################
+#
+# Copyright 2016 Félix Brezo and Yaiza Rubio (i3visio, contacto@i3visio.com)
+#
+# This program is part of OSRFramework. You can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see .
+#
+##################################################################################
+
+
+from osrframework.utils.regexp import RegexpObject
+
+class DemoPattern(RegexpObject):
+ '''
+ class.
+ '''
+ def __init__(self):
+ '''
+ Constructor without parameters.
+ Most of the times, this will be the ONLY method needed to be overwritten.
+
+ :param name: string containing the name of the regular expression.
+ :param reg_exp: string containing the regular expresion.
+ '''
+ # This is the tag of the regexp
+ self.name = "i3visio.demo"
+ # This is the string containing the reg_exp to be seeked
+ self.reg_exp = ["[^a-zA-Z1-9]" + "[0-9]{4}-?[A-Z]{3}" +"[^a-zA-Z1-9]"]
+
+ def isValidExp(self, exp):
+ '''
+ Method to verify if a given expression is correct just in case the used regular expression needs additional processing to verify this fact.
+ This method will be overwritten when necessary.
+
+ :param exp: Expression to verify.
+
+ :return: True | False
+ '''
+ return True
+
+
diff --git a/config/plugins/wrapper.py.sample b/config/plugins/wrapper.py.sample
new file mode 100644
index 0000000..9ebcf03
--- /dev/null
+++ b/config/plugins/wrapper.py.sample
@@ -0,0 +1,113 @@
+# !/usr/bin/python
+# -*- coding: utf-8 -*-
+#
+##################################################################################
+#
+# Copyright 2016-2017 Félix Brezo and Yaiza Rubio (i3visio, contacto@i3visio.com)
+#
+# This program is part of OSRFramework. You can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see .
+#
+##################################################################################
+
+__author__ = "John Doe "
+__version__ = "1.0"
+
+import argparse
+import json
+import re
+import sys
+import urllib2
+
+import osrframework.utils.browser as browser
+from osrframework.utils.platforms import Platform
+
+class Demo(Platform):
+ """
+ A object for Demo.
+ """
+ def __init__(self):
+ """
+ Constructor...
+ """
+ self.platformName = "Demo"
+ self.tags = ["demo"]
+
+ ########################
+ # Defining valid modes #
+ ########################
+ self.isValidMode = {}
+ self.isValidMode["phonefy"] = False
+ self.isValidMode["usufy"] = True
+ self.isValidMode["searchfy"] = False
+
+ ######################################
+ # Search URL for the different modes #
+ ######################################
+ # Strings with the URL for each and every mode
+ self.url = {}
+ #self.url["phonefy"] = "http://anyurl.com//phone/" + ""
+ self.url["usufy"] = "https://demo.demo/" + ""
+ #self.url["searchfy"] = "http://anyurl.com/search/" + ""
+
+ ######################################
+ # Whether the user needs credentials #
+ ######################################
+ self.needsCredentials = {}
+ #self.needsCredentials["phonefy"] = False
+ self.needsCredentials["usufy"] = False
+ #self.needsCredentials["searchfy"] = False
+
+ #################
+ # Valid queries #
+ #################
+ # Strings that will imply that the query number is not appearing
+ self.validQuery = {}
+ # The regular expression '.+' will match any query
+ #self.validQuery["phonefy"] = ".*"
+ self.validQuery["usufy"] = ".+"
+ #self.validQuery["searchfy"] = ".*"
+
+ ###################
+ # Not_found clues #
+ ###################
+ # Strings that will imply that the query number is not appearing
+ self.notFoundText = {}
+ #self.notFoundText["phonefy"] = []
+ self.notFoundText["usufy"] = ["THIS IS THE ERROR MESSAGE"]
+ #self.notFoundText["searchfy"] = []
+
+ #########################
+ # Fields to be searched #
+ #########################
+ self.fieldsRegExp = {}
+
+ # Definition of regular expressions to be searched in phonefy mode
+ #self.fieldsRegExp["phonefy"] = {}
+ # Example of fields:
+ #self.fieldsRegExp["phonefy"]["i3visio.location"] = ""
+
+ # Definition of regular expressions to be searched in usufy mode
+ self.fieldsRegExp["usufy"] = {}
+ # Example of fields:
+ #self.fieldsRegExp["usufy"]["i3visio.location"] = ""
+ # Definition of regular expressions to be searched in searchfy mode
+ #self.fieldsRegExp["searchfy"] = {}
+ # Example of fields:
+ #self.fieldsRegExp["searchfy"]["i3visio.location"] = ""
+
+ ################
+ # Fields found #
+ ################
+ # This attribute will be feeded when running the program.
+ self.foundFields = {}
diff --git a/doc/ADVANCED_CONFIGURATION.md b/doc/ADVANCED_CONFIGURATION.md
new file mode 100644
index 0000000..24672cc
--- /dev/null
+++ b/doc/ADVANCED_CONFIGURATION.md
@@ -0,0 +1,4 @@
+Configuring OSRFramework
+========================
+
+TODO.
diff --git a/doc/ALIAS_GENERATOR.md b/doc/ALIAS_GENERATOR.md
new file mode 100644
index 0000000..9d68ef0
--- /dev/null
+++ b/doc/ALIAS_GENERATOR.md
@@ -0,0 +1,4 @@
+Using the Alias Generator Tool
+==============================
+
+TODO.
diff --git a/doc/API.md b/doc/API.md
new file mode 100644
index 0000000..db81b91
--- /dev/null
+++ b/doc/API.md
@@ -0,0 +1,4 @@
+USing the API
+=============
+
+TODO.
diff --git a/doc/CHANGES.md b/doc/CHANGES.md
new file mode 100644
index 0000000..77aec1c
--- /dev/null
+++ b/doc/CHANGES.md
@@ -0,0 +1,761 @@
+OSRFramework Changelog
+======================
+
+For more information, check the README.Add some wrappers
+
+0.17.2, 2017/08/21 -- Fixes with some usernames in Kiwi and Smugmug.
+- Fix issue #288: Remove the `.` as a valid character for usernames in Smugmug
+- Fix issue #287: Remove the `.` as a valid character for usernames in Kiwi
+- Move to pending Oroom and Backyardchickens
+
+0.17.1, 2017/08/20 -- Some fixes and new wrappers.
+- Add feature #283: Add Kiwi usufy wrapper
+- Add feature #284: Add Sarahah usufy wrapper
+- Fix issue #286: Remove intersect.es wrapper as the platform has been changed
+- Fix issue #282: Fix openstreetmap usufy wrapper when using usernames containing a dot
+- Fix issue #280: Fix serieadictos usufy wrapper
+- Fix issue #279: Fix bebee usufy wrapper
+- Fix some issues in osrframework_server and the configuration file
+
+0.17.0, 2017/07/25 -- Prepare the Blackhat Arsenal release
+- Add feature #267: Add a leaked email search using HaveIBeenPwned.
+- Add feature #168: Add Get as a new platform
+- Add feature: Add Seatwish usufy wrapper
+- Add feature: Add Xtube usufy wrapper
+- Add feature: Add coloured output in usufy, mailfy, searchfy, phonefy, entify, osrfconsole and domainfy
+- Add feature: Add colorama utils to general
+- Fix issue #278: Remove bladna.nl usufy wrapper
+- Fix issue #276: Fix trip.com usufy wrapper
+- Fix issue #275: Remove Travian forum usufy wrapper
+- Fix issue #274: Remove Carder usufy wrapper
+- Update the print functions
+- Fix some issues regarding to the display of the license
+- Patch issue #277: Fix creativemarket usufy wrapper
+- General update of the way in which functions in `osrframework.utils.general` are documented as well as removal of unneeded functions.
+- Remove a hack in the export function to set the encoding that implied setting the default encoding using `sys.setdefaultencoding()` and resetting it back after the export.
+
+0.16.8, 2017/06/22 -- Important update on the setup.py to verify whether the .local/bin folder is in the path.
+- Fix issue #187: Review installation with --user in Linux systems where ~/.local/bin is NOT in the PATH
+- Fix issue: Several wrappers have been moved to pending: cardingbins, retailmenot, seatfish and xtube
+
+0.16.7, 2017/06/15 -- Several fixes on certain platforms.
+- Temporally removed some wrappers: apsense, flavors, paypal, pinterest, sokule and wordpress
+- Fix issue #265: False positives in domainfy
+- Fix Dockerfile by removing an unnecessary `sudo`.
+
+0.16.6, 2017/05/28 -- Several fixes domainfy.py options.
+- Add feature #255: Add Metasploit forums as a new usufy wrapper
+- Add feature #254: Add Steemit.com as a new usufy platform
+- Add feature #253: Add cryptofresh as a new usufy platform
+- Fix issue #262: Twitpic now only redirects to Twitter! Thanks for these years, guys!
+- Fix issue #261: Paypal.me usufy wrapper is throwing false positives
+- Fix issue #260: Ello.co has changed its error message
+- Fix issue #259: Gogobot has been moved to trip.com
+- Fix issue #258: Launching usufy.py -n whatever -t all crashes the app
+- Fix issue #256: Wrong command shown when stopping domainfy
+- Fix issue: Rename rapid forum to rapid_i as the platform is rapid-i.com
+- Fix issue: -u option in domainfy.py was not working appropiately
+- Fix issue: Appropiately showing the list of pending domains in domainfy
+
+0.16.5, 2017/04/30 -- Fix mailfy.py by adding a timeout to the verifications.
+- Fix issue #251: Mailfy seems to be crashing persistently
+- Minor refactoring of the mailfy.py documentation and comments
+
+0.16.4, 2017/04/25 -- Fix some OSRFramework false positives and add Taringa, TheVerge and Openstreetmap.
+- Add feature #246: Add theverge.com as a new usufy platform
+- Add feature #238: Add Taringa as a new usufy wrapper
+- Add feature #236: Add Openstreetmap as a new usufy wrapper
+- Fix issue #250: Pinterest wrapper is throwing sometimes false positives
+- Fix issue #249: Ixgames usufy wrapper is throwing false positives
+- Fix issue #248: Echatta usufy wrapper is throwing false positives
+- Fix issue: Break.com was throwing false positives
+- Fix issue: Cartodb was throwing false positives
+- Fix issue: Creativemarket was throwing false positives
+- Rearrange some tags in certain platforms
+
+0.16.3, 2017/04/13 -- Fix OSRFramework false positives.
+- Fix issue #245: Fix BookOfMatches usufy wrapper
+- Fix issue #244: Fix Pinterest usufy wrapper
+- Fix issue #243: Domainfy.py is throwing some false positives
+- Move Stuff platform to pending. It seems that it now permits comments using Facebook Connect
+
+0.16.2, 2017/03/25 -- Fix OSRFramework false positives.
+- Fix issue #240: Fix Dreamstime.me usufy wrapper that is throwing false positives
+- Fix issue #239: Fix Paypal.me usufy wrapper that is throwing false positives
+
+0.16.1, 2017/03/12 -- Fix OSRFramework Server installation.
+- Fix issue: Templates and static files were not appropiately dealt by setup.py
+
+0.16.0, 2017/03/10 -- New major release after participation in the Mobile World Congress Event.
+- Add feature #228: Add Mozilla as a new usufy platform
+- Add feature #226: Provide a docker file to let users install easily using Docker
+- Add feature #223: Providing an API to permit interaction by third party apps
+- Add feature #201: Add Mozilla as a new usufy platform
+- Add feature #196: Add Goblinrefuge as a new usufy platform
+- Add feature #195: Add NotABug as a new usufy platform
+- Add feature #193: Add Crowdin as a new usufy platform
+- Add feature #143: Consider adding beBee to supported platforms
+- Add feature: Add new wrappers as cardingbins.py and unioncarder.py
+- Add feature: Provide a domainfy.py Maltego transform
+- Add feature: Provide an API to be used by other applications
+- Add feature: Provide a GUI to make it easier to launch the commands for newcomers
+- Add feature: Add metadata extraction for all usufy wrappers starting with 'a'
+- Add feature: Add metadata extraction for all usufy wrappers starting with 'b'
+- Add feature: Add Affilorama as a new usufy platform
+- Add feature: Add Abou as a new usufy platform
+- Add feature: Add Canva as a new usufy platform
+- Add feature: Add Cash as a new usufy platform
+- Add feature: Add Codecademy as a new usufy platform
+- Add feature: Add Coderwall as a new usufy platform
+- Add feature: Add Flavors as a new usufy platform
+- Add feature: Add iFunny as a new usufy platform
+- Add feature: Add Moneymaker as a new usufy platform
+- Add feature: Add Okcupid as a new usufy platform
+- Add feature: Add Reddit as a new usufy platform
+- Add feature: Add Reddit as a new usufy platform
+- Add feature: Add V7n as a new usufy platform
+- Add feature: Add Viddler as a new usufy platform
+- Add feature: Add Wikia as a new usufy platform
+- Add feature: Add Bandcamp as a new usufy platform
+- Add feature: Add Codementor as a new usufy platform
+- Add feature: Add Colourlovers as a new usufy platform
+- Add feature: Add Contently as a new usufy platform
+- Add feature: Add Creativemarket as a new usufy platform
+- Add feature: Add Crokes as a new usufy platform
+- Add feature: Add Eightbitme as a new usufy platform
+- Add feature: Add Ello as a new usufy platform
+- Add feature: Add EyEem as a new usufy platform
+- Add feature: Add F6s as a new usufy platform
+- Add feature: Add Fiverr as a new usufy platform
+- Add feature: Add Fotolog as a new usufy platform
+- Add feature: Add Houzz as a new usufy platform
+- Add feature: Add Mig as a new usufy platform
+- Add feature: Add Miiverse as a new usufy platform
+- Add feature: Add Openbugbounty as a new usufy platform
+- Add feature: Add Papaly as a new usufy platform
+- Add feature: Add Patreon as a new usufy platform
+- Add feature: Add Paypal as a new usufy platform
+- Add feature: Add Phishtank as a new usufy platform
+- Add feature: Add Reverbnation as a new usufy platform
+- Add feature: Add Seatwish as a new usufy platform
+- Add feature: Add Soup as a new usufy platform
+- Add feature: Add Technorati as a new usufy platform
+- Add feature: Add Trakt as a new usufy platform
+- Add feature: Add Venmo as a new usufy platform
+- Add feature: Add Witty as a new usufy platform
+- Add feature: Add Younow as a new usufy platform
+- Add feature: Add Dzone as a new usufy platform
+- Add feature: Add Dreamstime as a new usufy platform
+- Add feature: Add Myfitnesspal as a new usufy platform
+- Add feature: Add Datpiff as a new usufy platform
+- Add new subdomains to domainfy in the category other
+- Fix issue #224: Deal with arrays in an entity's value to create two entities of the same type
+
+
+0.15.0, 2017/02/16 -- New major release. Add new wrappers to usufy, mailfy and domainfy. Fix important bugs.
+- Add feature #206: Appropiately capturing Ctrl + C Exceptions to stop the execution feature
+- Add feature #190: Add a new error message to angel.co
+- Add feature #189: Add protonmail.ch as a new mailfy wrapper
+- Add feature #186: Add translate.hola.org as a new usufy wrapper
+- Add feature #185: Add meteor.com as a new platform
+- Add feature #174: Add emoneyspace as a new platform
+- Add feature #161: Making osrfconsole use config values in /general.cfg
+- Add feature #77: Add Blogmarks as a new platform
+- Add feature #76: Add Smugmug as a new platform
+- Add feature #75: Add Typepad as a new platform
+- Add feature #17: Addition of Gravatar
+- Add feature: Add exclude option via the command line to usufy, mailfy, domainfy, searchfy and phonefy
+- Add feature: Add exclude option via the configuration file to usufy, mailfy, domainfy, searchfy and phonefy
+- Add feature: Add other common subdomains to domainfy under the domains/other_subdomains.py
+- Add feature: Add Buddypic wrapper
+- Add feature: Add Carder wrapper
+- Add feature: Add Csu wrapper
+- Add feature: Add Realcarders wrapper
+- Add feature: Add SingleTrackWorld wrapper
+- Add feature: Add TranslateHola wrapper
+- Add feature: Add Warrior wrapper
+- Add feature: Add me.com, icloud.com and seznam.cz to mailfy
+- Add feature: Add second level TLDs to domainfy for CCTLD *.nz, *.pe, *.py and *.uk
+- Add feature: Custom errors for OSRFramework
+- Add feature: Some new structures for the usufy fuzzer
+- Add feature: Let users configure the connections to an HTTP and an HTTPS proxy
+- Add feature: Let users see the list of tags that they can use to select the platforms.
+- Fix issue #219: 0.15.0rc9 raises an exception if it has upgraded
+- Fix issue #212: Badoo throws false positives
+- Fix issue #210: Gsmspain throws false positives
+- Fix issue #208: Web.tv throws false positives
+- Fix issue #205: Return in each main file a Json with the results instead of nothing
+- Fix issue #204: Fix error messages shown in domainfy.py
+- Fix issue #200: Deactivate Youku usufy wrapper
+- Fix issue #199: Deactivate Gytorrents usufy wrapper
+- Fix issue #198: Change Web.tv error message
+- Fix issue #197: Change Metacafe error message
+- Fix issue #188: Capture exceptions when errors are found in the configuration files bug deployment
+- Fix issue #182: Cannot install in virtualenv
+- Fix issue #169: searchfy.py --maltego doesn't disable banner
+- Fix issue #121 by urlencoding each and every parameter provided to usufy, searchfy and phonefy. Indirectly fixes issue #91
+- Fix issue: Overwrite previous browser.cfg and general.cfg files
+- Fix issue: Reactivate tag search in usufy
+- Fix issue: Remove autoopen Skype client if it is not already opened
+- Fix issue: Update user-agent to a more modern one
+- Fix issue: Remove Nubelo wrapper
+- Fix issue: Remove libero.it from mailfy as it is no longer working
+- Fix issue: Deactivate false positives in mailfy for aaathats3as.com, cocaine.ninja, cock.lu, cock.email, firemail.cc, getbackinthe.kitchen, hitler.rocks, memeware.net and waifu.club from cock.li server as well as other false positives in mailfy for noob.com and wp.pl
+- Fix issue: Remove default proxies for HTTP and HTTPS
+- Patch issue #220: Hellboundhackers takes too much time to be processed (moved to pending)
+- Patch issue #218: CSU throws false positives (moved to pending)
+- Patch issue #217: Plancast takes too much time to be processed (moved to pending)
+- Patch issue #216: Aporrealos takes too much time to be processed (moved to pending)
+- Patch issue #215: Artbreak takes too much time to be processed (moved to pending)
+- Patch issue #214: Gitorious takes too much time to be processed (moved to pending)
+- Patch issue #213: Fanbitcoin takes too much time to be processed (moved to pending)
+- Patch issue #211: Dailymail throws false positives (moved to pending)
+- Patch issue #209: Espaciolinux throws false positives (moved to pending)
+- Patch issue #207: forocompraventa throws false positives (moved to pending)
+
+0.14.5, 2016/12/09 -- Add Zotero, Leakforums, CardingHispano, MercadoLibre, Angel, Forospyware, Bubok, etc. (up to 22 new wrappers).
+- Add feature #148: Adding Inkonsky as a new platform.
+- Add feature #142: Adding angel.co as a new usufy platform.
+- Add feature #111: Adding Zotero as a new wrapper.
+- Add feature #110: Adding Bitrated.me as a new platform.
+- Add feature #109: Adding Spreaker as a new platform.
+- Add feature #97: Adding ripenear.me as a new platform.
+- Add feature #96: Adding warriorforum as a new platform with usufy.
+- Add feature #94: Adding cartodb.com as a platform with usufy.
+- Add feature #85: Add muetorrent as a new wrapper. Renamed as a gytorrents.
+- Add feature: Add bubok wrapper.
+- Add feature: Add cardingmx wrapper.
+- Add feature: Add ccm wrapper.
+- Add feature: Add espaciolinux wrapper.
+- Add feature: Add forocompraventa wrapper.
+- Add feature: Add foroptc wrapper.
+- Add feature: Add foros24h wrapper.
+- Add feature: Add forosspyware wrapper.
+- Add feature: Add htcmania wrapper.
+- Add feature: Add losviajeros wrapper.
+- Add feature: Add leakforums wrapper.
+- Add feature: Add cardinghispano wrapper.
+- Add feature: Add mercadolibre wrapper.
+- Add __author__ and __version__ to the wrappers template.
+- Fix issue #183: Web.tv has changed its error.
+- Fix issue #180: Artician wrapper is not working. Moved to pending.
+- Put in quarantine: unsystem and forominecraft.
+- Fix issue: Grab database error in anarchy101.py wrapper.
+- Issue #181, required no action.
+
+0.14.4, 2016/11/06 -- Fix issues #178 and #179 with connectingsingles.com.
+- Fix issue #178: Mailfy not working on Windows.
+- Fix issue #179: Connecting singles has changed its error.
+
+0.14.3, 2016/11/04 -- Fix important issue when deploying on Windows after 0.14.0.
+- Fix issue #177. Found an issue when installing on Windows 0.14.2.
+- Removed temporary files from /tmp when thet are created.
+
+0.14.2, 2016/10/21 -- Add features #106 and #107 and fix #176.
+- Add feature #107: Add keybase.io as a new platform.
+- Add feature #106: Add freekabcer as a new platform.
+- Fix issue #176: Fix Fanpop error message.
+
+0.14.1, 2016/10/15 -- Fix issues related to the installation procedure and adding some new platforms.
+- Add feature #95: Nairaland forum has usufy.
+- Add feature #108: Adding coinbase.com as a new platform.
+- Fix issue #173: Setup.py requires being in the sudoers list even when installing for a single user.
+- Patch issue #175: Moved Naver to pending.
+- Patched an issue in usufy.py that may throw errors when None is returned by getPageWrapper (which should just not happen).
+
+0.14.0, 2016/09/30 -- Added domainfy as a tool to verify the existence of domains and first release of osrfconsole, a console GUI similar to msfconsole.
+- Add domainfy.py application to check the existence of several domains using socket.gethostbyname().
+- Add osrfconsole script to control de utilities in the framework to address issue #158.
+- Add general.cfg to address issue #92 and, indirectly, issue #156.
+- Modify the shebang of alias_generator, domainfy, entify, enumeration, mailfy, osrfconsole, phonefy, searchfy and usufy to `#!/usr/bin/env python2`.
+- Fix issue #172: Remove ummahforum platform.
+- Fix issue #171: Dnspython module does not work in Windows.
+- Add feature #170: Add OneName as a new usufy platform.
+- Fix issue #166: The PLATFORMS variable in osrfconsole does not accept various entries.
+- Fix issue #165: Osrfconsole back command exists instead of unloading.
+- Add feature #163: Adding tip.me as a new platform.
+- Add feature #159: Adding a Console UI to help beginners. Osrfconsole.py is released.
+- Add feature #158: Complementing domain search using whois info in domain finder script.
+- Add feature #157: Adding domain search in a new script.
+
+0.13.2, 2016/07/23 -- Fixed issue #154: OSRFramework 0.13.1 is installed but throws an error when launching usufy.py.
+- Evilzone and Thepiratebay wrappers have been moved to pending as they are conflicting with Skype.
+- Some changes performed in the way in which Skype logs the messages in the console.
+
+0.13.1, 2016/07/20 -- Fixed a deployment issue with versions which are older than 0.13.0.
+- Relevant hotfix deployed to remove any trace of deprecated installations of the framework during the setup. New installs will not perceive the difference.
+
+0.13.0, 2016/07/19 -- Added the possibility of dinamically adding user-defined modules under the configuration folder. Fixed issues #150, #151, #152, #153.
+- Fixed issue #146. Letting the user create new usufy wrappers in its home folder.
+- Fixed issue #147. Letting the user create new entify regexps in its home folder.
+- Fixed issue #150. Ruby-forum.com has changed its base URL.
+- Fixed issue #151. Foodspotting is returning false positives when the first character is a number bug usufy.
+- Fixed issue #152. Bucketlistly is returning false positives when the first character is a number bug usufy.
+- Fixed issue #153. Sample files (wrapper.py.sample and pattern.py.sample) are not copied during the installation. Added a recursive-include clause to MANIFEST.in to collect the sample files in the config/plugins.
+- Addressed issue #149. Bookmarky.com seems not to be working (moved to pending).
+- Updated the process of compiling the regular expressions to validate the usernames for each platform.
+- Fixed a bug that was not capable of setting properly the api_keys.cfg.
+- Modified the configuration file.
+- Removed old wrappers which had been removed.
+- Added a pending folder with wrappers which need to be fixed. They will not be imported.
+- Implemented __eq__ for both wrappers and patterns.
+
+0.12.1, 2016/07/07 -- Fixed issues in Favstar and mailfy.py.
+- Fixed issue #145. Favstar platform returns false positives in usufy when looking for long usernames.
+- Fixed issue #144. mailfy.py returns error with specific domains. The error seemed to be a problem when no mail was loaded.
+- Fixed issue #130. Removing obsolete warning of not properly working in Windows mailfy.
+
+0.12.0, 2016/06/12 -- Fixed issues in 8 platforms when making use of usernames with a ".". URL can be automatically opened in the current web browser. Added 3 new mailfy platforms.
+- Important change in the way of validating the nicknames. Valid expressions are matched now as ".+".
+- Addressed issue #129: Open found URL in the current webbrowser.
+- Fixed issue #141: Btinternet.com as new mailfy platform.
+- Fixed issue #140: Libero.it as new mailfy platform.
+- Fixed issue #139: Ya.ru as new mailfy platform.
+- Fixed issue #138: Causes platform does NOT accept the character "." in the username.
+- Fixed issue #137: Nubelo platform does NOT accept the character "." in the username.
+- Fixed issue #136: Bucketlistly platform does NOT accept the character "." in the username.
+- Fixed issue #135: Burdastyle platform does NOT accept the character "." in the username.
+- Fixed issue #134: Askfm platform does NOT accept the character "." in the username.
+- Fixed issue #133: Gogobot platform does NOT accept the character "." in the username.
+- Fixed issue #132: Rankia platform does NOT accept the character "." in the username.
+- Fixed issue #131: Twitpic platform does NOT accept the character "." in the username.
+
+0.11.7, 2016/06/03 -- Critical bug addressed in the installation process identified as #122. Other minor issues addressed too.
+- Fixed issue #126: Periscope has changed its error message.
+
+0.11.6, 2016/06/03 -- Critical bug addressed in the installation process identified as #122. Other minor issues addressed too.
+- Fixed issue #125: Ibosocial has changed its error for non-existing websites... Changed the error message.
+- Fixed issue #124: Freebase wrapper does not work...
+- Fixed issue #123: Arto has closed its service... :(. Platform removed.
+- Fixed issue with thepiratebay.mk. Added a new message to find platforms which are no longer available.
+- Removed other non working platforms that were maintained unnecessarily.
+
+0.11.5, 2016/05/15 -- Added 16 new email providers for mailfy.py.
+- The following email providers have been whitelisted in mailfy.py: aaathats3as.com, cocaine.ninja, cock.lu, cock.email, firemail.cc, getbackinthe.kitchen, hitler.rocks, lycos.com, memeware.net, rediffmail.com, tuta.io, tutamail.com, tutanota.com, tutanota.de, waifu.club and zoho.com.
+- Some updates done in the mailfy.py blacklists.
+- Addressed isue #120: Xat.com platform has changed its usufy URL. The wrapper has been deactivated.
+
+0.11.4, 2016/04/28 -- Corrected a fix #116 in mailfy.py after breaking a thing before committing...
+- Fixed issue #116: Mailfy.py is now throwing an error message when the email does not exist.
+
+0.11.3, 2016/04/28 -- Several fixes addressed (#116, #115, #114, #113, #112) regarding with obsolete platforms.
+- Fixed issue #115: Worldcarfans is no longer working bug usufy. Removed.
+- Fixed issue #114: Relatious.com platform is broken bug usufy. Removed.
+- Fixed issue #113: Thecarcommunity platform is broken. Removed.
+- Fixed issue #112: New error message in stumbleupon. Removed, the page is now entirely loaded usin javascript.
+- Fixed other issues which were not identified originally: metacafe, youku.
+
+0.11.2, 2016/04/01 -- Fixed issue #105: Error in mailfy, line 238.
+- Fixed issue #105: Error en mailfy (linea 238) bug mailfy. There was a typo in mailfy.py that showed a wrongly modified variable. Removed the "2015" as stated by Pepepy did the trick.
+
+0.11.1, 2016/03/25 -- Issues related to usufy.py platforms that were throwing false positives.
+- Fixed issue #101: Changed the error for gsmspain forums. They had changed the error message.
+- Fixed issue #102: Adtriboo is no longer a valid platform. Removed.
+- Addressed issue #104: Evilzone has been deactivated until we find the new usufy structure.
+
+0.11.0, 2016/03/14 -- Adding configuration files so as to let the user configure credentials and API keys, as well as making the Maltego transforms work with the current architecture.
+- Fixed issue #51: settings for credentials, API keys and connectivity are now stored in the user's home.
+- Fixed issue #65: add threading to mailfy.py to allow parallel queries.
+- Fixed issue #84: fix Maltego installation using the content_scripts. The creation of the Maltego configuration file is currently done by the setup.py script.
+- Fixed issue #88: ods, xls, xlsx are no longer appending results to previously found files. A change in the API now returns only an array of arrays if there is only one sheet.
+- Fixed issue #90: added new documentation files as AUTHORS.md, INSTALL.md and HACKING.md.
+- Fixed issue #93: Issue when installing in Windows v0.11.x. An exception has been added in the general.changePermissionsRecursively function to deal with os.chown issues when running on Windows.
+- Fixed issue #98: Configuration files seem not to be copied correctly in the installation process. In Windows there was a problem with the direction of the slashes. Updated the configuration.py file to address it.
+- Fixed issue #100: With the new installation procedure, networkx should be installed in the system. Added a osrframework/utils/configuration.py file.
+- Transforms adjusted to use a copy of the scripts stored in the transforms folder inside the configuration directory to fix an issue when trying to run the scripts from Maltego, which seems not to be capable of launching them otherwise making calls in the "python usufy.py..." way in Windows systems.
+- Added a MANIFEST.in file to include static files in the ./config folder and the configuration of the transforms.
+- Commented logging text in usufy.py.
+- Added the missing script config_api_keys.py which was previously ignored.
+- Changed the maximum number of threads to be opened by OSRFramework transforms in Maltego as this could lead to problems with the applications.
+- Fixed gsmspain.py wrapper for usufy which was not capable of returning a result properly.
+- Deactivated identi.ca and couchsurfing because the platforms seems to be unstable.
+- Added a browser.cfg to let the user configure OSRFramework browser settings such as the way in which it gets connected to the internet or the user agent.
+- Added an api_keys.cfg file to the configuration file where all the API keys will be stored.
+- Added three new dependencies pyopenssl, ndg-httpsclient, pyasn1 to deal with InsecurePlatformWarning when calling the Twitter API.
+- Removed obsolete functions from osrframework/utils/general.py.
+- Removed the logo.png references.
+
+0.10.5, 2016/02/13 -- Fixed issue #86, Metacafe is returning false positives.
+- Fixed issue #86: Metacafe was returning false positives and the error was updated.
+- Updated a dependency for pyexcel_text package. OSRFramework now works with the latest version.
+
+0.10.4, 2016/02/06 -- Some improvements in the alias generator to address issues #79, #80 and #81. Skype link error message defined as a warning now.
+- Fixed issue #79: some new rules to be added to alias_generator.py.
+- Fixed issue #80: moving the traditional profilesquatting changes to alias_generator.py. Removed the option from usufy.py.
+- Fixed issue #81: all options inserted are now lowercased in alias_generator.
+. Modified the Skype warning message to show what is happening and that a Skype session should be opened by the user.
+- The interactive interface is now aligned and looks better.
+- The birthyear is now the 4th option after the information about the profile.
+- README.md brought back as README.md.
+
+0.10.3, 2016/02/06 -- Fixes in mailfy and some searchfy platforms that got outdated.
+- Fixed issue #83: alias_generator script is throwing an error related to where to find Python.
+- Moved CHANGES.txt to CHANGES and README.md to README.
+- Removed setup.cfg.
+
+0.10.2, 2016/02/03 -- Fixes in mailfy and some searchfy platforms that got outdated.
+- Fixed the searchfy search for the following platforms: facebook and youtube. The wrapper for twitter does NOT accept special characters such as the 'á', 'é', 'í', etc.
+- Added more info to the output of the script to let the user know more info about what is happening.
+- The number of domains to be searched is configurable now with the -d option.
+- Added keemail.me to mailfy.py.
+- Relaxing a requirement for a buggy version of pyexcel_text.
+
+0.10.1, 2016/02/02 -- Two Bitcoin platforms added and a fix introduced to repair aporrealos.
+- fanbitcoin and bitcointa have been added to the platform.
+- A new error message has been added to aporrealos to avoid false positives when the platform throws errors.
+- hotmail.com had to be deactivated from mailfy.py :(.
+
+0.10.0, 2016/01/30 -- New release with several fixes.
+- New platforms added to usufy: archive, ehow, gamesheep, hubpages, kanogames, newgrounds, nubelo, retailmenot, sidereel, thepiratebay, webtv, worldcarfans.
+- Fixed issues linked to mailfy: #56, #57, #58 and #60.
+- Fixed issue #53: adding tabulate dependency to the requirements.txt file.
+- Fixed issue #52: fixed a crash when launching -p wikipedia only in usufy.py and some false positives associated to the platform.
+- Fixed issue #64: foxmail.com has been removed from the list of secure domains.
+- Fixed issue #67: infotelefonica.es has changed its error.
+- Fixed issue #73: more convenient packaging solution with pip. Added osrframework scritps to path.
+- Fixed issue #69: the new installation process has been detailed.
+- Fixes for mailfy platforms which have been deactivated: outlook.com (#69) and sina.com (#70).
+- Different fixes linked to issues #33 (jamiiforums), #43 (qq), #42 (buzznet) and #44 (pixls substitutes rawtherapee).
+- Fixes for about, forosperu, hellboundhackers, ivoox and linkedin.
+- Addressed issue #61: usufy.py --fuzz sample.txt now uses as separator either a '\t' or a ' '.
+- A fix has been introduced in the --fuzz option of usufy.py so as not to stop when a matching pattern has been found.
+- Added a new phonefy platform: kimatel (quienera.es).
+- Removed unused files such as requirements.txt, utils/export.py, utils/timeout.py.
+- Update in the README file.
+
+0.9.14, 2016/01/21 -- Mitigation of several fixes.
+- Fix to issues #46, #47, #48, #49. Mitigating #40, #42, #43, #44, 45.
+- Modification of the Welcome banner for the different utilities. Back to normal.
+
+0.9.13, 2015/11/26 -- Modifications for the Cybercamp.
+- Modification of the Welcome banner for the different utilities.
+- Changed the default extension to .xls as stated in the help.
+- Added a new phonefy platform: infotelefonica.es.
+- Modified the name of the listaspam platform from "listspam" to "listaspam".
+
+0.9.12, 2015/11/18 -- Addition of Periscope.
+- Addition of a wrapper for Periscope.
+- Imported in the setup.py the local osrframework folder to grab the current version number.
+- Fixed some errors in the messages displayed.
+
+0.9.11, 2015/11/13 -- Addition of a new searchfy platform to look for PGP keys, as well as new platforms for mailfy.
+- Added the search in the PGP public key repository by the MIT.
+- Fixed a change in garage4hackers platform.
+- Added new wikipediafr and wikipediapt user search.
+- The platform thehoodup now waits for credentials.
+- Added the sina.com email provider to mailfy.py.
+- Added a message to urge the users to report any issue to .
+- Added a message in mailfy.py when being run under Windows systems to let them know that the app. may behave unexpectedly.
+- Corrected a mistake related to matplotlib.
+- Added a banner text to each script of the framework showing the current version of the libraries.
+
+0.9.10, 2015/10/26 -- Updated the error messages of burbuja.info in response to issue #32.
+- Fixed in the burbuja platform which were confirmed to be working wrongly.
+- Updated a new ebay error message just to try to confirm the reported malfunctioning by some users.
+- Temporally deactivation of jamiiforums platform to try to fix this issue further.
+- Throwing a Warning message when using Twitter API with old versions of ouath library.
+
+0.9.9, 2015/10/18 -- Updated the number of email accounts that con be searched with mailfy.py.
+- We have added a series of email providers in which the emailahoy library is also working: "yeah.net".
+- Added badges to the README.md file.
+
+0.9.8, 2015/10/15 -- Updated the number of email accounts that con be searched with mailfy.py.
+- We have added a series of email providers in which the emailahoy library is also working: "126.com", "163.com", "189.cn", "foxmail.com", "qq.com", "yandex.com".
+
+0.9.7, 2015/09/29 -- Updated the enumeration.py file and corrected the slashdot wrapper.
+- Corrected the slashdot wrapper which was showing the existence of platforms which in fact didn't exist.
+- Commented some references to an old logger in enumeration.py.
+
+0.9.6, 2015/09/22 -- Corrected some installations misconfigurations.
+- Fixed an issue when creating the twitter_api which now will try to grab the api_key in compilation time.
+- A .csv file will be created by default now in usufy, entify, searchfy, mailfy and phonefy.
+- Added a dependency for networkx in requirements.txt.
+- Fixes in the installation instructions.
+
+0.9.5, 2015/09/13 -- Corrected some errors in entify.py.
+- Corrected some errors in entify.py when looking for entities in a folder.
+- Corrected an error when looking for Spanish DNI.
+
+0.9.4, 2015/09/12 -- API integration added to extract information, changes in the export files and added the Twitter API wrapper.
+- Created a osrframework/api folder where all the wrappers to each platform will be included.
+- Considered in platforms.py the chance of using the API if, both, a wrapper exists and the appropriate authentication methods have been provided.
+- Added a Twitter API wrapping the credentials in config_api_credentials.py to make use of Tweepy API.
+- Added networkx library to store the information in a graph format: png and gml have been added.
+- A hack has been used to avoid encoding problems when exporting data.
+- An issue has been detected: python-networkx and python-decorator in Debian-based OS is a problem because they are not up-to-date. Installation from pip is required.
+- Changed the export modules to change the starting "@" in the attributes to a "_" and the "i3visio." headers to "i3visio_" for usability reasons when loading future versions of visualization apps.
+
+0.9.3, 2015/08/28 -- Storing the information of mailfy, entify and phonefy files.
+- Updating the export primitives of the entify, mailfy and phonefy files.
+- Showing some extra text at the beginning of the applications.
+- Fix in the extraction of the i3visio.fullname from Twitter.
+- Fix in the URIs returned from searchfy (previously, '//' was used in twitter and github wrappers).
+
+0.9.2, 2015/08/25 -- Dealing with export issues linked to localization.
+- Dealing with an issue when printing unicode characters in the terminal (specially, in right-to-left languages). A message error will be displayed in the terminal though the information will be stored safely).
+- Back to creation of .xls output files by default. An issue has been detected when creating .ods using Unicode characters. We will wait to test the utility.
+- About.me platform temporally deactivated as it requires javascript.
+
+0.9.1, 2015/08/20 -- Fixes in the export using experimental versions of pyexcel. Release version.
+- Fix an issue linked to the export of Unicode characters in this library. It needs to install an experimental library though.
+- Usufy will display now additional details when being launched: start and end messages as well as time consumed.
+
+0.9.0rc5, 2015/08/19 -- Extraction of attributes reconfigured.
+- Added youtube and github to searchfy.
+- The searchfy file now operates using uri and parsing them.
+- Added a new global variable to be able to apply different types of URLs for the profiles in a platform.
+- Fix in the csv export that overwrote previous files.
+
+0.9.0rc4, 2015/08/18 -- Extraction of attributes reconfigured.
+- Fix in the extraction of Twitter fields.
+- Fix in Twitter and Skype wrappers to return an i3visio.uri.homepage entity for the URIs found in the profiles. Previous approach overrode the profile's URI.
+
+0.9.0rc3, 2015/08/18 -- Extraction of attributes reconfigured.
+- The extraction of attributes from the profiles has been reincluded.
+- The Twitter wrapper recovers now the i3visio.location of a user in usufy mode even when the profile is locked.
+- Fixed the usufy launcher to show the icon.
+- Fixed compatibiliy of the installer for Windows systems.
+
+0.9.0rc2, 2015/08/16 -- Minor changes linked to redistribution.
+- Updating the help texts to include the references to the official repository.
+- The .desktop files do not include now a reference to pantheon-terminal.
+- Updating the publication process.
+- Modification of the regular expressions of the nicks for the following platforms: twitpic, tumblr, rankia, gogobot, buzznet, causes.
+- Added about me wrapper to usufy (removed wefollow).
+
+0.9.0rc1, 2015/08/13 -- First DEB, RPM, compiled version of 0.9.0.
+- Updating setup.py to include some data files in /usr/bin/.
+- Accomdation of the .mtz Maltego file.
+- Creation of .deb, .rpm packages.
+- Updating the README.
+- Creation of .ods output files by default.
+- Addition of icons and desktop launchers for Linux systems (.desktop files).
+
+0.9.0b7, 2015/08/12 -- Fixes in the Maltego transforms.
+- Added Maltego transform: searchfy on Twitter.
+- Added Maltego transform: searchfy on Facebook.
+- Added Maltego transform: searchfy on Skype.
+- Modified Maltego transform: aliasToKnownMails is now operative.
+- The i3visio.location.city entity is extracted correctly when calling ip-api.com API.
+- If the number of entities returned are too many a message will be displayed in the Transform output tab.
+- Debug windows are not shown in production thanks to a new utility included in configure_maltego.py.
+- Fix in Skype wrapper to avoid showing errors messages that make Maltego crash.
+- Remove PIP dependencies: only pip will be required. The other dependencies will be checked when installed and included to be manually installed by the user.
+- Update on the version number from v0.9.0 to 0.9.0 format (without the 'v').
+
+v0.9.0b6, 2015/07/15 -- Minor fix in hi5 that needs credentials right now.
+- Hi5 wrapper has been modified to request credentials.
+
+v0.9.0b5, 2015/07/15 -- Added searchfy platforms for skype, facebook and twitter.
+- Added the searchfy functionality.
+- Fixed the returned objects in usufy (now, it's always a list).
+- Facesaerch and ahmia have been temporally deactivated.
+- The generated output now does not override the file if it already exists. Instead, it reads the previous data and appends the new information.
+
+v0.9.0b4, 2015/07/13 -- Fixed the output when too much information is displayed.
+- The printed table appearing in the terminal will only show values linked to i3visio.alias, i3visio.platform, i3visio.uri and i3visio.fullname. The rest of the information will be printed to the output files.
+- Minor change in the Skype entity previously returned as i3visio.person which now is returned as i3visio.fullname.
+
+v0.9.0b3, 2015/07/13 -- Fixes in tuporno and fanpop.
+- Fixed tupono, fanpop.
+- Setting .csv files as default output extension for usufy.py.
+
+v0.9.0b2, 2015/07/10 -- Notably improved the export capabilities.
+- Fixed an error in the generation of the .csv for usufy.
+- New export formats included in usufy: .ods, text, .xls, .xlsx.
+
+v0.9.0b, 2015/06/24 -- Major restructuration of the internal tool. Addition of new platforms and links.
+- Moved platforms to wrappers and changed platforms.py to utils.
+- Inclusion of old darkfy searches to look for information in Tor platforms.
+- Inclusion of regular expression rules to choose valid names.
+- Inclusion of a new mailfy.py app that verifies whether an email is known as a valid email using emailahoy.
+- Inclusion of a new searchfy.py app that recovers the URL of a search in different platforms.
+- Generation of aliases from a person using alias_generator.py
+- Inclusion of all the variables to include phonefy, usufy and searchfy search in all platforms.
+- Inclusion of plain calls to the different third party API in the main folder.
+- Removed phonefy and usufy folders for structural simplicity.
+- Added a proof of concept option to access all the users of a given platform.
+- Added a facesaerch.py module to look for images.
+- Added an alias to IP platform that tries to resolve the location of a user in Skype.
+- Added a uriToGoogleCacheUri transform.
+- Changed usufy-launcher.py and phonefy-launcher.py to usufy.py and phonefy.py.
+- Changed maltfy folder to transforms.
+- Opening .onion URI using onion.cab service.
+- Updated transforms to match the new distribution.
+- Added BeautifulSoup as a needed llibrary for the installation.
+- Fixed bladna, breakcom, twicsy, spotify, spoj.
+- Deactivating friendsfeed, hellboundhackers and ukdebate (services unavailable for different reasons) and twitch.
+- The Skype platform now returns an i3visio.platform entity as expected.
+
+v0.8.3, 2015/04/09 -- Changed the structure of the returned csv files.
+- Adding the possibility of creating a csv output file.
+
+v0.8.2, 2015/04/08 -- Changed the structure of the returned json files.
+- Fixed an issue that created up to n different json files.
+- The returned json is a list of i3visio.objects and the list returned is now ordered and no longer linked to the nickname searched.
+
+v0.8.1, 2015/04/08 -- Minor fixes on certain platforms which were not working.
+- Fixed the self.notFoundText in: cafemom, pearltreesspoj.
+- Added the self.foundText in: spoj.
+- ResearchGate needs credential now.
+
+v0.8.0, 2015/04/03 -- Improvements in the entity generation and an extensive ip-api.com support.
+- Added Maltego transform: coordinatesToGoogleMapsBrowser.
+- Added Maltego transform: coordinatesToTwitterBrowser.
+- Added Maltego transform: domainToIp_ApiInfo.
+- Added Maltego transform: ipToIp_ApiInfo.
+- Added default fields to every Maltego Entity.
+- Modified Maltego transform: aliasToAllProfiles.
+- Modified Maltego transform: aliasToFamousPlatforms.
+- Modified Maltego transform: aliasToSkypeAccounts.
+- Modified Maltego transform: bitcoinAddressToBlockchainDetails.
+- Modified Maltego transform: domainToGoogleSearchUriWithEmails.
+- Modified Maltego transform: domainToTld.
+- Modified Maltego transform: emailToAlias.
+- Modified Maltego transform: emailToBreachAccounts.
+- Modified Maltego transform: emailToDomain.
+- Modified Maltego transform: emailToSkypeAccounts.
+- Modified Maltego transform: expandPropertiesFromI3visioEntity.
+- Modified Maltego transform: hashToMD5crackDotCom.
+- Modified Maltego transform: ipToIp_ApiInformation.
+- Modified Maltego transform: phoneToPerson.
+- Modified Maltego transform: phoneToMoreInfo.
+- Modified Maltego transform: textToGoogleSearchUri.
+- Modified Maltego transform: textToEntities.
+- Modified Maltego transform: uriToBrowser.
+- Modified Maltego transform: uriToDomain.
+- Modified Maltego transform: uriToEntities.
+- Modified Maltego transform: uriToPort.
+- Modified Maltego transform: uriToProtocol.
+- Fixed errors in cafemom.com and activerain.trulia.com platforms.
+- Requesting credentials for Pokerstrategy and Flixter platforms.
+- Addition of a method to recursively extract the information of the fields and attributes, even when it exceeds the maximum number of queries performed for the free version.
+- Change in the returnOutput methods of MaltegoEntity and MaltegoTransform to make use of an auxiliar getOutputText method.
+- Creation of two new methods in maltfy.lib.maltego to create new entities.
+- Reorganization of ip-api.com json objects returned by the API to display i3visio-like objects.
+- Inclusion of thirdparties.pipl script to perform queries on usernames and emails.
+- Appending a '/' to URL that do not have it when extracting domains or ports.
+- Minor change in the way of grabbing md5crack.com API Key in config_api_keys.py.sample.
+- Reorganization of network transforms onto i3visio.network set.
+- Added new categories: i3visio.location.geo, i3visio.ipv4.
+- Changed the i3visio.protocol icon and moved the i3visio.breach entity to i3visio.person group.
+- Fixed some issues regarding the way of showing the License on each file.
+- Various identation fixes from 't' to ' '.
+- Fixed an error with Trulia platform. A missing pair of quoting marks.
+
+v0.7.1, 2015/01/17 -- Release of v0.7.1.
+- Fix in the domainToGoogleSearchUriWithEmails transform which was wrongly coded.
+
+v0.7.0, 2015/01/17 -- Release of v0.7.0.
+- Added Maltego transform: uriToBrowser.
+- Added Maltego transform: uriToBitcoinAddressEntities.
+- Added Maltego transform: uriToDniEntities.
+- Added Maltego transform: uriToDogecoinAddressEntities.
+- Added Maltego transform: uriToEmailEntities.
+- Added Maltego transform: uriToIPv4Entities.
+- Added Maltego transform: uriToLitecoinAddressEntities.
+- Added Maltego transform: uriToMD5Entities.
+- Added Maltego transform: uriToNamecoinAddressEntities.
+- Added Maltego transform: uriToPeercoinAddressEntities.
+- Added Maltego transform: uriToSHA1Entities.
+- Added Maltego transform: uriToSHA256Entities.
+- Added Maltego transform: uriToUriEntities.
+- Added Maltego transform: textToBitcoinAddressEntities.
+- Added Maltego transform: textToDniEntities.
+- Added Maltego transform: textToDogecoinAddressEntities.
+- Added Maltego transform: textToEmailEntities.
+- Added Maltego transform: textToIPv4Entities.
+- Added Maltego transform: textToLitecoinAddressEntities.
+- Added Maltego transform: textToMD5Entities.
+- Added Maltego transform: textToNamecoinAddressEntities.
+- Added Maltego transform: textToPeercoinAddressEntities.
+- Added Maltego transform: textToSHA1Entities.
+- Added Maltego transform: textToSHA256Entities.
+- Added Maltego transform: textToUriEntities.
+- Added Maltego transform: domainToGoogleSearchUriWithEmails.
+- Added Maltego transform: textToPhoneDetails.
+- Removed Maltego transform: phoneToPerson.
+- Reorganization of transforms in different thematic sets.
+- Refactoring of uriToEntities.py and textToEntities.py python codes to accept a platform parameter in the transform.
+- Changed the name of the Maltego Configuration folder to remove the version in the name.
+- Fix the i3visio.surname2 which was wrongly referred as i3visio.surnme2.
+- Added different entity categories such as: i3visio.hash, i3visio.location, i3visio.person, i3visio.phone, i3visio.web.
+
+v0.6.1, 2015/01/15 -- Correction of a couple of issues in the entities.
+- Added properties by default to i3visio.person.
+- Corrected a reference to a i3visio.phone in infobel_com package (it was identified wrongly as i3visio.location.phone)
+
+v0.6.0, 2015/01/14 -- Creation of Phonefy architecture.
+- Added a Google Search wrapper based on Mario Vilas approach.
+- Added Maltego transform: phoneToPerson.
+- Added Maltego transform: textToGoogleSearchURI.
+- Added Maltego transform: uriToProtocol.
+- Added Maltego transform: uriToPort.
+- Added Maltego transform: uriToDomain.
+- Added Maltego transform: domainToTLD.
+- Added tld, person, fullname, name, surname1, surname2, location.postalcode and location.address entities.
+- Changed the main path for the configuration files
+
+v0.5.0, 2015/01/13 -- Creation of Phonefy architecture.
+- Added Maltego transform: phoneToMoreInfoListspam.
+- Restructuration of phonefy package.
+- Change in uriToEntities.py to use an i3visio Browser.
+- Fix in i3visio.location.province icon.
+
+v0.4.0, 2015/01/11 -- Added the usufy package onto OSRFramework.
+- Added Maltego transform: aliasToAllProfiles.
+- Added Maltego transform: aliasToFamousProfiles.
+- Inclusion of i3visiotools global files as osrframework.utils.
+- Change in old displaying format of usufy entities.
+- Change inheritance of i3visio.uri to i3visio.text (rather than i3visio.object).
+- Change icon of i3visio.platform.
+
+v0.3.0, 2015/01/11 -- Added the extraction of regular expression with entify.
+- Added Maltego transform: textToAllEntities.
+- Added Maltego transform: uriToAllEntities.
+- Added Maltego transform: emailToAlias.
+- Added Maltego transform: emailToDomain.
+- Inclusion of a --quiet option.
+- Inclusion of transforms related to the extraction of entities.
+- Minor changes in the name of entify transforms and i3visio.url has been moved to i3visio.uri.
+- Changed the url.py module to uri.py. References changed everywhere.
+- Added a simple transformation of foo[at]bar[dot]com mails to be foo@bar.com.
+- Fix on i3visio.object entity which was not being imported correctly.
+- Edit configuration of configure_maltego to update also default paths for the transforms.
+
+v0.2.0, 2015/01/07 -- Added Maltego transforms.
+- Added Maltego transform: aliasToSkypeAccounts.
+- Added Maltego transform: bitcoinAddressToBlockchainDetails.
+- Added Maltego transform: emailToBreachedAccounts.
+- Added Maltego transform: emailToSkypeAccounts.
+- Added Maltego transform: hashToMD5crackDotCom.
+- Added Maltego transform: expandPropertiesFromI3visioEntity.
+- Added entities and logos for Peercoin and Namecoin addresses.
+- Removed i3visio.bitcoin, i3visio.litecoin, i3visio.dogecoin entities, as the i3visio.bitcoin.address (et al.) will be used.
+- Added entities for i3visio.port, i3visio.domain and i3visio.protocol.
+- Changed icon for i3visio.dni.
+- Added an autoconfiguration file for Maltego Transforms.
+
+v0.1.0, 2014/12/31 -- Initial release.
+- Added a third-party API wrapper for Skype: checkIPDetails.
+- Added a third-party API wrapper for md5crack.com: checkIPDetails.
+- Added a third-party API wrapper for ip-api.com: checkIPDetails.
+- Added a third-party API wrapper for haveibeenpwned.com: checkIfEmailWasHacked.
+- Added a third-party API wrapper for blockchain.info: getBitcoinAddressDetails.
+- Initial release.
+
+
+[TO-DO]
+Long term:
+- Usage of mashape.com API linked to email verification.
+- Usage of mashape.com API linked to image verification.
+- Inclusions of email verification transforms.
+- Inclusion of a call to pipl.com API.
+- Full normalization of fields.
+- Create Facesaerch and Tor search transforms in Maltego.
+- Recover the logging functions.
+
+[Known issues]
+- Text to deep web search is broken.
+- Recursive expansion of attributes when the cap is reached in Maltego.
+- There is an issue in Maltego Chlorine CE when exporting a transform with the transform.local.parameters popup marked as True: . However, when importing the created .mtz file the popup attribute is not correctly updated not requesting the user who imported the transform the value unless he/she clicks on configure and manually update this value, something which may not be trivial for some users. This issue affects the transform aliasToSelectedPlatforms which will throw an error if not manually configured by the user instead of asking the user to insert the deliberately missing parameters. This is not an OSRFramework issue and has conveniently be notified to Paterva with date of 2015/08/12.
diff --git a/doc/ENTIFY.md b/doc/ENTIFY.md
new file mode 100644
index 0000000..335bd1c
--- /dev/null
+++ b/doc/ENTIFY.md
@@ -0,0 +1,4 @@
+Using entify.py
+===============
+
+TODO.
diff --git a/doc/HACKING.md b/doc/HACKING.md
new file mode 100644
index 0000000..8e92689
--- /dev/null
+++ b/doc/HACKING.md
@@ -0,0 +1,161 @@
+Contributing to OSRFramework
+============================
+
+Reporting issues, bugs and fresh ideas
+--------------------------------------
+
+The way in which we track the issues regarding the software is by means of the issues page in Github's project site, which can be found here: .
+Whether you have experimented problems with the installation, you have found a bug in a new platform or you feel that we can add a new functionality, you can find the place to report them there. The only "rule" is to notify one error per issue to be able to track the problems indepently, as well as trying to provide as much information as possible regarding the OS or version you are trying.
+
+If you find that a transform in Maltego is not behaving as expected, we recommend you to set the debug mode as True. Go to Manage --> Manage Transforms, choose the transform and mark the "Set debug info" as True. Please, copy the information shown in the new tab in the issue so as to provide more information to debug it faster.
+
+Extending OSRFramework
+----------------------
+
+This section will provide information about how to extend the different tools found in the framework.
+
+### Creating new usufy.py wrappers as plugins
+
+Since OSRFramework 0.13.0, we have added the possibility of creating new wrappers as plugins.
+
+The basic things you should know in order to create a new wrapper are:
+* The structure of the URL that links to the profile.
+* The part of the HTML code that says that the user does NOT exist.
+* A valid nickname that has an active profile in the website.
+
+For the example, we are going to use an invented socialnetwork: `http://example.com/james` is the URL of a user called `james` in that figured platform. The error returned is `404 not found`.
+Go to the `plugins/wrappers` folder in your home, copy and rename the `wrapper.py.sample` to `example.py`.
+Thus you will have a template that you will be able to modify.
+
+First, we'll change the name of the wrapper and the tags:
+```
+class Example(Platform):
+ """
+ A object for Example.
+ """
+ def __init__(self):
+ """
+ Constructor...
+ """
+ self.platformName = "Example"
+ self.tags = ["test"]
+```
+
+We'll tell the framework, that this platform has usufy-style profile pages by setting to True the corresponding variable:
+```
+ ########################
+ # Defining valid modes #
+ ########################
+ self.isValidMode = {}
+ self.isValidMode["phonefy"] = False
+ self.isValidMode["usufy"] = True
+ self.isValidMode["searchfy"] = False
+```
+
+We will provide the URL patern:
+```
+ ######################################
+ # Search URL for the different modes #
+ ######################################
+ # Strings with the URL for each and every mode
+ self.url = {}
+ #self.url["phonefy"] = "http://anyurl.com//phone/" + ""
+ self.url["usufy"] = "https://example.com/" + ""
+ #self.url["searchfy"] = "http://anyurl.com/search/" + ""
+```
+
+We will know tell if the platform needs credentials to work:
+```
+ ######################################
+ # Whether the user needs credentials #
+ ######################################
+ self.needsCredentials = {}
+ #self.needsCredentials["phonefy"] = False
+ self.needsCredentials["usufy"] = False
+ #self.needsCredentials["searchfy"] = False
+```
+
+In some platforms, we may now that the usernames always match a given regular expression (for instance, Twitter does not allow '.' in a username). If this is the case, we can modify the `validQuery` attribute:
+```
+ #################
+ # Valid queries #
+ #################
+ # Strings that will imply that the query number is not appearing
+ self.validQuery = {}
+ # The regular expression '.+' will match any non-empty query.
+ #self.validQuery["phonefy"] = re.compile(".+")
+ self.validQuery["usufy"] = re.compile(".+")
+ #self.validQuery["searchfy"] = re.compile(".+")
+```
+
+The last part, is telling the framework which is the message that appears when the user is not present. This is an array, so more than one message can be used here.
+```
+ ###################
+ # Not_found clues #
+ ###################
+ # Strings that will imply that the query number is not appearing
+ self.notFoundText = {}
+ #self.notFoundText["phonefy"] = []
+ self.notFoundText["usufy"] = ["404 not found"]
+ #self.notFoundText["searchfy"] = []
+```
+
+And that's almost all. You can now test OSRFramework as usual. A new option will be available the next time you run the application.
+
+Contributing code
+-----------------
+
+If you want us to include your own wrapper, you will be able to extend the whole framework. Think about the wrapper
+Whether you want to add a new wrapper or fix a bug, the basic instructions to contribute and perform a pull request on Github are the following (we assume that you have installed Git by yourself, so please follow the instructions in the project's website to install it on your system ). We will assume that the username for this test is `osrframework_contributor`.
+
+First of all, logged in Github and fork the repository by pressing the corresponding button in . This will create a copy of the repository under your profile (i. e.: `https://github.com/osrframework_contributor/osrframework`).
+
+You can clone your forked repository now:
+```
+# This is an example! Change "osrframework_contributor" for your nick!
+git clone https://github.com/osrframework_contributor/osrframework
+cd osrframework
+```
+
+Then, you can modify any file you want, for example, adding the new wrapper that you have created in the previous case.
+```
+# Copying the file to the wrappers folder
+mv ~/.config/OSRFramework/plugins/wrappers/example.py ./osrframework/wrappers/
+```
+
+Whenever you want, you can add the changes performed to the Git index to keep track of what you have changed and prepar it for the commit.
+```
+# Add one file
+git add ./osrframework/wrappers/example.py
+# Or adding all the files modified... Just be a little bit more careful
+# git add -A
+```
+
+Once you are happy with the changes (and you have tested them!), you can commit the changes with a descriptive message.
+```
+git commit -m "Adding a new wrapper as example.py."
+```
+
+You have to push the changes to your Github project.
+```
+git push origin
+```
+
+You're almost there. You can now go to your project's website (`http://github.com/osrframework_contributor/osrframework`) and click in the `Pulls` tab or going directly to it by appending `pulls` to your forked URL, something similar to `https://github.com/osrframework_contributor/osrframework/pulls`. Then provide there as much detail as you can about the contents of the pull request and shortly we will evaluate the changes and pushed it upstream.
+
+NOTE: a similar procedure can be performed to add new patterns to entify.py.
+
+Style guide
+-----------
+
+Just a few things to be taken into account:
+* Use four spaces ' ' instead of a tab for identing blocks.
+* Provide useful and not trivial comments in English to the code you write.
+* Classes should start with a capitalised initial letter.
+* As a convention, wrappers inside the `platform_selection.py` should be in alphabetical order. Anyone wants to find things easily!
+
+Licensing
+---------
+
+The only thing we expect from other authors'code is to use a GPL-compatible license for their code, preferably GPLv3+ itself. We hope that anybody can use this tool for free (as in Free Software Foundation's four freedoms, not as in *free beer*), so help us to do it.
+
diff --git a/doc/INSTALL.md b/doc/INSTALL.md
new file mode 100644
index 0000000..ba8e082
--- /dev/null
+++ b/doc/INSTALL.md
@@ -0,0 +1,142 @@
+Installation Instructions
+=========================
+
+More detailed installation instructions can be found in this file. This will use the official package uploaded to pip, but if you prefer to use this with Docker check (this file)[USAGE_WITH_DOCKER.md].
+
+1.- Verifying the Python and Pip Installation
+---------------------------------------------
+
+First of all, on any system we should verify that we have a Python 2.7 installation and a Pip installation setup properly. Opening the terminal or the powershell, we can try the following to check your python installation:
+```
+python --version
+```
+If you get errors at this point or the Python version is not appeating, your system is not yet prepared. You will need to install Python 2.7 from the official website:
+```
+https://www.python.org/downloads/
+```
+Follow the installation steps for your system. Note that in one step of the Windows installation process you WILL NEED to manually add c:\Python27 and C:\Python27\scripts to the system. Try again after completing this task.
+
+Now it's the turn of the package manager. Check that you have the pip version installed:
+```
+pip --version
+```
+If you get any errors at this point, you have several options:
+* If your running Ubuntu or Debian-like systems, try `sudo apt-get install python-pip`.
+* In any case you can always download and install it manually. In Windows-like systems, you do NOT need to type sudo.
+```
+# Going to the downloads folder
+python get-pip.py
+```
+You can do it at a time in GNU/Linux and MacOS systems with a couple of commands:
+```
+# Downloading
+wget https://bootstrap.pypa.io/get-pip.py
+# Installing as root
+sudo python get-pip.py
+```
+Try again and check if the new pip version is installed.
+
+
+2 - Installing OSRFramework from Pip
+------------------------------------
+When installing OSRFramework you have to know that several packages and dependencies will be managed by the installer. The instuctions on how to install this may vary depending on the system.
+
+### In (Most) GNU/Linux Systems and MacOS
+
+The fast way to do it on almost any system is by installing it with:
+```
+pip install osrframework --user
+```
+
+You should be able to run `usufy.py`, `mailfy.py`, etc. from the terminal because these scripts have been added to the `~/.local/bin/` folder.
+
+#### Known Possible Issues
+
+If you are receiving an error saying that it cannot find `usufy.py: command not found`, check if the given folder is in the `PATH` with:
+```
+echo $PATH
+```
+If you cannot find the given folder in the previous output, you can always manually add this folder to your `PATH` by appending these two lines to your `.bashrc` as defined in .
+```
+export PY_USER_BIN=$(python -c 'import site; print(site.USER_BASE + "/bin")')
+export PATH=$PY_USER_BIN:$PATH
+```
+
+You can also try to do it installing the framework as a superuser which would add the scripts to `/usr/local/bin/`.
+
+```
+```
+However, note that both approaches may interfere with other libraries that you may have installed on your system. If you are worried about this issue, check the Virtual Environment section below.
+
+### In Windows Systems
+
+If you have already tested that Python 2.7.x and Pip are installed, this is easy too:
+```
+pip install osrframework
+```
+
+### Using VirtualEnv: Recommended for Devs and Advanced Users
+
+The Python libraries we use in OSRFramework are all required to run different utils in the framework. However, and specially if you are a developer, the required packages may broke dependencies on your system. That's why we also recommend the installation using `virtualenv`, another Python package that tries to address this issue by downloading a copy of the needed packages in a virtualized environment.
+
+To do so, you will need to install it with `virtualenv` so as to avoid problems with dependencies with other libraries. You can use Pip to do so:
+```
+pip install virtualenv --user
+```
+Afterwards, we are creating a virtual environment that we will arbitrarily call `osrframework-virtualenv`. Anyway, you can use the name you choose:
+```
+virtualenv osrframework-virtualenv
+```
+Now, if you want to enter the newly created virtual environment, you have to activate it. Note that this will change your prompt to indicate that you are now in a virtual environment:
+```
+source osrframework-virtualenv/bin/activate
+(osrframework-virtualenv)$
+```
+Now in the new virtual environment you would be able to install osrframework easily and run the applications as usual:
+```
+(osrframework-virtualenv)$ pip install osrframework
+(osrframework-virtualenv)$ usufy.py -h
+```
+Note that, we may have several virtual environments in the same system, but they should be activated before using them. Whenever we want to leave the virtual environment, we can type `deactivate`. This is useful to test different OSRFramework installations in the same system avoiding conflicts between them.
+```
+(osrframework-virtualenv)$ pip install osrframework
+```
+
+3 - Testing the installation
+-------------------------
+
+If everything went correctly (we hope so!), it's time for trying `usufy.py`, `mailfy.py` and so on. But we are they? They are installed in your path meaning that you can open a terminal anywhere and typing the name of the program (seems to be an improvement from previous installations...). Examples:
+```
+usufy.py -n i3visio febrezo yrubiosec -p twitter facebook
+searchfy.py -q "i3visio"
+mailfy.py -n i3visio
+```
+
+4 - Updating the framework
+--------------------------
+
+OSRFramework is a tool in development mantained by its [authors](AUTHORS.md) and, thus, we will fix bugs and add new platforms from time to time. To upgrade your local osrframework installation you can type the following:
+```
+pip install osrframework --upgrade --user
+```
+Depending on how you have installed the framework, you may need to do this as superuser:
+```
+sudo pip install osrframework --upgrade
+```
+This will manage all the dependencies for you and will try to download the latest *stable* version. If you want to try a prerelease version, you can try to upgrade or install it by appending `--pre` tag:
+```
+sudo pip install osrframework --upgrade --pre
+```
+Please, things can be unstable and lead to problems so do it under your responsibility. To minimize the effect of those strange things that may take place, you may think about installing them using `virtualenv`.
+
+### Known Possible Issues in OSRFramework <= 0.14.3 on Windows
+If you had already installed 0.14.3 or earlier versions of the framework on Windows you may face some problems with `mailfy.py` and the libraries it uses. You *should* uninstall first `dnspython` and `pyDNS` before reinstalling `osrframework` again:
+```
+# Uninstalling dnspython
+pip uninstall dnspython
+# Uninstalling pydns
+pip uninstall pydns
+# Reinstalling osrframework, upgrading to most recent version
+pip install osrframework --upgrade
+```
+Anyway, if you are facing any issues regarding the installation keep us posted at .
diff --git a/doc/MAILFY.md b/doc/MAILFY.md
new file mode 100644
index 0000000..e8e93b6
--- /dev/null
+++ b/doc/MAILFY.md
@@ -0,0 +1,4 @@
+Using mailfy.py
+===============
+
+TODO.
diff --git a/doc/MALTEGO_CONFIGURATION.md b/doc/MALTEGO_CONFIGURATION.md
new file mode 100644
index 0000000..a265d10
--- /dev/null
+++ b/doc/MALTEGO_CONFIGURATION.md
@@ -0,0 +1,40 @@
+Maltego Configuration Instructions
+==================================
+
+OSRFramework was conceived to interact with third party applications. One of the
+first approaches was to be compatible with Maltego.
+
+
+Maltego Installation
+--------------------
+
+Maltego is a Java application developed by Paterva that tries to make OSINT
+easier for the analyst. Although it is not a free software project, there is a
+Community Version that can be used without commercial purposes. It can be
+downloaded for your current OS directly from Paterva's website:
+```
+http://www.paterva.com/web6/products/download2.php
+```
+Follow the instructions there. Afterwards, you will be able to launch the app
+and use the different tools developed by third parties.
+
+Configuring Maltego to Work with OSRFramework Transforms and entities
+---------------------------------------------------------------------
+
+Although others have opted for deploying transforms in the cloud in Maltego
+transform hubs, OSRFramework transforms are deployed locally. They are Python
+scripts that convert OSRFramework conventional output to a Maltego-like format
+that can be interpreted by the client conveniently.
+
+The entities and transforms created ad-hoc are shipped within the setup script.
+It will create a .mtz file in the OSRFramework home and under the default folder
+inside the application folder (just in case a disaster happends ;)).
+```
+# Under Linux...
+~/osrframework-maltego-settings_.mtz
+~/.config/OSRFramework/default/osrframework-maltego-settings_.mtz
+```
+
+Once you have located it, you will then have to import this file in Maltego by
+clicking the `Menu --> Import --> Import configuration`. You might have to
+manually check all the types in the installer assistant.
diff --git a/doc/OSRFCONSOLE.md b/doc/OSRFCONSOLE.md
new file mode 100644
index 0000000..97423e5
--- /dev/null
+++ b/doc/OSRFCONSOLE.md
@@ -0,0 +1,4 @@
+Introduction to OSRFConsole
+===========================
+
+TODO.
diff --git a/doc/OSRFRAMEWORK_SERVER.md b/doc/OSRFRAMEWORK_SERVER.md
new file mode 100644
index 0000000..f00c43f
--- /dev/null
+++ b/doc/OSRFRAMEWORK_SERVER.md
@@ -0,0 +1,4 @@
+Using the GUI
+=============
+
+TODO.
diff --git a/doc/OTHER_QUESTIONS.md b/doc/OTHER_QUESTIONS.md
new file mode 100644
index 0000000..2a34ea6
--- /dev/null
+++ b/doc/OTHER_QUESTIONS.md
@@ -0,0 +1 @@
+TODO.
diff --git a/doc/PHONEFY.md b/doc/PHONEFY.md
new file mode 100644
index 0000000..b53d0e7
--- /dev/null
+++ b/doc/PHONEFY.md
@@ -0,0 +1,4 @@
+Using phonefy.py
+================
+
+TODO.
diff --git a/doc/SEARCHFY.md b/doc/SEARCHFY.md
new file mode 100644
index 0000000..0c0c6f8
--- /dev/null
+++ b/doc/SEARCHFY.md
@@ -0,0 +1,4 @@
+Using searchfy.py
+=================
+
+TODO.
diff --git a/doc/USAGE_WITH_DOCKER.md b/doc/USAGE_WITH_DOCKER.md
new file mode 100644
index 0000000..05372fd
--- /dev/null
+++ b/doc/USAGE_WITH_DOCKER.md
@@ -0,0 +1,80 @@
+Using OSRFramework with Docker
+==============================
+
+This file will explain how to use the Docker images for OSRFramework. This will let the reader use the tools easily in almost any platform. To do so, the user will have to install Docker on its computer, what should be enough in most systems.
+
+1.- Verifying Your Docker Installation
+--------------------------------------
+
+Docker is available for Mac, Windows and Linux and can be installed easily in Azure or AWS. We strongly recommend to follow the official guides to install and run Docker in your system. Some good starting points can be found [here](https://docs.docker.com/engine/installation/).
+
+2.- Downloading the Latest OSRFramework Version
+-----------------------------------------------
+
+To run the latest OSRFramework isntallation from Docker you can use the following command:
+```
+> docker run -it i3visio/osrframework:latest
+```
+
+It will download our latest official image. Then, you will be able to login into the Docker image to interact as usual without needing to redownload it again. E. g.:
+```
+> docker run -it osrframework:latest
+root@c79505f6b915:/# usufy.py -n i3visio -p twitter facebook github
+...
+root@c79505f6b915:/# osrfconsole.py
+```
+
+If you want to map the port opened by `osrframework_server.py` you will need to specify it when launching Docker to map the ports and make them accesible. In the following example, we are mapping the 30230 port of the container to port 8080 outside it.
+
+```
+> docker run -it -p 8080:30230 i3visio/osrframework:latest
+```
+
+Once launched `osrframework_server.py` we will be able to interact with the instance outside it using `curl`.
+
+```
+> curl http://localhost:8080/info
+```
+
+3.- Building Your Own Image Locally
+-----------------------------------
+
+As we also provide the Dockerfile, advanced users may opt to build the image themselves. This can be done by _cd-ing_ into the folder of a clones project and using:
+
+```
+> docker build -t osrframework ./
+```
+
+You will be able ro run the built image as usual:
+
+```
+> docker run -it osrframework
+```
+
+If by any circunstamce you prefer to rebuild the instance from scratch, you can always tell it to Docker:
+
+```
+> docker build --no-cache=true -t osrframework ./
+```
+
+### Example of a New Build
+
+As an example, generally we build and push the Docker images as follows:
+```
+> docker login
+> docker build -t osrframework:0.16.6 ./
+> docker tag osrframework:0.16.6 i3visio/osrframework:latest
+> docker push i3visio/osrframework:latest
+> docker run -it i3visio/osrframework:latest
+```
+
+We can always opt to launch a beta vesion:
+
+```
+> docker login
+> docker build -t osrframework:0.16.6 --build-arg VERSION=--pre ./
+> docker tag osrframework:beta i3visio/osrframework:beta
+> docker push i3visio/osrframework:beta
+> docker run -it i3visio/osrframework:beta
+```
+
diff --git a/doc/USUFY.md b/doc/USUFY.md
new file mode 100644
index 0000000..b6914fb
--- /dev/null
+++ b/doc/USUFY.md
@@ -0,0 +1,4 @@
+Using usufy.py
+==============
+
+TODO.
diff --git a/osrframework/__init__.py b/osrframework/__init__.py
new file mode 100644
index 0000000..06b7d04
--- /dev/null
+++ b/osrframework/__init__.py
@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+#
+##################################################################################
+#
+# Copyright 2014-2017 Félix Brezo and Yaiza Rubio (i3visio, contacto@i3visio.com)
+#
+# OSRFramework is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see .
+#
+##################################################################################
+
+import osrframework.utils.logger
+
+# Calling the logger when being imported
+osrframework.utils.logger.setupLogger(loggerName="osrframework")
+__version__="0.17.2"
diff --git a/osrframework/alias_generator.py b/osrframework/alias_generator.py
new file mode 100644
index 0000000..00ba867
--- /dev/null
+++ b/osrframework/alias_generator.py
@@ -0,0 +1,2909 @@
+#!/usr/bin/python2
+# -*- coding: utf-8 -*-
+#
+################################################################################
+#
+# Copyright 2015-2017 Félix Brezo and Yaiza Rubio
+#
+# This program is part of OSRFramework. You can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see .
+#
+################################################################################
+
+
+__author__ = "Felix Brezo, Yaiza Rubio "
+__copyright__ = "Copyright 2015-2017, i3visio"
+__credits__ = ["Felix Brezo", "Yaiza Rubio"]
+__license__ = "AGPLv3+"
+__version__ = "v6.0"
+__maintainer__ = "Felix Brezo, Yaiza Rubio"
+__email__ = "contacto@i3visio.com"
+
+
+import argparse
+import json
+
+import osrframework.utils.banner as banner
+import osrframework.utils.general as general
+
+# GLOBAL OPTIONS
+SEPARATORS = ["_", ".", '']
+COMMON_WORDS = ["666", "home", "mr", "news", "official", "real", "xxx"]
+LOCALES = ["ar", "de", "en", "es", "fr", "ru"]
+LEET_TRANSFORMS = {
+ "a" : ["4"],
+ "b" : ["8"],
+ "e" : ["3"],
+ "i" : ["1"],
+ "l" : ["l"],
+ "o" : ["0"],
+ "s" : ["5"],
+ "t" : ["7"],
+ "z" : ["2"]
+}
+
+
+def main(name=None, surname1=None, surname2=None, city=None, country=None, year=None, useNumbers=False, useCommonWords=False, useLeet=False, useLocales=False, extraWords=[]):
+ """
+ The main method that generates the given aliases.
+
+ It receives several parameters as parsed by this module's `getParser()`.
+
+ Args:
+ -----
+ name: String representing the known name of the investigated profile.
+ surname1: String representing the first surname of the investigated profile.
+ surname2: String representing the second surname of the investigated
+ profile.
+ city: String representing the city where the profile was born or works.
+ country: String representing the country.
+ year: String representing a year linked to the profile.
+ useNumbers: Boolean representing whether to use random numbers at the end.
+ useCommonWords: Boolean representing whether to use known commond words to
+ generate new nicknames.
+ useNumbers: Boolean representing whether to use random numbers at the end.
+ useLeet: Boolean representing whether to modify certain letters by numbers
+ using the leet (*133t*) codification.
+ extraWords: A list of strings with extra words to be appended to the
+ generatednicknames.
+
+ Returns
+ -------
+ list: An ordered list of the nicknames generated.
+ """
+ # Lowering all the info received
+ name = name.lower()
+ surname1 = surname1.lower()
+ surname2 = surname2.lower()
+ year = year.lower()
+ country = country.lower()
+ city = city.lower()
+
+ # Check if the value provided is a '' string
+ if name == '':
+ name = None
+ if surname1 == '':
+ surname1 = None
+ if surname2 == '':
+ surname2 = None
+ if year == '':
+ year = None
+ if city == '':
+ city = None
+ if country == '':
+ country = None
+
+ print("\nGenerating new aliases...")
+
+ lista = []
+
+ try:
+ tmp = name + "" + surname1 + "" + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + "" + surname2 + "" + name
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + "" + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1[0] + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + "" + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + "" + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+
+ try:
+ tmp = name + "" + surname1 + "" + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1[0] + "" + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1[0] + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + "" + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + "" + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + "" + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + "" + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + "" + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + "" + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + "" + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + "" + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + surname2[0]
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1[0] + "" + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + "" + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1[0] + surname2
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + surname2 + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + surname2 + name + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + surname2 + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1[0] + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + "" + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + "" + surname2 + "" + name + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + "" + surname2 + name + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + surname2 + "" + name + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + "" + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + "" + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + "" + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + "" + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + "" + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + "" + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1[0] + "" + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + "" + surname2 + "" + name + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + "" + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + "" + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + "" + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + "" + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + "" + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + "" + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + "" + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + surname2[0] + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1[0] + "" + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + "" + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1[0] + surname2 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + city
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + surname2 + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1[0] + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + "" + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + "" + surname2 + "" + name + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + "" + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + "" + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + "" + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1[0] + "" + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + "" + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + "" + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + "" + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + "" + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + surname1 + "" + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + surname2[0] + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1[0] + "" + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + "" + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1[0] + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name[0] + "" + surname1 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + "" + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + surname1 + "" + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + "" + surname2 + "" + name + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + "" + surname2 + name + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + surname2 + "" + name + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "" + surname1 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = surname1 + "" + surname2 + "" + country
+ if tmp not in lista: lista.append(tmp)
+ except:
+ pass # An element is missing
+
+ try:
+ tmp = name + "