Skip to content

Latest commit

 

History

History
58 lines (45 loc) · 2.32 KB

README.md

File metadata and controls

58 lines (45 loc) · 2.32 KB

thingiverse-browser

author: Thijs Roumen date: 2020.07.02

usage: python browser.py -s searchTerm -n imageCount

A simple tool to retreive preview images and basic data of thingiverse models. It automatically runs a series of queries using the thingiverse API based on your search term stores that data in a CSV file and creates a folder structure with preview images to get a sense for the models in each category folder structure looks like this:

search term

+--- all-models-(number of models)
    +--- thingiverse_id1.jpg
    +--- thingiverse_id2.jpg
      ...
    +--- thingiverse_idn.jpg

+--- hasMakes-(n)
    +--- thingiverse_id1.jpg
    +--- thingiverse_id2.jpg
      ...
    +--- thingiverse_idn.jpg

+--- isRemix-(n)
    +--- thingiverse_id1.jpg
    +--- thingiverse_id2.jpg
      ...
    +--- thingiverse_idn.jpg

+--- isRemix-and-hasMakes-(n)
    +--- thingiverse_id1.jpg
    +--- thingiverse_id2.jpg
      ...
    +--- thingiverse_idn.jpg

+--- customizable-(n)
    +--- thingiverse_id1.jpg
    +--- thingiverse_id2.jpg
      ...
    +--- thingiverse_idn.jpg

+--- customizable-and-hasMakes(n)
    +--- thingiverse_id1.jpg
    +--- thingiverse_id2.jpg
      ...
    +--- thingiverse_idn.jpg

Getting Started

first of all sign up for a thingiverse account and set up an App on thingiverse (doesnt have to be public, but you need it to get an API key) https://www.thingiverse.com/developers/getting-started

make a separate file called "api-key" next to this python file and put just the API key in it

install all dependencies:

  • requests: pip3 install requests
  • json: pip3 install json
  • csv: pip3 install csv