SnapIntel

What is it?

SnapIntel is a python tool providing you information about Snapchat users. You can list stories, curated highlights, spotlights, lenses and even download all of them! The heatmap functionality allows you tu generate a heatmap related to upload dates for specific categories.

Updates

17/12/2023: The old tool (and its first version) was named Snapchat_stories_dl and was only built to download stories. But it has been replaced by this new 2.0 version with a lot more functionalities.

Install

Clone this repository and jump in it:

git clone https://github.com/Kr0wZ/SnapIntel/
cd SnapIntel

You must have python3 installed on your machine. Run the following command to install the dependencies:

python3 -m pip install -r requirements.txt

⚠️ Known issue ⚠️
If you have difficulties installing numpy try to downgrade your python3 version to python3.8

Usage

Simply run the tool using python3 without argument to show the help menu:

python3 main.py

usage: main.py [-h] [-u USERNAME] [-s] [-l [OPTIONS]] [-m] [-d [OPTIONS]] [-o DIRECTORY] [-t TIMEOUT]

SnapIntel OSINT Tool - Made by KrowZ

optional arguments:
  -h, --help            show this help message and exit
  -u USERNAME, --username USERNAME
                        Username of account we want to download stories from
  -s, --stats           Only prints summary and statistics about the account
  -l [OPTIONS], --list [OPTIONS]
                        List the desired information. By default, lists only user information. 'a' = all, 's' = stories, 'u' = user, 'c' = curated highlights, 'p' = spotlights, 'l' = lenses. Multiple options can be combined together: E.g: -l 'csl'
  -m, --heatmap         Generates a heatmap related to upload dates. Must be used with '-l/--list' option
  -d [OPTIONS], --download [OPTIONS]
                        Downloads specific videos posted by a user. By default, only downloads current stories. 'a' = all, 's' = stories, 'c' = curated highlights, 'p' = spotlights, 'l' = lenses. Multiple options can be combined together: E.g: -d 'csl'
  -o DIRECTORY, --output DIRECTORY
                        Path where stories are stored. Default : current directory
  -t TIMEOUT, --timeout TIMEOUT
                        Requests timeout. Default : 30 seconds

EXAMPLES:
Show stats for a specific user:
	python3 main.py -u <SNAP_USER> -s

List all elements (account, stories, curated highlights, spotlights, lenses) for a specific user:
	python3 main.py -u <SNAP_USER> -l a

List stories, spotlights and generate a heatmap related to this data based on upload date:
	python3 main.py -u <SNAP_USER> -l sp -m

List stories, download everything (stories, curated highlights, spotlights, lenses) and store them to directory 'data':
	python3 main.py -u <SNAP_USER> -l s -d a -o ./data

Todo

Implement multi-threading to increase download speed (for videos + bitmojis (not implemented because curently too slow)).
Implement watch functionality (monitoring) to check a user every X minutes for new stories and download them if new already done.
Fix bugs?

Support

Do you want to support me?

You can buy me a coffee here:

Thanks in advance to anyone donating ❤️

C3n7ral051nt4g3ncy / SnapIntel