not working & not clear

[M4rk91]

precompiled .exe simply crash when opened, and instructions for using the tool compiled with pip aren't clear

[kattjevfel]

By "crash when opened", are you trying to open the application by double clicking the exe? This is a command line tool and needs to be opened via either a command prompt.

Perhaps a "familiarity with command line tools is expected" should be added to the readme :P

[AlttiRi]

@mikf I think it makes sense to add at least a spoiler with step-by-step guide for windows users to the readme file.

Currently it contains mostly useless https://pypi.org/, https://pip.pypa.io/en/stable/ links. And not working commands due to using of python3.

Windows step-by-step guide

Download Python from here: https://www.python.org/downloads/ Make sure that you checked "Add Python to PATH" checkbox before installing:

To verify the installation open a console and type:

python --version

It should print the installed Python's version, for example: Python 3.9.13.

Use can any console: cmd, powershell, Windows Terminal, or Git BASH.

To install/update gallery-dl use the follow command:

pip install -U gallery-dl

To verify the installation open a console and type:

gallery-dl --version

It should print gallery-dl's version, for example, 1.23.0.

Now you are ready for downloading, but make you sure that the console is opened in the folder where you going to download. Use cd command to change the current directory. For example, cd C:/Downloads (the directory must exist).

To download a content just type gallery-dl and paste URL(s). For example:

gallery-dl https://twitter.com/SpaceX/status/1566636450887585792

gallery-dl https://imgur.com/S4D82dY https://imgur.com/pwbUJwD