Skip to content

πŸ”Ž Find usernames and download their data across social media.

License

Notifications You must be signed in to change notification settings

romankosoj/Investigo

Β 
Β 

Repository files navigation

Overview

Investigo is a command-line tool written in Go for searching usernames on social media.

screenshot

Installation

Download Windows Binary

You can download the binary for Windows.

$ investigo.exe -h

Build from source

To compile investigo, Go 1.8 or higher is required.

$ git clone https://github.com/tdh8316/Investigo.git
$ cd investigo
$ go get github.com/fatih/color
$ go run investigo.go -h

Build with docker

If you don't have Docker/Docker-Compose check Setup Docker section

Setup Docker

Docker

macOS: https://docs.docker.com/docker-for-mac/install/

linux: https://docs.docker.com/install/linux/docker-ce/ubuntu/

Docker Compose

linux: https://docs.docker.com/compose/install/

Investigo (standalone mode, no screenshots)

Example with docker

$ docker run x0rzkov/investigo:latest investigo tdh8316

Example with docker-compose

$ docker-compose run investigo investigo tdh8316

Investigo (headless chromium mode, with screenshots)

Example run with docker

$ docker run -v $(pwd)/data:/screenshots x0rzkov/investigo-chromium:latest -s tdh8316

Example run with docker-compose

$ docker-compose run investigo-chromium -s tdh8316

Usage

$ investigo [-h] [--no-color] [-v|--verbose] [-t|--tor] [--update] USERNAME [USERNAMES...]
positional arguments:
	USERNAMES             one or more usernames to investigate

optional arguments:
	-h, --help			  show this help message and exit
	-v, --verbose         output sites which is username was not found
	--no-color            disable colored stdout output
	--update              update datebase from github.com/tdh8316/investigo/

Why Investigo?

Investigo is trying to build our own database while keeping compatibility with Sherlock. This is because even though Sherlock project contains a vast database, adult sites are forbidden.

Furthermore, Investigo is more than twice as fast as the original implementation!

TODO

Manifesto

Investigo is another implementation of Sherlock. Accordingly, I would like not to make a competition with Sherlock.

  • Avoid deep packet inspection
  • Support Tor
  • Implement regex check
  • Command-line arguments
  • Add tests

Become a stargazer

β˜…

Addding/Fixing site

Investigo uses Sherlock's database.

To add sites...

If you want to add sites to Investigo, make a Pull Request to Sherlock project. Or if you want to add prohibited sites for Sherlock, make an issue or a Pull Request to this repository!

To fix incompatible sites...

Make an issue here to let Sherlock developers know.

License

Licensed under the MIT License

Copyright 2019 Donghyeok Tak

About

πŸ”Ž Find usernames and download their data across social media.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 86.4%
  • Makefile 6.0%
  • Dockerfile 5.5%
  • Python 1.5%
  • Shell 0.6%