{"id":33245199,"url":"https://github.com/i3visio/usufy","last_synced_at":"2025-12-30T08:05:34.070Z","repository":{"id":62586794,"uuid":"21323896","full_name":"i3visio/usufy","owner":"i3visio","description":"[DISCONTINUED] usufy is a GPLv3+ piece of software that checks the existence of a profile for a given user in a bunch of different platforms.  It uses the error messages displayed by most platforms when a user profile has not been found as the evidence of the existence or not of a given profile. All of these functionalities are now integrated in OSRFramework by i3visio. Thus, usufy will NOT be mantained, but this repository will be here for historical purposes.","archived":false,"fork":false,"pushed_at":"2014-12-26T09:35:49.000Z","size":569,"stargazers_count":7,"open_issues_count":14,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-08-28T21:34:01.161Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/i3visio/osrframework","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/i3visio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.txt","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-06-29T13:35:15.000Z","updated_at":"2024-05-08T17:52:29.000Z","dependencies_parsed_at":"2022-11-03T22:10:16.083Z","dependency_job_id":null,"html_url":"https://github.com/i3visio/usufy","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/i3visio/usufy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i3visio%2Fusufy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i3visio%2Fusufy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i3visio%2Fusufy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i3visio%2Fusufy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/i3visio","download_url":"https://codeload.github.com/i3visio/usufy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i3visio%2Fusufy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28124763,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-30T02:00:05.476Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-11-16T21:00:32.220Z","updated_at":"2025-12-30T08:05:34.053Z","avatar_url":"https://github.com/i3visio.png","language":"Python","readme":"\t=========================================================\n\tusufy  Copyright (C) 2014  F. Brezo and Y. Rubio, i3visio\n\t=========================================================\n\nDescription:\n============\nusufy is a GPLv3+ piece of software that checks the existence of a profile for a given \nuser in a bunch of different platforms using the error messages displayed by most \nplatforms when a user profile has not been found as the evidence of the existence or not \nof a given profile. Its inheritance system has been designed to allow an easy development \nof new wrappers while its multiprocessing conception shows the results fastly.\n\nThe supported networks include by 2014-12-26 are:\n'500px', 'adtriboo', 'anarchy101', 'aporrealos', 'apsense', 'arduino', 'ariva', 'armorgames', 'artbreak', 'artician', 'arto', 'askfm', 'audiob', 'audioboo', 'authorstream', 'autospies', 'backyardchickens', 'badoo', 'behance', 'bennugd', 'bitbucket', 'bitcointalk', 'bitly', 'blackplanet', 'bladna', 'blip', 'blogspot', 'bookmarky', 'bookofmatches', 'boonex', 'bordom', 'boxedup', 'breakcom', 'bucketlistly', 'burbuja.info', 'burdastyle', 'buzznet', 'cafemom', 'carbonmade', 'cardomain', 'care2', 'castroller', 'causes', 'ccsinfo', 'chess', 'cockos', 'connectingsingles', 'dailymail', 'dailymotion', 'deviantart', 'digitalspy', 'disqus', 'doodle', 'douban', 'dribbble', 'drugbuyersforum', 'drupal', 'ebay', 'echatta', 'elmundo', 'enfemenino', 'epinions', 'eqe', 'ethereum', 'etsy', 'evilzone', 'facebook', 'fanpop', 'fark', 'favstar', 'flickr', 'flixster', 'foodspotting', 'forobtc', 'forocoches', 'foursquare', 'freebase', 'freerepublic', 'friendfeed', 'gametracker', 'gapyear', 'garage4hackers', 'gather', 'geeksphone', 'genspot', 'getsatisfaction', 'github', 'gitorious', 'gogobot', 'goodreads', 'googleplus', 'gsmspain', 'hellboundhackers', 'hi5', 'ibosocial', 'identica', 'imgur', 'instagram', 'instructables', 'intersect', 'intfiction', 'islamicawakening', 'issuu', 'ixgames', 'jamiiforums', 'kaboodle', 'kali', 'karmacracy', 'kickstarter', 'kinja', 'klout', 'kongregate', 'kupika', 'lastfm', 'linkedin', 'livejournal', 'looki', 'marca', 'matchdoctor', 'mcneel', 'mediavida', 'medium', 'meneame', 'metacafe', 'migente', 'minecraft', 'musicasacra', 'myeloma', 'myspace', 'naver', 'netlog', 'netvibes', 'occupywallst', 'odnoklassniki', 'openframeworks', 'oroom', 'pastebin', 'pearltrees', 'peerbackers', 'photobucket', 'pinterest', 'pixinsight', 'pjrc', 'plancast', 'pokerred', 'pokerstrategy', 'pornhub', 'proboards', 'pz', 'qq', 'quartermoonsaloon', 'rankia', 'rapid', 'ratemypoo', 'rawtherapee', 'rebelmouse', 'redtube', 'relatious', 'researchgate', 'rojadirecta', 'ruby', 'scribd', 'sencha', 'skype', 'slashdot', 'slideshare', 'smartcitizen', 'sokule', 'soundcloud', 'sourceforge', 'spaniards', 'spoj', 'spotify', 'squidoo', 'steamcommunity', 'steinberg', 'streakgaming', 'stuff', 'stumbleupon', 'teamtreehouse', 'techcrunch', 'thecarcommunity', 'theguardian', 'thehoodup', 'thesims', 'thestudentroom', 'tradimo', 'travian', 'tripadvisor', 'tripit', 'trulia', 'tumblr', 'tuporno', 'tvtag', 'twicsy', 'twitch', 'twitpic', 'twitter', 'twoplustwo', 'ummahforum', 'unsystem', 'ustream', 'vexforum', 'videohelp', 'vimeo', 'virustotal', 'vk', 'wefollow', 'wikipedia', 'winamp', 'wishlistr', 'wordpress', 'wykop', 'xanga', 'xat', 'xing', 'xtube', 'youku', 'youtube', 'zabbix', 'zentyal'\n\nLicense: GPLv3+\n===============\n\nThis is free software, and you are welcome to redistribute it under certain conditions.\n\n\tThis program is free software: you can redistribute it and/or modify\n\tit under the terms of the GNU General Public License as published by\n\tthe Free Software Foundation, either version 3 of the License, or\n\t(at your option) any later version.\n\n\tThis program is distributed in the hope that it will be useful,\n\tbut WITHOUT ANY WARRANTY; without even the implied warranty of\n\tMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n\tGNU General Public License for more details.\n\n\tYou should have received a copy of the GNU General Public License\n\talong with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n\n\nFor more details on this issue, run:\n```\n\tpython usufy-launcher.py --license\n```\n\nInstallation:\n=============\nThe instructions may vary in the different OS. However, we strongly recommend \nto install the i3visiotools package separately, as you will be able to configure\nyour credentials for the different platforms and private API. If you don't have \nany, you can go on with this tutorial.\n\nUnder Linux\n-----------\nWe recommend you to create a folder under /var owned by the current user. For\ninstance:\n```\n# You will need superuser privileges to create this folder \nsudo mkdir /var/i3visio\n# You will need to change the owner to your user to work with it safely\n# If your user was alice\nsudo chown alice:alice /var/i3visio\n```\n\nThe rest of the installation under Python 2.7 is as follows:\n```\n# Navigate to the destiny's folder\ncd /var/i3visio\n# Cloning the repository. Recommended for developers.\ngit clone http://github.com/i3visio/usufy usufy-master\ncd usufy-master\n```\nor\n```\n# Navigate to the destiny's folder\ncd /var/i3visio\n# Download\nwget http://github.com/i3visio/usufy/archive/master.zip\n# Unzip\nunzip usufy-master.zip\ncd usufy-master\n```\n\nThen you can resume the installation.\n```\n# Superuser privileges are required so as to complete the installation.\nsudo python setup.py build\nsudo python setup.py install\t\n```\nAfterwards, the module will be importable from any python code. You can check this by typing:\n```\npython -c \"import usufy\"\n```\nIf no error is displayed, the installation would have been performed correctly.\n\nUsage:\n======\nSo as to run the program, navigate to /var/i3visio/usufy-mster/usufy and run:\n```\npython usufy-launcher.py -h\n```\nThe usage is described as follows:\n```\nusage: usufy-launcher.py\n                (--info \u003caction\u003e | -l \u003cpath_to_nick_list\u003e | -n \u003cnick\u003e [\u003cnick\u003e ...])\n                [-p \u003cplatform\u003e [\u003cplatform\u003e ...]] [-t \u003ctag\u003e [\u003ctag\u003e ...]] [-a]\n                [-e \u003csum_ext\u003e [\u003csum_ext\u003e ...]] [-o \u003cpath_to_output_folder\u003e]\n                [-v \u003cverbosity\u003e] [-h] [--license] [--version]\n```\n\nThe functionalities are described as follows:\n```\nInput options (one required):\n  There are two different ways of receiving the nicks in usufy-launcher.py:\n\n  --info \u003caction\u003e       select the action to be performed amongst the\n                        following: list_platforms (list the details of the \n                        selected platforms) or list_tags (list the tags of \n                        the selected platforms).\n  -l \u003cpath_to_nick_list\u003e, --list \u003cpath_to_nick_list\u003e\n                        path to the file where the list of nicks to verify is\n                        stored (one per line).\n  -n \u003cnick\u003e [\u003cnick\u003e ...], --nicks \u003cnick\u003e [\u003cnick\u003e ...]\n                        the list of nicks to process (at least one is\n                        required).\n\nPlatform selection arguments:\n  Criteria for selecting the platforms where performing the search.\n\n  -p \u003cplatform\u003e [\u003cplatform\u003e ...], --platforms \u003cplatform\u003e [\u003cplatform\u003e ...]\n                        select the platforms where you want to perform the\n                        search amongst the following: all, badoo, blip, delicious,\n                        ebay, facebook, foursquare, googleplus, karmacracy, klout, \n\t\t\t\t\t\tmyspace,pastebin, pinterest, slideshare, twitter, vk, \n\t\t\t\t\t\tyoutube. More than one option can be selected.\n  -t \u003ctag\u003e [\u003ctag\u003e ...], --tags \u003ctag\u003e [\u003ctag\u003e ...]\n                        select the list of tags that fit the platforms in\n                        which you want to perform the search. More than one\n                        option can be selected.\n\nProcessing arguments:\n  Configuring the way in which usufy will process the identified profiles.\n\n  -a, --avoid_processing\n                        argument to force usufy NOT to process the downloaded\n                        valid profiles.\n  -e \u003csum_ext\u003e [\u003csum_ext\u003e ...], --extension \u003csum_ext\u003e [\u003csum_ext\u003e ...]\n                        output extension for the summary file (at least, one \n\t\t\t\t\t\trequired). Currently supported: csv, json.\n  -o \u003cpath_to_output_folder\u003e, --output_folder \u003cpath_to_output_folder\u003e\n                        output folder for the generated documents. While if\n                        the paths does not exist, usufy-launcher.py will try to create;\n                        if this argument is not provided, usufy will NOT write\n                        any down any data. Check permissions if something goes\n                        wrong.\n\nAbout arguments:\n  Showing additional information about this program.\n\n  -h, --help            shows the version of the program and exists.\n  --license             shows the GPLv3 license.\n  --version             shows the version of the program and exists.\n```\n\nExamples:\n=========\nThe capabilities of the tool can be divided as informative, basic searches and processing.\n\nInformative:\n------------\nThese commands can be used to gather information about the state of the application.\n- Checking some details of all the platforms to be processed:\n```\n\tpython usufy-launcher.py --info list_platforms\n```\n- Checking some details of the platforms labelled as 'social' and 'contact':\n```\n\tpython usufy-launcher.py -p social contact --info list_platforms\n```\n- Checking the number of platforms categorised under each and every tag:\n```\n\tpython usufy-launcher.py --info list_tags\n```\nTo gather additional information about the tool, you may type:\n- Checking the help of the application:\n```\n\tpython usufy-launcher.py -h\n```\nIt may be recommended to be run as to read it step by step:\n```\n\tpython usufy-launcher.py -h | less\n```\n- Checking the current version of the application:\n```\n\tpython usufy-launcher.py --version\n```\n- Checking the terms of the license:\n```\n\tpython usufy-launcher.py --license\n```\nAgain, it may be recommended to be run as to read it step by step:\n```\n\tpython usufy-launcher.py --license | less\n```\n\nBasic Searches:\n---------------\nThe basic searches will only print the results in the terminal. Here are some examples:\n- Checking if the user 'example' exist in all the platforms ('-p all' is not needed):\n```\n\tpython usufy-launcher.py -n example\n```\nWe can also use the long version of the commands. In this case, the long version of '-n'\nis '--nick'. Check the section before for further details.\n```\n\tpython usufy-launcher.py --nick example\n```\n- Checking if the users 'example1' and 'example2' exist in all the platforms ('-p all' is \nnot needed):\n```\n\tpython usufy-launcher.py -n example1 example2\n```\n- Checking if the users 'example1' and 'example2' exist ONLY in Facebook and Twitter:\n```\n\tpython usufy-launcher.py -n example1 example2 - p facebook twitter\n```\n- Checking if the users existing in 'test.txt' exist in the Platforms tagged as 'social':\n```\n\tpython usufy-launcher.py -l test.txt -t social\n```\n\nAdditional processing:\n----------------------\nApart from the console output, usufy-launcher.py is capable of generating additional resources:\n- Checking if the user 'example' exist in all the platforms and storing the information of \nthe successfully found profiles in a folder called './results' (this will create the folder if \nit does not exist):\n```\n\tpython usufy-launcher.py -n example -o ./results\n```\nThis option will download the information of the profiles as well as creating a .csv file by \ndefault with the profiles found. This .csv file can be changed for a Json file:\n```\n\tpython usufy-launcher.py -n example -o ./results -e json\n```\n- Checking if the users listed in a 'test.txt' file exist in all the platforms WITHOUT stotring  \nthe successfully found profiles but keeping the results in a Json file:\n```\n\tpython usufy-launcher.py -n example -o ./results -e json --avoid_processing\n```\n\n","funding_links":[],"categories":["Pentesting"],"sub_categories":["OSINT - Open Source INTelligence"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi3visio%2Fusufy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fi3visio%2Fusufy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi3visio%2Fusufy/lists"}