stremio-addons/documentation/using-cinemeta.md

Stremio Add-on Server / Client

# Using Cinemeta
**Cinemeta** is the most important of the offical Stremio Add-ons - it provides metadata for most movies / TV series in IMDB, as well an indexing mechanism (through ``index.get``) method that automatically identifies an IMDB ID from a filename. 
Retrieving metadata and associating video files with IMDB ID are useful use cases both for Stremio itself, and for building new Add-ons. 

# Initializing a client
```javascript
var CINEMETA_ENDPOINT = "http://stremio-cinemeta.herokuapp.com";

var Stremio = require("stremio-addons");
var addons = new Stremio.Client();
addons.add(CINEMETA_ENDPOINT);
addons.setAuth("http://api8.herokuapp.com", "8417fe936f0374fbd16a699668e8f3c4aa405d9f"); // default stremio server, testing secret
```

# Using ``meta.*`` methods
```javascript
addons.meta.get({ query: { imdb_id: "tt0032138" } }, function(err, meta) {
	console.log(meta);
});

addons.meta.find({ query: { imdb_id: "tt0032138" } }, function(err, res) { 
	console.log(res);
});
```

# Using ``index.get``
```javascript

addons.index.get({ files: [ { path: "The.Wizard.of.Oz.1939.1080p.BrRip.x264.BOKUTOX.YIFY.mp4" } ] }, function(err, res) { 
	console.log(res);
	console.log(res.files[0].imdb_id); // outputs tt0032138
});
```