Skip to content

download media files from 4chan.org with thier posted filenames

Notifications You must be signed in to change notification settings

0000xFFFF/4chan-dl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

4chan-dl

Python 3.12.5

Download media files (.jpg, .jpeg, .webm, ...) from 4chan.org with their posted filenames.
If the thread has multiple files with the same posted filename the files will be renamed (downloaded with a different name).

Requirements - pip

  • requests
  • beautifulsoup4
  • colorama

Running

./4chan-dl -d downloads "https://boards.4chan.org/XX/thread/XXXXXXX"

Recommend way to run

Just downloads new files in thread.

./4chan-dl -g -d downloads "https://boards.4chan.org/XX/thread/XXXXXXX"

Usage

./4chan-dl -h
usage: 4chan-dl [-h] [-d directory] [-s] [-r] [-p] [-c] [-f file.txt] [-t num_threads] [-v] [-g] url

Download media files from 4chan.org with their posted filenames

positional arguments:
  url                   4chan thread url

options:
  -h, --help            show this help message and exit
  -d directory, --directory directory
                        directory to save files to
  -s, --skip            if file exists with the same filename skip it (default: overwrite)
  -r, --recursive_skip  recursively search for filenames to skip
  -p, --postid          download files with post's id rather than posted filename
  -c, --combine         download files with post's id + posted name (<postid>_<postname>.<ext>)
  -f file.txt, --filter file.txt
                        urls to ignore stored in file
  -t num_threads, --threads num_threads
                        number of download worker threads (default: 1)
  -v, --verbose         be more verbose
  -g, --goodargs        -crvt 5