https://github.com/skyme5/snapchat-dl

Snapchat story downloader
https://github.com/skyme5/snapchat-dl

download downloader snap snapchat snapchat-stories snapstories stories

Last synced: 5 months ago
JSON representation

Snapchat story downloader

• Host: GitHub
• URL: https://github.com/skyme5/snapchat-dl
• Owner: skyme5
• License: mit
• Created: 2020-06-18T19:07:24.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2024-11-14T18:41:35.000Z (over 1 year ago)
• Last Synced: 2026-01-03T02:50:34.793Z (5 months ago)
• Topics: download, downloader, snap, snapchat, snapchat-stories, snapstories, stories
• Language: Python
• Homepage:
• Size: 188 KB
• Stars: 97
• Watchers: 5
• Forks: 21
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Authors: AUTHORS.rst

Awesome Lists containing this project

README

          


  


  


    Snapchat Public Stories Downloader
 


    

      

    

    

      

    

    

      

    

    

      

    

    

      

    

    

      

    

    

      

    

    

      

    

  

  

  


### Installation

Install using pip,

```bash

pip install snapchat-dl

```

Install from GitHub,

```bash

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

```

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

### Usage

```text

usage: snapchat-dl [-h] [-c | -u] [-i BATCH_FILENAME] [-P DIRECTORY_PREFIX]

                   [-s] [-d] [-l MAX_NUM_STORY] [-j MAX_WORKERS] [-t INTERVAL]

                   [--sleep-interval INTERVAL] [-q]

                   [username [username ...]]

positional arguments:

  username              At least one or more usernames to download stories

                        for.

optional arguments:

  -h, --help            show this help message and exit

  -c, --scan-clipboard  Scan clipboard for story links

                        ('https://story.snapchat.com//').

  -u, --check-for-update

                        Periodically check for new stories.

  -i BATCH_FILENAME, --batch-file BATCH_FILENAME

                        Read usernames from batch file (one username per

                        line).

  -P DIRECTORY_PREFIX, --directory-prefix DIRECTORY_PREFIX

                        Location to store downloaded media.

  -s, --scan-from-prefix

                        Scan usernames (as directory name) from prefix

                        directory.

  -d, --dump-json       Save metadata to a JSON file next to downloaded

                        videos/pictures.

  -l MAX_NUM_STORY, --limit-story MAX_NUM_STORY

                        Set maximum number of stories to download.

  -j MAX_WORKERS, --max-concurrent-downloads MAX_WORKERS

                        Set maximum number of parallel downloads.

  -t INTERVAL, --update-interval INTERVAL

                        Set the update interval for checking new story in

                        seconds. (Default: 10m)

  --sleep-interval INTERVAL

                        Sleep between downloads in seconds. (Default: 1s)

  -q, --quiet           Do not print anything except errors to the console.

```