/ Tool

Lightshot scraper on steroids with OCR

Lightshot scraper on steroids with OCR

darkshot

Darkshot is a scraper tool on steroids, to analyze all of the +2 Billions pictures publicly available on Lightshot.
It uses OCR to analyze pictures and auto-categorize them thanks to keywords and detection functions.

You can find pretty much everything : credentials, personal informations (emails, phone numbers, addresses, ID cards, passeports), banking information, etc.
Since it's modulable, you can make your own detection function and use it as a monitoring tool.

Features

👉 Multi-threading
👉 Anti-conflicting threads protection
👉 Auto-saving and resuming session
👉 3 links generators : Ascending, Descending and Random
👉 Auto-translating keywords
👉 Auto-analyzing pictures with multiple OCR langs
👉 Auto-downloading OCR langs training data
👉 Auto-categorizing pictures with keywords, groups and detection functions
👉 Auto-exporting pictures per groups with their statistics in HTML
👉 Modulable : add your own detection functions and keywords

Screenshots

💻 Default mode

68747470733a2f2f66696c65732e636174626f782e6d6f652f71776c63616d2e6a7067

👨‍💻 Debug mode

68747470733a2f2f66696c65732e636174626f782e6d6f652f6a6a777231392e6a7067

Usage

C:\Users\mxrch\Desktop\darkshot-beta>python run.py -h
Usage: run.py [OPTIONS]

Options:
  -t, --threads INTEGER  Number of threads  [default: 5]
  -m, --mode TEXT        The mode to catch the more recent link, using it as a
                         limit. (noisy, stealth)
                         - noisy : it uploads a picture to get the more recent
                         link
                         - stealth : it uses the last link shown on Twitter
                         here : https://prntscr.com/twitter.json  [default:
                         noisy]

  -a, --algo TEXT        Algorithm used to generate links. (ascending,
                         descending, random)  [default: descending]

  -d, --debug            Verbose mode, for debugging.  [default: False]
  -ro, --resume_ro       Don't save the resume state, only read it.  [default:
                         False]

  -c, --clean TEXT       Clean some things you don't want anymore. (logs,
                         resume, exports)
                         If you want want to specify multiple values, specify
                         them comma-separated and without spaces. Ex: "--clean
                         logs,exports"

  -h, --help             Show this message and exit.

Example

$ python run.py -t 5 -m stealth -a descending

Installation

Requirements

  • Python 3.4+ would be ok. (I developed it with Python 3.8.1)
  • Tesseract
  • These Python modules :
httpx
googletrans
pytesseract
opencv-python
pillow
scrapy
termcolor
beautifultable
reprint
click
json
shutil
imghdr
hashlib

1. Tesseract-OCR

You'll find installation instructions for all main platforms here : https://github.com/tesseract-ocr/tesseract/wiki
Don't forget to add tesseract to your PATH.

2. Darkshot

$ git clone https://github.com/mxrch/darkshot
$ cd darkshot
$ python -m pip install -r requirements.txt

Then, we need to check if the chosen OCR langs in config.py are installed, and if not, it will auto-download and install them.

  • Run the file check_ocr_langs.py as Administrator.

If it tells you that it's okay, then it's okay. 🧠

You are ready !

Configuring

There is a config.py file where you can configure almost everything, like the keywords to be translated, the OCR langs data to use, the resume state margin protection, the timeouts, the threads results delimiter (to avoid overloading the RAM), etc.

Explanations about some exotic parameters:

Resume state margin protection

Basically, the program keep every current processing link in a variable, and pass it in a function that save it if it detects an exception, like a CTRL+C.
But there is a problem.
Imagine you have 5 threads running, it will keep the last link given to the last thread, even if the thread has not finished.
So, you'll restart the program from after this link, and you will never really get the results from this link.
This is where this protection plays its role, it will consistently keep an arbitrary margin between the last link and some links back.
To calculate it, it sums the number of threads with the value in config.py.

Threads results delimiter

While we don't end the threads, their results are kept in the memory.
Since Darkshot is designed to keep running several years, we can't keep the threads results indefinitely in the memory.
So, it takes the value in config.py (example: 100), and it will unload and restart threads each 100 links.

Unwanted pictures folder

More simple, it justs calculate the hashes of all pictures in this folder (and subfolders), and if a Lightshot picture has one of these hashes, it don't process it.
It's like a blacklist but for pictures.

Detection customization

All the detection stuff is in the lib/detection.py file.

By default, I made 3 detection functions:

  • The basic detection (just check if the string is in the text)
  • The isolated detection (it checks if the string is in the text and if he is between 2 non-alphanumeric characters)
  • The regex detection (it checks if the regex finds something valid)

Detection groups

  1. Go in the file and look at the class, you'll see some functions and then the Groups detection functions (credentials, personal, banking and confidential).
  2. For your first detection group, you can simply copy & paste below the confidential group function.
  3. Change the function name to your desired name, as well as the group_name variable below.
  4. Then, you just put the detection functions you want with your keywords in it, where you see the detec_state variables.
  5. You now can add your group in self.groups, inside the __init__ function. If your function is named secretsaliens, put self.secretsaliens.

68747470733a2f2f66696c65732e636174626f782e6d6f652f7a69743774362e706e67

Voilà, your group is added and functional !

68747470733a2f2f66696c65732e636174626f782e6d6f652f6f67726b74312e6a7067

Blacklists

There are two kinds of blacklists :

  • The base blacklist, which runs on every detection, whatever the group
  • The group blacklist, which runs only within the group it was assigned at.

Groups blacklists

Imagine if you want to detect pictures of conversation where they are talking about aliens but not related to the Area 51.

  1. First, you can create a detection group relating to the area 51 by simply detecting the string "area 51",
  2. Then you can simply add your blacklisted word like this in the blacklist_groups array within the genBlacklists function:

68747470733a2f2f66696c65732e636174626f782e6d6f652f79336d7979692e706e67

And then, for every picture detected in the area51 detection group, if the string "alien" is present in it, it will not save it.

Base blacklist

  1. Simply add your string here :

68747470733a2f2f66696c65732e636174626f782e6d6f652f717873636e6b2e706e67

And it will not save the picture if this string is detected.

Detection functions

You can find them here :

68747470733a2f2f66696c65732e636174626f782e6d6f652f3073383275752e504e47

If you want to make your own detection function, you can :

  1. Copy & paste the basicDetection function below.
  2. Next, you can modify the conditions and everything you want.

You only need to keep the function args, and the return of detec_state if the detection finds nothing.
Otherwise, you can return the updated state like this : return self.updateState(group=group, word=word, lang=lang, detec_state=detec_state)

Tradwrapper

If you want to use every translation of a certain word with your detection function, you can transform your function call from this :
detec_state = self.basicDetection(group_name, "password", "", text, detec_state)
To this :
detec_state = self.tradWrapper(self.basicDetection, group_name, words["password"], text, detec_state)

Be sure that you added your word in the words_to_translate of the config.py file.

GitHub

Comments