Skip to content

Latest commit

 

History

History
196 lines (141 loc) · 9.03 KB

README.md

File metadata and controls

196 lines (141 loc) · 9.03 KB

Ososedki-dl logo

            Tests Passing    GitHub pull requests    License


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


Alt


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

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

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.

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

WIP: Upcoming progress bar feature for heavy files

bar.online-video-cutter.com.mp4

Supported sites

Domain URL Scrapping Downloading
eromexxx https://eromexxx.com ✔️ ✔️
fapello_is https://fapello.is ✔️ ✔️
ososedki https://ososedki.com ✔️ ✔️
sorrymother https://sorrymother.to ✔️ ✔️
wildskirts https://wildskirts.com ✔️ ✔️
bunkr-albums https://bunkr-albums.io ✔️ ❌*
husvjjal_blogspot https://husvjjal.blogspot.com ✔️ ✔️
waifubitches https://waifubitches.com ✔️ ✔️
cosplayasian https://cosplayasian.com ✔️ ✔️
cosplayrule34 https://cosplayrule34.com ✔️ ✔️
cosplayboobs https://cosplayboobs.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

preview

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 bring support for more websites and improve the codebase.