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

Warning

This project will resume when I become a college student.

Works on my machine

Overview

License: MIT Stargazers Go Tweet

Investigo is a command-line tool written in Go to investigate usernames and download their data on social media.

screenshot

Installation

Download Windows Binary

You can download the binary for Windows.

Note that the frequency of update of release is too slow.

$ investigo.exe -h

Build from source

To compile investigo, Go 1.12 or higher is required.

$ git clone https://github.com/tdh8316/Investigo.git
$ cd investigo
$ go build

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 USERNAME

Example with docker-compose

$ docker-compose run investigo investigo USERNAME

Investigo (headless chromium mode, with screenshots)

Example run with docker

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

Example run with docker-compose

$ docker-compose run investigo-chromium -s USERNAME

Usage

$ investigo -h
Investigo - Investigate User Across Social Networks.

usage: investigo USERNAME [USERNAMES...] flags options
perform test: investigo [--test]

positional arguments:
        USERNAMES             one or more usernames to investigate

flags:
        -h, --help            show this help message and exit
        --no-color            disable colored stdout output
        --update              update database before run from Sherlock repository
        -t, --tor             use tor proxy
        -s, --screenshot      take a screenshot of each matched urls
        -v, --verbose         verbose output
        -d, --download        download the contents of site if available

options:
        --database DATABASE   use custom database
        --site SITE           specific site to investigate

Addding/Fixing site

Investigo is compatible with Sherlock database.

To add sites...

To add sites to Investigo, make a Pull Request to Sherlock project. Whenever the Sherlock repository updates, the Investigo database will update automatically!

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.

Contributors

Thanks to all contributors!

Contributions are more than welcome!

License

Licensed under the MIT License

Copyright 2020 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%