Metadata-Version: 2.1
Name: pymcws
Version: 0.0.4
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
Requires-Dist: pillow

# 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.  


# Version History
### v0.0.3
* Support for getting file info and parsing MPLs
* Support for getting images for library files
* More lenient timeouts for local connections should prevent huge queries from failing

### 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  


