https://github.com/manatlan/pyplaydar

a playdar thing in python ;-)
https://github.com/manatlan/pyplaydar

Last synced: 3 months ago
JSON representation

a playdar thing in python ;-)

• Host: GitHub
• URL: https://github.com/manatlan/pyplaydar
• Owner: manatlan
• Created: 2011-12-04T09:23:49.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2012-02-19T11:51:50.000Z (almost 13 years ago)
• Last Synced: 2024-10-09T12:28:17.092Z (3 months ago)
• Language: Python
• Homepage:
• Size: 180 KB
• Stars: 11
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
**pyplaydar** try to implement [Playdar](http://www.playdar.org/) in pure python. It should work with python 2.X, and use [bottle](http://bottlepy.org/) and [cherrypy wsgi server](http://docs.cherrypy.org/stable/refman/wsgiserver/init.html).

----

**Future** (19/02/2012)

* The web frontend page will be able to let you easily configure resolvers too !

----

**Features** :

* Fully compatible with [JS clients](http://www.playdarjs.org/)

* Works with original playdar's resolvers

* Compatible with [Tomahawk's resolvers](https://github.com/tomahawk-player/tomahawk-resolvers), using [pyv8](http://code.google.com/p/pyv8/).

* Works on *nix/win as is (should work on mac)

* Web frontend to easily test resolvers

* Simple and test'able

**Current notes about "playdar protocol"'s implementation** :

* for web-clients : Note that it auto-authenticate all clients

* resolve method : for a same query : it's always the same QID which is returned

* get_results : for a same file/object : it's always the same SID which is returned

----

**What's in pyplaydar**

=======================

* **libs/** : Contains externals libs provided with pyplaydar ([bottle](http://bottlepy.org/) and [cherrypy wsgi server](http://docs.cherrypy.org/stable/refman/wsgiserver/init.html))

* **static/** : Contains static ressources used by the webserver. Currently, only a template for the web frontend.

* **resolvers/** : This folder contains the playdar's compatible resolvers. Each resolver is a folder, which contains an executable.

    * **test/** : A test resolver

        * **resolver.py** : the executable, which resolve artist/title : testa/web & testa/local), that's all ;-)

    * **tomahawk/** : the resolver which is compatible with tomahawk's resolvers

        * **resolver.py** : the executable

        * **lib.py** : a python lib (to wrap pyv8/js to a python class)

        * **tomres.py** : a command line to install/uninstall tomahawk's resolvers properly.

    * **test_a_resolver.py** : A command line to test a resolver in console.

* **pyplaydar.py** : The main file : the web server, which handle http requests for playdar protocol, and for the web frontend.

* **resolver.py** :  the playdar protocol, low level.

* **tests.py** : a lot of tests, which cover 95% of the pyplaydar's code.

* **pyplaydar.conf** : the conf file

there are a lot of readme.txt files too, which explain some things.

----

**How to start**

================

**Note**: to be able to use the tomahawk's resolvers, you'll need to install [pyv8](http://code.google.com/p/pyv8/)

Grab this folder.

In a console, change dir to "resolvers/tomahawk/"

run "./tomres.py install", to install tomahawk resolvers

change dir to pyplaydar root (../..)

edit your pyplaydar.conf, to have that :

    test/resolver.py

    tomahawk/resolver.py tomahawk-resolvers/dilandau/dilandau.js

run "./pyplaydar.py"

run a browser to point "http://localhost:60210/" (this is the web frontend for testing), you can start to query dilandau