Metadata-Version: 2.1
Name: pymcws
Version: 0.0.3
Summary: Python API for the MCWS interface of JRiver Media Center
Home-page: https://github.com/kenomaerz/pymcws
Author: Keno März
Author-email: keno.maerz@gmail.com
License: MIT
Download-URL: https://pypi.org/project/pymcws/
Keywords: JRiver,MCWS
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: requests

# pyMCWS
A python API wrapper for MCWS, the web interface of the excellent JRiver Media Center.
The aim is to replicate the MCWS functionality as close as possible in a pythonian,
easy to use manner. Additionally, common use-cases can be implemented in
easily accessible recipes.

## Usage
use your package manager of choice to install pymcws:

```bash
pipenv install pymcws
```

First order of action is to import pymcws. You can just import the package and use
it as a one-stop-shop-all:

```python
import pymcws as mcws
```

using this method, all functions and recipes are imported and available via the
mcws object. You can then initialize a server and start using commands:

```python
office = mcws.get_media_server("AccessKey", "readonly", "supersecretpassword")
mcws.play_album(office, "Ludovico Einaudi", "I Giorni")
mcws.playback_playpause(office)
zones = mcws.playback_zones(office)
for zone in zones:
    print(zone.index, zone.id, zone.name, zone.guid, zone.is_dlna)
mcws.playback_playpause(office, zones[0])

```

For a full set of examples, please see examples.py.

## Contributing
Contributions are very welcome. Please create pull requests at your leisure.
If you are not of the coding kind, you can also leave a request for a specific
functionality in the issue tracker.  


### v0.0.3
    * MediaServer now throws exception if key cannot be resolved instead of failing silently
    * Added mute, shuffle and repeat
    * Added volume control
    * Improved example.py to explain usage better
    * Fixed wrong behavior of playback_stop

### v0.0.2
    * api.py now has a method to get a server directly from pymcws object. This allows basic usage by only importing pymcws.   

### v0.0.1
    * Initial release and proof of concept
    * Resolve media network access keys
    * issue playback commands
    * search and play files to different zones on server
    * first play_recipes that facilitate playback of files  


