Metadata-Version: 2.1
Name: jellyshuf
Version: 0.0.2
Summary: Randomly add items to mpd queue from jellyfin (use in tandem with mopidy-jellyfin)
Home-page: https://github.com/deafmute1/randjmpd
Author: Ethan Djeric
Author-email: ethan@ethandjeric.com
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/deafmute1/randjmpd/issues
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE-mopidy-jellyfin
Requires-Dist: requests
Requires-Dist: python-musicpd
Requires-Dist: appdirs

# jellyshuf 
Essentially implements ncmpcpp's add random feature (default hotkey: `) through a script which grabs info from jellyfin api itself. 
jellyfin-mpd (and by proxy jellyfin-mopidy) does not implement the required mpd commands for this ncmpcpp function to work. 

# Install
## Arch Linux
Coming soon.

## Any system (pip)
`pip install jellyshuf` 

or

```
git clone https://github.com/deafmute1/jellyshuf.git
cd jellyshuf
pip install . 
```

# Usage
jellyshuf will asked for required information on first run (server url, username, password).
This info is stored to `$XDG_CONFIG_DIR/jellyshuf/user.json`
At the moment, the password is stored in plaintext in this file. In future, it will support use of keyrings.
`jellyshuf --help` 
```
USAGE: jellyshuf <FLAGS> TYPE NUMBER
    
TYPE is one of artists, albums, songs (will take forever)
    
FLAGS: 
    --stdout        Instead of adding retrieved paths to mpd queue, emits them to stdout (line separated)
    --random|-r     Set mpd to random mode
    --start|-s      Start mpd after adding new items
    --config        Run config (overwriting existing info if necessary) then exit
    --help|-h       Display this message and exit
```


