ThijsRoumen / thingiverse-browser

simple python script to browse thingiverse. Based on a search term, it crawls thingiverse, aggregates data on remixes, makes, and customizability and creates a representative folder structure on your file system

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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

About

simple python script to browse thingiverse. Based on a search term, it crawls thingiverse, aggregates data on remixes, makes, and customizability and creates a representative folder structure on your file system

License:MIT License


Languages

Language:Python 100.0%