ososedki_dl

                   

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
  • WIP: Upcoming progress bar feature for heavy files
  • 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.6. 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.

• Download the latest version of ososedki_dl from this repository:

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

• Install the package:

  poetry install --only main
  

• 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

https://github.com/user-attachments/assets/1b82d20f-1680-4cda-9021-ebd0f87a72ed

WIP: Upcoming progress bar feature for heavy files

https://github.com/user-attachments/assets/b3a0ecfc-4c85-4513-807a-2e1981e3eb19

Supported sites

Domain	URL	Scrapping	Downloading
eromexxx	https://eromexxx.com	:heavy_check_mark:	:heavy_check_mark:
fapello_is	https://fapello.is	:heavy_check_mark:	:heavy_check_mark:
ososedki	https://ososedki.com	:heavy_check_mark:	:heavy_check_mark:
sorrymother	https://sorrymother.to	:heavy_check_mark:	:heavy_check_mark:
wildskirts	https://wildskirts.com	:heavy_check_mark:	:heavy_check_mark:
bunkr-albums	https://bunkr-albums.io	:heavy_check_mark:	:x:*
husvjjal_blogspot	https://husvjjal.blogspot.com	:heavy_check_mark:	:heavy_check_mark:
waifubitches	https://waifubitches.com	:heavy_check_mark:	:heavy_check_mark:
cosplayasian	https://cosplayasian.com	:heavy_check_mark:	:heavy_check_mark:
cosplayrule34	https://cosplayrule34.com	:heavy_check_mark:	:heavy_check_mark:
cosplayboobs	https://cosplayboobs.com	:heavy_check_mark:	:heavy_check_mark:
cosplaythots	https://cosplaythots.com	:heavy_check_mark:	:heavy_check_mark:
ocosplay	https://ocosplay.com	:heavy_check_mark:	:heavy_check_mark:
vipthots	https://vipthots.com	:heavy_check_mark:	:heavy_check_mark:
cosxuxi	https://cosxuxi.club	:heavy_check_mark:	:heavy_check_mark:

* 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.