{"id":20905582,"url":"https://github.com/0000xffff/4chan-dl","last_synced_at":"2025-12-24T17:29:11.165Z","repository":{"id":256418701,"uuid":"855228336","full_name":"0000xFFFF/4chan-dl","owner":"0000xFFFF","description":"download media files from 4chan.org with thier posted filenames","archived":false,"fork":false,"pushed_at":"2024-10-09T10:04:50.000Z","size":38,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-19T14:19:01.024Z","etag":null,"topics":["4chan","4chan-downloader","beautifulsoup4","colorama","download","downloader","python","python3","scape","scraper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0000xFFFF.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-10T14:30:52.000Z","updated_at":"2024-10-09T10:04:53.000Z","dependencies_parsed_at":"2024-11-18T13:31:19.656Z","dependency_job_id":"3a127971-96f7-4a73-8ead-ba8a4f5b95a7","html_url":"https://github.com/0000xFFFF/4chan-dl","commit_stats":null,"previous_names":["0000xffff/4chan-dl"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0000xFFFF%2F4chan-dl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0000xFFFF%2F4chan-dl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0000xFFFF%2F4chan-dl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0000xFFFF%2F4chan-dl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0000xFFFF","download_url":"https://codeload.github.com/0000xFFFF/4chan-dl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243296614,"owners_count":20268619,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["4chan","4chan-downloader","beautifulsoup4","colorama","download","downloader","python","python3","scape","scraper"],"created_at":"2024-11-18T13:25:42.777Z","updated_at":"2025-12-24T17:29:11.159Z","avatar_url":"https://github.com/0000xFFFF.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 4chan-dl\n\nDownload media files (.jpg, .jpeg, .webm, ...) from 4chan.org with their posted filenames.\n\u003cbr\u003e\nIf the thread has multiple files with the same posted filename the files will be renamed (downloaded with a different name).\n\n## UserScript ([Violent Monkey](https://violentmonkey.github.io/get-it/), ...)\n\n### Adds buttons that lets you download all the content from a thread in a zip file.\n\n\u003cimg src=\"preview/preview.png\"\u003e\n\n### Also on each post there will be a button to start downloading from that post down.\n\n\u003cimg src=\"preview/preview2.png\"\u003e\n\n### [\u003cimg src=\"preview/4chan-dl.ico\" width=\"16\" height=\"16\"\u003e Click here to install \u003cimg src=\"preview/4chan-dl.ico\" width=\"16\" height=\"16\"\u003e](https://github.com/0000xFFFF/4chan-dl/raw/refs/heads/master/4chan-dl.user.js)\n\n#### 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\n\n---\n\n\n## Python version\n\n[![Python 3.12.5](https://img.shields.io/badge/Python-3.12.5-yellow.svg)](http://www.python.org/download/)\n\n### Setup virtual environment \u0026 install - before running anything\n```sh\n./setup-venv.sh\n./install.sh\n```\n\n### Running\n```sh\n./4chan-dl -d downloads \"https://boards.4chan.org/XX/thread/XXXXXXX\"\n```\n\n### Recommended way to run\nJust downloads new files in thread.\n```sh\n./4chan-dl -g -d downloads \"https://boards.4chan.org/XX/thread/XXXXXXX\"\n```\n\n### Usage\n```sh\n./4chan-dl -h\n```\n```\nusage: 4chan-dl [-h] [-d directory] [-s] [-r] [-p] [-c] [-f file.txt] [-t num_threads] [-v] [-g] url\n\nDownload media files from 4chan.org with their posted filenames\n\npositional arguments:\n  url                   4chan thread url\n\noptions:\n  -h, --help            show this help message and exit\n  -d directory, --directory directory\n                        directory to save files to\n  -s, --skip            if file exists with the same filename skip it (default: overwrite)\n  -r, --recursive_skip  recursively search for filenames to skip\n  -p, --postid          download files with post's id rather than posted filename\n  -c, --combine         download files with post's id + posted name (\u003cpostid\u003e_\u003cpostname\u003e.\u003cext\u003e)\n  -f file.txt, --filter file.txt\n                        urls to ignore stored in file\n  -t num_threads, --threads num_threads\n                        number of download worker threads (default: 1)\n  -v, --verbose         be more verbose\n  -g, --goodargs        -crvt 5\n```\n\n# Diclaimer\n* This project is for educational and personal use only.\n* The author is not responsible for how this tool is used.\n* Please respect 4chan’s Rules and avoid scraping illegal or prohibited content.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0000xffff%2F4chan-dl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0000xffff%2F4chan-dl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0000xffff%2F4chan-dl/lists"}