vsco-downloader 0.1.4.1

VSCO download manager on pure REST

VSCO Downloader

Православная версия README

This is a simple console async downloader from vsco.co used original web REST requests.

So there is no fcking CLI/GUI here as befits normal scripts.
It works through a call from the terminal (Sry, win-users, I know that really can be bad for yours...)
Btw sup 2ch⚡ and VSCO находок группа

CHANGELOG.md

Requirements

All python requirements in the requirements.txt:

• aiohttp
• aiofiles

To download videos in m3u8 format (parted videos with large size), you need compiled ffmpeg, see description for a --ffmpeg-bin argument

Installation

Easy and recommended installation with PIP

• Install:

pip install vsco-downloader

• Upgrade:

pip install vsco-downloader --upgrade

Install from source

Common step

git clone https://github.com/benhacka/vsco-downloader
cd vsco-downloader

• For Windows users: change python3 with python in all console command
• You can call the script from any directory in terminal simply by typing the command vsco-downloader after installing the package on the system (installation via var2 or var3)

[var 1]. Usage w/o install dist pkg (I do not recommend this method)

python3 -m pip install -r requirements.txt

• 1.1 Run main from package:
  python3 -m vsco_downloader

• 1.2 Run a script:
  python3 vsco_downloader.py

or [var 2]. Install package with setup.py

python3 setup.py install --user

• For Linux users: you can run w/o --user but with sudo for installing in /usr/lib/python3.*/site-packages/. With --user it will install in the ~/.local/bin/ (depends on the distribution... i use arch btw [it's a stupid lie i use the best of arch - manjaro])

• For Windows users: --user is not required (I think so..?)

or [var 3]. Install package with pip from github

python3 -m pip install git+https://github.com/benhacka/vsco-downloader.git

Use cases

All use cases wrote for installed package and calling with vsco-downloader
I highly recommend you to set vsco_download_path environment variable (see Usage help).

1. Download users: foo, bar and baz:
   vsco-downloader foo bar baz

2. Download users foo, bar and baz consistently:
   vsco-downloader foo bar baz -l 1

3. Download only photos for bar, baz:
   vsco-downloader bar baz -r mini-video video

4. Only save download links w/o downloading content for foo, bar:
   vsco-downloader foo bar -r all -p

5. Download from file and args with skipping existing to ~/Download

# show file with accs
$ cat accs_to_dl

foo


https://vsco.co/baz/gallery

vsco-downloader bar -u accs_to_dl -s -d /home/username/Download/ 6. Download without restoring the names of files that are in the folder without a date as a prefix in the name (if the file name matches the name of the direct link) vsco-downloader foo bar baz -nr

For more info see Usage help

Usage help (help menu)

VSCO downloader

positional arguments:
  users                 urls/usernames. The script supports multiple download with passing to this argument. Urls can be either
                        to the gallery or to a separate file (the entire profile will be downloaded). Both short (from the mobile
                        version) and long urls (desktop browser) format are supported

optional arguments:
  -h, --help            show this help message and exit
  -u USERS_FILE_LIST, --users-file-list USERS_FILE_LIST
                        Same as the users but list of targets in file (one per line)
  --ffmpeg-bin FFMPEG_BIN
                        Name for ffmpeg binary that can be used for calling from terminal. Default "ffmpeg". If you have
                        installed ffmpeg from repo it should be in the /usr/bin/ffmpeg"
  --download-path-variable DOWNLOAD_PATH_VARIABLE
                        The download path in your environment variable. Default "vsco_download_path" It can be an export in the
                        shellrc (~/.bashrc for example)for Linux users. For Win users it is something like system environments.
  -d DOWNLOAD_PATH, --download-path DOWNLOAD_PATH
                        Force downloading path. If this arg passed possible path from --download-path-variable will be reloaded
                        (priority arg). By default env path is empty download path is "." (current dir).
  -r [{photo,mini-video,video} ...], --disabled-content [{photo,mini-video,video} ...]
                        Disabled of downloading some type of a content.Possible types: photo, mini-video, video
  -l min 1; max 500, --download-limit min 1; max 500
                        Limit for all get request at same time. Default 100
  -f min 1; max 100, --max-fmpeg-threads min 1; max 100
                        Limit for for ffmpeg concat threads at same time. Default 10
  -b BLACK_LIST_USER_FILE, --black-list-user-file BLACK_LIST_USER_FILE
                        File with usernames/full urls — one per line, to skip scraping and downloading
  -s, --skip-existing   Skip scrapping and downloading steps for existing users from download folder. Pass the param for
                        skipping, default - False
  -c {ts,mp4}, --container-for-m3u8 {ts,mp4}
                        A container for stream (m3u8) videos. Default "mp4", a possible alternative is "ts".
  -p, --save-parsed-download-urls
                        Store urls in the file into user dir. Filename has saving datetime so this will not overwrite old links.

  -nr, --no-restore-datetime
                        The script trying to restore file creation date before
                        downloading to skip downloading step for the files saved w/o
                        datetime. Pass the arg for skipping this step.
  -v, --version         Show the current script version

Console VSCO downloader

Change Log

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[0.1.4.1] - 2021-08-12

Fixed

• Fixed setup.py

[0.1.4] - 2021-08-12

Added

• Added a version arg

Changed

• Chnaged README and setup.py for pypi

[0.1.3] - 2021-08-07

Fixed

• Added an addition possible path for parsing username.
• Fixed Window's console encoding error - added cp1252 encoding.
• Fixed Window's (with a kludge) issue with a closed loop at finishing of the script.

[0.1.2] - 2021-08-02

Added

• Added new functionality for restoring the datetime of the content from previously downloaded with not this script. Can be disabled by passing --no-restore-datetime.
• Added Russian version of README.

[0.1.1] - 2021-08-01

Added

• Added pseudo-type all to content types to block downloading (-r/--disabled-content)
• Added CHANGELOG.md
• Added a simple script for running vsco_downloader.__main__.main

Changed

• Changed all relative paths from dot(.) to package name dot (vsco_downloader.*).

Fixed

• Fixed python_requires (required 3.7+ python version but not a 3.8+ one) in the setup.py
• Fixed false-positive full-url checking raise

[0.1.0] - 2021-07-31

Added

• Whole project

MIT License

Copyright (c) 2021 benhacka

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.