Skip to content

stevehoek/snapchat-dl

 
 

Repository files navigation

Snapchat Public Stories Downloader

Python Package Python Wheel CI Code Coverage Python Versions The Uncompromising Code Formatter Monthly Downloads License: MIT

Installation

Install using pip,

pip install snapchat-dl

Install from GitHub,

pip install git+git://github.com/stevehoek/snapchat-dl

Unix users might want to add --user flag to install without requiring sudo.

Usage


usage: snapchat-dl [-h] [-r ROOTFOLDER] [-f] [-b BATCHFILE] [-c | -u] [-ss]
                   [-sc] [-sh] [-d] [-g] [-nm] [-w MAXWORKERS]
                   [-ui UPDATEINTERVAL] [-si SLEEPINTERVAL] [-fast] [-q] [-a]
                   [username ...]

positional arguments:
  username              One or more usernames to download content for.

options:
  -h, --help            show this help message and exit
  -r, --root-folder ROOTFOLDER
                        Location to store downloaded content.
  -f, --scan-root-folder
                        Scan usernames (as folder name) from root folder.
  -b, --scan-batch-file BATCHFILE
                        Read usernames from batch file (one username per
                        line).
  -c, --scan-clipboard  Scan clipboard for story links
                        ('https://story.snapchat.com/<s>/<username>').
  -u, --check-for-update
                        Periodically check for new content.
  -ss, --skip-stories   Skip downloading public stories.
  -sc, --skip-curated   Skip downloading curated highlights.
  -sh, --skip-spotlight
                        Skip downloading spotlight highlights.
  -d, --dump-json       Save snap metadata to a JSON file next to downloaded
                        content.
  -g, --generate-scripts
                        Generate shell scripts for combining multipart
                        stories.
  -nm, --no-multipart   Don't combine multipart stories.
  -w, --max-workers MAXWORKERS
                        Set maximum number of parallel downloads. (Default: 4)
                        NOTE: only applies when --no-multipart arg is present
  -ui, --update-interval UPDATEINTERVAL
                        Set the update interval for checking new content in
                        seconds. (Default: 600s)
  -si, --sleep-interval SLEEPINTERVAL
                        Sleep between downloads in seconds. (Default: 1s)
  -fast, --fast         Skip online size checks for snap media.
  -q, --quiet           Do not print anything but errors to the console.
  -a, --automated       Change logging style when run under automation (eg:
                        Shortcuts).

About

Snapchat story downloader

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 96.4%
  • Makefile 3.6%