browse_library
Browse and filter media content in Plex libraries using criteria like genre, year, rating, play history, audio format, and technical specifications to find specific movies, TV shows, or music.
Instructions
Browse content within a specific Plex library with filtering and sorting options
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| library_id | Yes | The library ID (key) to browse | |
| sort | No | Sort order (default: titleSort) | titleSort |
| genre | No | Filter by genre | |
| year | No | Filter by release year | |
| limit | No | Maximum number of results to return (default: 20) | |
| offset | No | Number of results to skip (for pagination, default: 0) | |
| play_count_min | No | Minimum play count for results | |
| play_count_max | No | Maximum play count for results | |
| last_played_after | No | Filter items played after this date (YYYY-MM-DD format) | |
| last_played_before | No | Filter items played before this date (YYYY-MM-DD format) | |
| played_in_last_days | No | Filter items played in the last N days | |
| never_played | No | Filter to only show never played items | |
| content_rating | No | Filter by content rating (G, PG, PG-13, R, etc.) | |
| resolution | No | Filter by video resolution | |
| audio_format | No | Filter by audio format (for music) | |
| bpmMin | No | Minimum BPM (beats per minute) | |
| bpmMax | No | Maximum BPM (beats per minute) | |
| musical_key | No | Filter by musical key (e.g., 'C', 'G', 'Am', 'F#m') | |
| dynamic_range_min | No | Minimum dynamic range in dB | |
| dynamic_range_max | No | Maximum dynamic range in dB | |
| loudness_min | No | Minimum loudness in LUFS | |
| loudness_max | No | Maximum loudness in LUFS | |
| mood | No | Filter by mood/energy classification | |
| acoustic_ratio_min | No | Minimum acoustic content ratio (0-1, where 1 is fully acoustic) | |
| acoustic_ratio_max | No | Maximum acoustic content ratio (0-1, where 1 is fully acoustic) | |
| file_size_min | No | Minimum file size in MB | |
| file_size_max | No | Maximum file size in MB | |
| year_min | No | Filter by minimum release year | |
| year_max | No | Filter by maximum release year | |
| studio | No | Filter by studio/label (e.g., Warner Bros, Sony Music) | |
| director | No | Filter by director name | |
| writer | No | Filter by writer name | |
| actor | No | Filter by actor/cast member name | |
| rating_min | No | Minimum rating (0-10 scale) | |
| rating_max | No | Maximum rating (0-10 scale) | |
| duration_min | No | Minimum duration in minutes | |
| duration_max | No | Maximum duration in minutes | |
| added_after | No | Filter items added to library after this date (YYYY-MM-DD format) | |
| added_before | No | Filter items added to library before this date (YYYY-MM-DD format) |
Input Schema (JSON Schema)
{
"properties": {
"acoustic_ratio_max": {
"description": "Maximum acoustic content ratio (0-1, where 1 is fully acoustic)",
"type": "number"
},
"acoustic_ratio_min": {
"description": "Minimum acoustic content ratio (0-1, where 1 is fully acoustic)",
"type": "number"
},
"actor": {
"description": "Filter by actor/cast member name",
"type": "string"
},
"added_after": {
"description": "Filter items added to library after this date (YYYY-MM-DD format)",
"type": "string"
},
"added_before": {
"description": "Filter items added to library before this date (YYYY-MM-DD format)",
"type": "string"
},
"audio_format": {
"description": "Filter by audio format (for music)",
"enum": [
"lossless",
"lossy",
"mp3",
"flac",
"aac"
],
"type": "string"
},
"bpmMax": {
"description": "Maximum BPM (beats per minute)",
"type": "number"
},
"bpmMin": {
"description": "Minimum BPM (beats per minute)",
"type": "number"
},
"content_rating": {
"description": "Filter by content rating (G, PG, PG-13, R, etc.)",
"type": "string"
},
"director": {
"description": "Filter by director name",
"type": "string"
},
"duration_max": {
"description": "Maximum duration in minutes",
"type": "number"
},
"duration_min": {
"description": "Minimum duration in minutes",
"type": "number"
},
"dynamic_range_max": {
"description": "Maximum dynamic range in dB",
"type": "number"
},
"dynamic_range_min": {
"description": "Minimum dynamic range in dB",
"type": "number"
},
"file_size_max": {
"description": "Maximum file size in MB",
"type": "number"
},
"file_size_min": {
"description": "Minimum file size in MB",
"type": "number"
},
"genre": {
"description": "Filter by genre",
"type": "string"
},
"last_played_after": {
"description": "Filter items played after this date (YYYY-MM-DD format)",
"type": "string"
},
"last_played_before": {
"description": "Filter items played before this date (YYYY-MM-DD format)",
"type": "string"
},
"library_id": {
"description": "The library ID (key) to browse",
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum number of results to return (default: 20)",
"type": "number"
},
"loudness_max": {
"description": "Maximum loudness in LUFS",
"type": "number"
},
"loudness_min": {
"description": "Minimum loudness in LUFS",
"type": "number"
},
"mood": {
"description": "Filter by mood/energy classification",
"enum": [
"energetic",
"calm",
"aggressive",
"melancholic",
"uplifting",
"dark",
"romantic",
"mysterious"
],
"type": "string"
},
"musical_key": {
"description": "Filter by musical key (e.g., 'C', 'G', 'Am', 'F#m')",
"type": "string"
},
"never_played": {
"description": "Filter to only show never played items",
"type": "boolean"
},
"offset": {
"default": 0,
"description": "Number of results to skip (for pagination, default: 0)",
"type": "number"
},
"play_count_max": {
"description": "Maximum play count for results",
"type": "number"
},
"play_count_min": {
"description": "Minimum play count for results",
"type": "number"
},
"played_in_last_days": {
"description": "Filter items played in the last N days",
"type": "number"
},
"rating_max": {
"description": "Maximum rating (0-10 scale)",
"type": "number"
},
"rating_min": {
"description": "Minimum rating (0-10 scale)",
"type": "number"
},
"resolution": {
"description": "Filter by video resolution",
"enum": [
"4k",
"1080",
"720",
"480",
"sd"
],
"type": "string"
},
"sort": {
"default": "titleSort",
"description": "Sort order (default: titleSort)",
"enum": [
"titleSort",
"addedAt",
"originallyAvailableAt",
"rating",
"viewCount",
"lastViewedAt"
],
"type": "string"
},
"studio": {
"description": "Filter by studio/label (e.g., Warner Bros, Sony Music)",
"type": "string"
},
"writer": {
"description": "Filter by writer name",
"type": "string"
},
"year": {
"description": "Filter by release year",
"type": "number"
},
"year_max": {
"description": "Filter by maximum release year",
"type": "number"
},
"year_min": {
"description": "Filter by minimum release year",
"type": "number"
}
},
"required": [
"library_id"
],
"type": "object"
}