https://github.com/0000xffff/4chan-dl
download media files from 4chan.org with thier posted filenames
https://github.com/0000xffff/4chan-dl
4chan 4chan-downloader beautifulsoup4 colorama download downloader python python3 scape scraper
Last synced: 6 months ago
JSON representation
download media files from 4chan.org with thier posted filenames
- Host: GitHub
- URL: https://github.com/0000xffff/4chan-dl
- Owner: 0000xFFFF
- License: mit
- Created: 2024-09-10T14:30:52.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-10-09T10:04:50.000Z (over 1 year ago)
- Last Synced: 2025-01-19T14:19:01.024Z (over 1 year ago)
- Topics: 4chan, 4chan-downloader, beautifulsoup4, colorama, download, downloader, python, python3, scape, scraper
- Language: Python
- Homepage:
- Size: 37.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 4chan-dl
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).
## UserScript ([Violent Monkey](https://violentmonkey.github.io/get-it/), ...)
### Adds buttons that lets you download all the content from a thread in a zip file.
### Also on each post there will be a button to start downloading from that post down.
### [
Click here to install ](https://github.com/0000xFFFF/4chan-dl/raw/refs/heads/master/4chan-dl.user.js)
#### note: if you're using [4chan-x](https://github.com/ccd0/4chan-x) or [4chan-xt](https://github.com/TuxedoTako/4chan-xt), the script should still work
---
## Python version
[](http://www.python.org/download/)
### Setup virtual environment & install - before running anything
```sh
./setup-venv.sh
./install.sh
```
### Running
```sh
./4chan-dl -d downloads "https://boards.4chan.org/XX/thread/XXXXXXX"
```
### Recommended way to run
Just downloads new files in thread.
```sh
./4chan-dl -g -d downloads "https://boards.4chan.org/XX/thread/XXXXXXX"
```
### Usage
```sh
./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 (_.)
-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
```
# Diclaimer
* This project is for educational and personal use only.
* The author is not responsible for how this tool is used.
* Please respect 4chan’s Rules and avoid scraping illegal or prohibited content.