Xientraa/The-Sims-Resource-Downloader

How to use?

Closed this issue · 9 comments

Hello, i'm super new at this and don't know a single thing of how to operate your tool, if it's not much bother, could you explain please? Or send me tutorials to learn by myself? Thank you in advance!

Here is a full guide! Hope it helps.

You'll want to install Python from https://www.python.org/ and when installing, make sure the option "Add python to environment variables" is checked.

After Python is installed, you'll want to download the latest release source code from Latest (release), and extract it.

Open up the folder and open up a terminal, assuming you're a Windows user you can type cmd into folder path, and it should open a cmd in the current directory, or you can hold the shift key and right click, and you should have the option to open PowerShell.

Once a terminal is open, install the needed requirements with the command:

pip install -r requirements.txt

To edit the config, go into the src folder and find the file 'config.json' and you can adjust your config from there, if you're modifying the download directory option, if the path you put in there contains any backslashes make sure they are doubled up!

From: C:\Location\To\Download\To
To: C:\\Location\\To\\Download\\To

After installing the needed requirements, use the following command to start the program:

python src/main.py

Once the program is running, it should open up an image of a captcha, enter the characters into the program.
If entered correctly, it will say "Session with captcha successfully created".

After that, you can start downloading stuff!
To download stuff from The Sims Resource, simply copy the URL of the item you want to download, and it will start downloading.

Thank you, it worked!

Sorry if this is unwarranted, but: I suggest you pin this issue for this project; GitHub only shows open issues when you click on the Issues tab by default, which may confuse people new to Github. Pinning this issue will (I believe) get around this.
Alternatively, simply add this guide to the main repository page, or make it a wiki for the repository and link it in the main repository page (and also possibly the releases page). I know how to check a repository for hints on how to use the software already, but I don't think most people interested in this software will, no offense to them!
Also, as an aside, I suggest using an adblocker in addition to this software to make actually browsing TSR more tolerable! (Even with an adblocker, those numerous shameless pleas for people to buy premium make my blood pressure rise...) uBlock Origin is generally considered the best option, I believe, and it supports every browser I'm aware of. Don't feel the need to credit me if you include the adblocker recommendation in the guide, haha.

Apologies for taking so long to respond! This is not unwarranted at all, I am thankful for any feedback, especially when it helps less tech-savvy users use the tool. I have been working on a full Wiki guide, though have got a bit busy and still have to finish it. I also use uBlock Origin, and I never realized just how many ads there were, until I was testing it out on a Windows VM. I absolutely despise their premium adverts being forced down our throats every chance they get.

Its saying
C:\Users\chadw>python src/main.py
python: can't open file 'C:\Users\chadw\src\main.py': [Errno 2] No such file or directory
and its not working. Please help.

I have the same problem as aubryss.

You need to manually change the directory, please check out this issue: #13

I started using ths recently without any problems, but I now keep getting [ERROR] Invalid captcha code entered, please make sure the code is correct, even when the captcha is the same

Please check out Issue #16.
Also going to be locking this issue, if anyone has problems using this tool, please check for other issues similar to yours, otherwise create a new issue.

For a more in-depth guide of how to use this tool, please check out the Wiki.