Report Bug · Request Feature · Ask Question · Report security bug

ososedki_dl is a Python app that allows you to download all the images from online albums. The program is designed to be simple and easy to use, with a command-line interface that allows you to download images from the website with a single command. Check the Supported sites section to see the list of supported websites.

Table of Contents

• Requirements
• Installation
  • From PyPI
  • Manual installation
  • Uninstall
• Usage
  • Example of execution
  • Progress bars
  • Supported sites
• Contributors
  • How do I contribute to ososedki_dl?
• License
• Credits

Requirements

Here's a breakdown of the packages needed and their versions:

• poetry >= 1.7.1 (only for manual installation)
• aiofiles >= 24.1.0
• aiohttp >= 3.9.5
• beautifulsoup4 >= 4.12.2
• fake-useragent >= 1.5.1
• platformdirs >= 4.2.2
• requests >= 2.31.0
• requests-pprint >= 1.0.1
• rich >= 13.5.3
• tldextract >= 5.1.2
• validators >= 0.22.0

Note

The software has been developed and tested using Python 3.12.1. The minimum required version to run the software is Python 3.9. Although the software may work with previous versions, it is not guaranteed.

Installation

From PyPI

ososedki_dl can be installed easily as a PyPI package. Just run the following command:

pip3 install ososedki_dl

Important

For best practices and to avoid potential conflicts with your global Python environment, it is strongly recommended to install this program within a virtual environment. Avoid using the --user option for global installations. We highly recommend using pipx for a safe and isolated installation experience. Therefore, the appropriate command to install ososedki_dl would be:

pipx install ososedki_dl

The program can now be ran from a terminal with the ososedki_dl command.

Manual installation

If you prefer to install the program manually, follow these steps:

Warning

This will install the version from the latest commit, not the latest release.

1. Download the latest version of ososedki_dl from this repository:

   git clone https://github.com/YisusChrist/ososedki_dl
   cd ososedki_dl

2. Install the package:

   poetry install --only main

3. Run the program:

   poetry run ososedki_dl

Uninstall

If you installed it from PyPI, you can use the following command:

pipx uninstall ososedki_dl

Usage

Tip

For more information about the usage of the program, run ososedki_dl --help or ososedki_dl -h.

The program can be run from the terminal with the ososedki_dl command. It will ask you to introduce the URL of the album you want to download. The program will automatically detect the domain, scrape the media (images and videos) and download them to the path specified by the user.

Example of execution

demo.mp4

Progress bars

Since 2025-08-18, the program includes progress bars for downloading processes. This feature provides a visual indication of the progress of the operations, making it easier to track the status of the downloads. There are two types of progress bars:

• Albums: This bar shows the progress of the whole downloading process, indicating how many items have been downloaded from the album. In case you are downloading a profile, it will display as many bars as albums in the profile, each showing the progress of the respective album. Example:

  download-album.mp4

• Videos: This bar shows the progress of a single video being downloaded. It indicates how much of the video has been downloaded so far.

  download-video.mp4

Supported sites

Domain	URL	Scrapping	Downloading
bunkr-albums	https://bunkr-albums.io	✔️	❌*
cosplayasian	https://cosplayasian.com	✔️	✔️
cosplayboobs	https://cosplayboobs.com	✔️	✔️
cosplayrule34	https://cosplayrule34.com	✔️	✔️
cosplaythots	https://cosplaythots.com	✔️	✔️
cosxuxi	https://cosxuxi.club	✔️	✔️
eromexxx	https://eromexxx.com	✔️	✔️
fapello_is	https://fapello.is	✔️	✔️
husvjjal_blogspot	https://husvjjal.blogspot.com	✔️	✔️
kaizty	https://www.kaizty.com	✔️	✔️
nungvl	https://nungvl.net	✔️	✔️
ocosplay	https://ocosplay.com	✔️	✔️
ososedki	https://ososedki.com	✔️	✔️
sorrymother	https://sorrymother.top	✔️	✔️
vipthots	https://vipthots.com	✔️	✔️
waifubitches	https://waifubitches.com	✔️	✔️
wildskirts	https://wildskirts.com	✔️	✔️

* The program will only scrape the media and display the URLs. You can easily pass all the URLs to the great CyberDropDownloader and download all of them with one command:

cyberdrop_dl <URL1> <URL2> <URL3> ...

Contributors

How do I contribute to ososedki_dl?

Before you participate in our delightful community, please read the code of conduct.

I'm far from being an expert and suspect there are many ways to improve – if you have ideas on how to make the configuration easier to maintain (and faster), don't hesitate to fork and send pull requests!

We also need people to test out pull requests. So take a look through the open issues and help where you can.

See Contributing Guidelines for more details.

License

ososedki_dl is released under the GPL-3.0 License.

Credits

This program is heavily inspired by Jules-WinnfieldX's CyberDropDownloader. Sadly, the project is no longer maintained; hence, the creation of this project to try to bring support for more websites and improve the codebase.