move failed downloads sideways
[clinton/thingy_grabber.git] / README.md
1 # thingy_grabber
2 Script for archiving thingiverse things. Due to this being a glorified webscraper, it's going to be very fragile.
3
4 ## Usage:
5 `thingy_grabber.py user_name collection_name`
6
7 Where `user_name` is the name of the creator of the collection (not nes. your name!) and `collection_name` is the name of the collection you want.
8
9 This will create a series of directorys `user-collection/thing-name` for each thing in the collection.
10 If a thing's directory already exists, it will be skipped.
11
12 If for some reason a download fails, it will get moved sideways to `thing-name-failed` - this way if you rerun it, it will only reattmpt any failed things.
13
14 ## Requirements
15 python3, beautifulsoup4, requests, lxml
16
17 ## Current features:
18 - can download an entire collection, creating seperate subdirs for each thing in the collection
19
20 ## Todo features:
21 - download a single thing
22 - download things by designer
23 - less perfunctory error checking / handling
24 - attempt to use -failed dirs for resuming
25 - detect updated models and redownload them