kemono-dl
This is a simple kemono.party downloader.
How to use
- Install python
- Download source code from releases and extract it
- Then install requirements with
pip install -r requirements.txt - Get a cookie.txt file from kemono.party
- Run
python kemono-dl.py --cookies "cookie.txt" --links https://kemono.party/SERVICE/user/USERID
Options
-h, --help show this help message and exit
--version Displays the current version then exits
--cookies COOKIES Set path to cookie.txt (REQUIRED)
-l LINKS, --links LINKS Downloads user or post links. Suports comman seperated lists.
-f FILE, --fromfile FILE Download users and posts from a file seperated by newlines
--favorite-users Downloads all users saved in your favorites. (Requires logged in cookies)
--favorite-posts Downloads all posts saved in your favorites. (Requires logged in cookies)
-o PATH, --output PATH Set path to download posts
-a FILE, --archive FILE Downloads only posts that are not in provided archive file. (Can not be used with --update)
-u, --update Updates already downloaded posts. (post must have json log) (can not be used with --archive)
-i, --ignore-errors Continue to download post(s) when an error occurs
--yt-dlp Tries to Download embeds with yt-dlp. (experimental)
--post-timeout SEC The amount of time in seconds to wait between saving a posts. (default: 0)
--retry-download COUNT The amount of times to try to redownload a file. (automatically ignores errors) (default: 0)
--date DATE Only download posts from this date.
--datebefore DATE Only download posts from this date and before.
--dateafter DATE Only download posts from this date and after.
--min-filesize SIZE Do not download files smaller than SIZE. (ex. 100B, 20KB, 5MB, 1GB)
--max-filesize SIZE Do not download files larger than SIZE. (ex. 100B, 20KB, 5MB, 1GB)
--only-filetypes EXT Only downloads attachments and post file with given EXTs. Suports comman seperated lists. (ex. JPG, mp4, mp3, png)
--skip-filetypes EXT Skips attachments and post file with given EXTs. Suports comman seperated lists. (ex. JPG, mp4, mp3, png)
--skip-content Skips saving posts content.
--skip-embeds Skips saving posts embeds.
--skip-pfp-banner Skips saving users pfp and banner.
--skip-comments Skips saving posts comments.
--skip-postfile Skips saving posts post file.
--skip-attachments Skips saving posts attachments.
--skip-json Skips saving posts json. (--update won't work on posts without json)
--force-external Save all external links in content to a text file.
--force-indexing Adds an indexing value to the attachment file names to preserve ordering.
--force-inline Force download all external inline images found in post content. (experimental)
--force-yt-dlp Tries to Download links in content with yt-dlp. (experimental)
Notes
- Default download location is a
Downloadsfolder in the current working directory (will be created automatically) - Input link format:
https://kemono.party/{service}/user/{user_id}orhttps://kemono.party/{service}/user/{user_id}/post/{post_is} - Using any date option will not downlaod any gumroad posts because they have no dates
- Using
--ignore-errosposts with errors will not be archived - Using
--max-filesizeor--min-filesizewill cause files that don't havecontent-lengthin their headers to not download. This mainly includes external inline images, pfp, and banners. - When using
--favorite-usersor--favorite-postsyou must get your cookies.txt after logging into kemono.party. - You may need to install
ffmpegforyt-dlpto work - If downloading with
yt-dlpfails that will count as an error and the post won't be archived. This includes yt-dlp failing because the site was just incompatible. I will need to look into seeing if there is a different error for these two circumstances.
Known Bugs
- When downloading a file it might just stop downloading, I believe this happens when a large file is downloaded and the site doesn't have it cached so the connection gets timed out after a while. I am still looking into this issue.
Examples
# downloads all users and posts from "kemono.txt" to "C:\Users\User\Downloads" while skipping saved posts in "archive.txt"
python kemono-dl.py --cookies "cookie.txt" -o "C:\Users\User\Downloads" --archive "archive.txt" --fromfile "kemono.txt"
# only downloads user posts that were published on 1/1/21
python kemono-dl.py --cookies "cookie.txt" --date 20210101 --links https://kemono.party/SERVICE/user/USERID
# goes through all favorite users and posts only downloading files smaller than 100MB
python kemono-dl.py --cookies "cookie.txt" --favorite-users --favorite-posts --max-filesize 100MB
# downloads a post and user while ignoring downloading errors
python kemono-dl.py --cookies "cookie.txt" -i -l https://kemono.party/SERVICE/user/USERID/post/POSTID,https://kemono.party/SERVICE/user/USERID
Default File Output Format
CWD
├── kemono-dl.py
└── Downloads
└── {service}
└── {username} [{user_id}]
├── {username} [{user_id}] icon.ext
├── {username} [{user_id}] banner.ext
└── [{date}] [{post_id}] {post_title}
├── external files
│ └── video.mp4
├── attachments
│ └── attachment.ext
├── inline
│ └── image.ext
├── content.html
├── comments.html
├── embeds.txt
├── external_links.txt
├── file.ext
└── {post_id}.json
To do
- Allow file naming structure to be changed in command line
- Allow file path structure to be changed in command line
- Add Discord service (in progress)
Keep in mind
- Using this might get you IP banned from kemono party.
- This is highly unlikely now that I switched to using their API!
- If the site changes the script might break.
- This is also now highly unlikely now that I switched to using their API!
![[Feature Request] - Short media into folders according to the type of the media they are](https://avatars.githubusercontent.com/u/94597840?v=4)
2 Jun 9, 2022
1 Jan 16, 2022
3 Jun 14, 2022
3 Dec 14, 2022
12 Dec 30, 2022
2 Jan 3, 2022
2 Jan 19, 2022
1 Oct 28, 2021
6 Dec 11, 2022
7 Jul 25, 2022
8 Apr 5, 2022
6 Dec 19, 2022
1 Oct 19, 2021
10 Jun 18, 2022
27 Nov 6, 2022
35 Jul 20, 2022
13 Aug 27, 2022
2 Oct 25, 2021
2 Jun 6, 2022