A powerful Streamlit application running on Docker, locally on a PC, or Unraid (soon) to organize, automate, and curate your Plex Music library.
Key Features:
- Export Metadata: Dump your entire library (Tracks, Albums, Artists) to CSV.
- Smart Playlist Creator: Generate "Sonic" playlists using Plex's sonic analysis, listening history, and custom seeds (e.g., "Jazz Mix" or "Radiohead Radio").
- Bulk Editor: Update metadata via CSV (Genres, Ratings, Dates, Collections) using single or chained scripts.
- Metadata Comparator: Compare two export files to see exactly what changed in your library over time.
- Docker/Unraid Ready: Designed to run as a container with environment variables.
- Galaxy Explorer: Visualize your library and Plex's "Similar Artist" connections in an interactive 3D star map to identify relationship clusters.
- Artist Recommender: Discover missing artists using Plex artist similarity data
Music Manager for Plex
- Installation
1.1 Local Installation
1.2 Unraid Version
1.3 Docker Version
- Configuration
2.1 Local Configuration
2.2 Unraid & Docker Configuration
-
Export
-
Update from CSV (Single Script)
-
Update from CSV (Multiple Scripts)
-
Compare Exported Metadata
-
Playlist Creator
7.1 Seed Strategy
7.2 Seed Sources
7.3 Presets
7.4 Custom Naming
7.5 Playlist parameters
7.6 Rating filters
7.7 Play count filters
7.8 Year & duration filters (album-based year)
7.9 Date Added Bias
7.10 Artist / album caps
7.11 History filters (for history-based seeds & fallbacks)
7.12 Genre & collections filters
- Automation & Scheduling (Unraid)
8.1 Setting up a User Script
8.2 Scheduling (Cron Syntax)
-
Galaxy Explorer
-
Artist Recommender
-
Safety & Troubleshooting
- Clone the Repo:
git clone https://github.com/caddickzac/Music-Manager-for-Plex.git cd path/to/Music-Manager-for-Plex - Install Dependencies:
pip install -r requirements.txt
- Run the App:
streamlit run Music-Manager-for-Plex-App.py
- Install from App Store (coming soon): Search for "Music Manager for Plex" (once published) or add the container manually.
- Configure Environment Variables:
PLEX_URL: Your local server address (e.g.,http://192.168.1.50:32400).PLEX_TOKEN: Your X-Plex-Token.PLEX_LIBRARY_NAME: The exact name of your music library (Default:Music).
- Map Volumes:
/app/config.txt: (Optional) Map if you prefer file-based config./app/Exports: Crucial. Map this to a share (e.g.,/mnt/user/appdata/music-manager-for-plex/Exports) to access your CSV dumps.
The latest stable image is available on Docker Hub. You can pull it directly using the following command:
docker pull zcaddick/music-manager-for-plex:latest
Create a file named config.txt in the root folder.
Plex URL: e.g., http://192.168.1.50:32400
Plex Token: abcXYZ123token
Plex Library: Music
Note: Add the txt file to your .gitignore to keep your token safe!
Edit Environment Variables in Unraid Docker App.
The app needs these variable:
- PLEX_URL
- PLEX_TOKEN
- PLEX_LIBRARY_NAME (e.g., "Music", "HiFi", "FLAC")
The Export module allows you to extract metadata from your Plex library into CSV files. This is useful for backing up your library data, analyzing your listening habits in Excel, or preparing data for mass updates.
- Functionality: Connects to your Plex server and scans the selected music library.
- Export Levels:
- Tracks: Exports individual song data (e.g., title, rating, play count, skip count, date added, playlist/collection information).
- Albums: Exports album-level data (e.g., album title, year, track counts, average bitrate).
- Artists: Exports artist-level data (e.g., album lists for each artist, track counts, collection information, total file size).
- Output: Generates timestamped CSV files in the Exports folder. These files serve as the template for the Update modules.
Note: See the Music_Manager_Track_Level_Data_Dictionary file for descriptions of the exported metadata fields.
This tool allows you to mass-edit your Plex metadata by uploading a modified CSV file. It is an efficient way to perform bulk changes (e.g., re-tagging genres, manually setting ratings, or fixing track titles).
Workflow:
- Export: First export track details from the Export tab. This provides a detailed CSV file of your music library at three levels of granularity:
- track (“YY_MM_DD Track_Level_Info.csv”)
- album (“YY_MM_DD Artist_Album_Info.csv”)
- artist (“YY_MM_DD Artist_Level_Info.csv”)
- Edit: Make your edits to the track level csv, this is the file you will upload. Tip: Just copy the rows you are editing to a new file. Remember to include the file header row.
- Variable Mapping: The tool matches rows to your Plex content using unique track IDs (ratingKey). The tool is looking for specific variable names based on the specific action you choose. Check out the Expected CSV schema & values dropdown box for information for each action type.
- Choose an Action for Your Update: Select your action from the Choose an action list.
- Upload csv with your edits: Either drag and drop or look up your file on the Drag and drop file here button.
- Confirm action: Type CONFIRM to sign off on your submission. Warning: Edits to metadata in plex can cause hard-to-fix errors or even corrupt your database. Make sure to make a backup of your data first and complete small test runs (3-5 tracks) before committing an action.
- Run: Commits the changes to your Plex Media Server.
Notes:
- Editing track genres is computationally taxing because each track’s genre metadata must be ‘locked’ after updating. Be mindful when using this action and check computation times with small batches (50 tracks or less) before committing to a longer run.
- Editing artist titles is not possible via the API. This must be manually changed in the Plex app.
This tool works like the Update from CSV (Single Script), but it allows for multiple scripts to run one after another. For example, you can edit an artists’ genre, album genre, and track genre information in one run. The same rules for variable mapping apply for each action. See section 2. Update from CSV (Single Script) for more details.
This analysis tool takes two export files (e.g., "Export_Jan_01.csv" and "Export_Feb_01.csv") and highlights the differences.
- Purpose:
- Track how your library has changed across time.
- Verify that a bulk update script worked correctly.
- Identify accidental metadata changes or lost ratings.
- Output: Features a dynamic column selector allowing you to choose exactly which variables to check (e.g., Bitrate, Mood, Rating). Generates a detailed report of differences side-by-side.
The Playlist Creator is an advanced music control room for creating playlists in your Plex music library. Unlike standard Plex smart playlists which are rigid (e.g., "All Rock tracks"), this tool uses distinct seed modes and playlist parameters like Exploit/Explore logic to mix your favorite hits with lesser known tracks, balance them sonically, and allows for constraints like album release year, the added date to your library, or specifying acceptable genres.
Seed Strategy has different modes which are the primary strategy used to gather candidate tracks for a playlist.
Brief description: Intelligently guesses the best strategy based on what inputs you provide.
How it works:
- If Genre Seeds are present -> Defaults to Genre Mode.
- If Seed Tracks are present -> Defaults to Sonic Tracks Mix.
- If Seed Artists are present -> Defaults to Sonic Artist Mix.
- If no seeds are provided -> Defaults to History + Seeds (pure history).
Brief description: Picks full albums related to your seed tracks (great for rediscovering deep cuts).
How it works:
- Harvest Seeds: Collects seed tracks from inputs.
- Logic: If Seed Artists are provided, it works harder, grabbing up to 15 seed tracks per artist to ensure it touches multiple albums.
- Identify Parent Albums: Looks up the Album ID for every seed track.
- Fetch Siblings: Grabs all valid tracks from those identified albums.
- Smart Sort: Sorts tracks on those albums based on Explore/Exploit (Popularity) and Recency Bias.
- Fair Share Distribution: Forces a "Fair Share" loop so no single album dominates.
Inputs it uses:
- Seed Artists: Uses "Deep Dive Target" to pull a wide sample.
- Seed Tracks/Playlists/Collections: Used to identify albums.
- Explore vs. Exploit: Determines if you get "hits" or "deep cuts" from the album.
- Exclude Played (Days): Crucial for "finishing" albums you started.
Inputs it ignores:
- Sonic Similarity: Ignored (uses Metadata, not Audio).
- Sonic Journey: Ignored.
Brief description: Pulls top tracks from specific genres (e.g., "Shoegaze").
How It Works:
- Track-Level Search: Asks Plex for tracks tagged with the genre.
- Album-Level Fallback: If track search yields few results, searches for Albums tagged with the genre.
- Smart Sort: Ranks the pool using Explore/Exploit (Popularity).
- Strictness Check: If "Genre Strict" is on, verifies selected tracks match the genre tags (Track > Album > Artist).
Inputs It Uses:
- Genre Seeds: The engine of this mode.
- Explore vs. Exploit: Determines "Classics" vs "Deep Cuts".
- Genre Strictness: Gatekeeper for accuracy.
Inputs It Ignores:
- Sonic Similarity: Ignored.
- Seed Tracks/Artists: Ignored (focuses purely on the Genre list).
Brief description: Combines tracks from your history (favorites) with any specific manual seeds you enter.
How it works:
- Creates a pool of your "Top Tracks" from the last X days (defined by History Lookback).
- "Unpacks" any Seed Playlists/Collections into individual tracks and adds them to the pool.
- Applies filters and sorts by popularity/bias.
Inputs It Uses:
- History Lookback: Determines the time window for history.
- Seed Tracks/Playlists/Collections: Added directly to the mix.
Inputs It Ignores:
- Sonic Similarity: No sonic matching is performed; tracks are added raw.
Brief description: Finds artists sonically similar to your seeds and picks their top tracks.
How it works:
- Takes your Seed Artists (or the artists of your Seed Tracks).
- Asks Plex for the "Sonically Similar Artists" for each.
- Grabs the top tracks from those related artists.
Inputs It Uses:
- Seed Artists: Primary input.
- Sonically Similar per Seed: Determines how many related artists to find.
Brief description: Finds full albums sonically similar to your seed albums.
How it works:
- Identifies the parent albums of your Seed Tracks.
- Asks Plex for "Sonically Similar Albums."
- Picks tracks from those related albums (applying Explore/Exploit logic).
Inputs It Uses:
- Seed Tracks/Albums: Used to find the source albums.
- Sonically Similar per Seed: Determines how many related albums to fetch.
Brief description: Finds individual tracks that match the sonic profile of your seed tracks.
How it works:
- Takes every Seed Track (unpacked from playlists/collections).
- Asks Plex for the closest "Sonically Similar Tracks."
- Creates a pool of these lookalikes.
Inputs It Uses:
- Seed Tracks/Playlists/Collections: The source targets.
- Sonically Similar per Seed: Controls match precision (Lower = Tighter match, Higher = More variety).
Brief description: A blend of Artist, Album, and Track sonic matching for maximum variety.
How it works:
- Runs Sonic Artist, Sonic Album, and Sonic Track logic simultaneously.
- Merges the results into a massive candidate pool.
- Ideal for filling large playlists where you want variety in how the music relates (some sound alike, some are from similar artists).
Inputs It Uses:
- All Seed Inputs: Artists, Tracks, and Albums are all utilized.
Brief description: Finds tracks from your history that also match the sonic profile of your seeds (e.g., "Songs I own and love that sound like Tame Impala”).
How it works:
- Pool A: Harvests your listening history.
- Pool B: Performs a Sonic Track search based on your seeds.
- Intersection: Keeps ONLY tracks that appear in both pools.
Inputs It Uses:
- History Lookback: Defines the "History" pool.
- Seed Tracks: Defines the "Sonic" pool.
Best Used For: Rediscovering favorites with a specific vibe.
Brief description: Builds a coherent chain where Song A leads musically to Song B, then to Song C.
How it works:
- Requires at least 2 Seed Tracks.
- Uses Plex's sonic analysis to find the "path of least resistance" between the seeds.
- Fills the gap with tracks that bridge the sonic gap.
Inputs It Uses:
- Seed Tracks: Must have at least 2.
- Max Tracks: Acts as an approximate target length for the path.
Note: Cannot be sorted by Date/Popularity as the order is fixed by the sonic path.
Brief description: Takes an existing collection and re-sorts/filters it without adding outside tracks. How it works:
- Fetches all tracks from the Seed Collection.
- Applies your Playlist Parameters (filters, sort logic).
- Does not add any external music. Inputs It Uses:
- Seed Collection: Mandatory.
- All Filters: (Rating, Year, Play Count) are used to prune the collection.
Seed sources behave differently based on seed strategy choice.
Key Takeaway
- Playlists & Collections are just "shortcuts" to adding lots of Tracks.
- Genre Mode ignores all of these inputs (it only cares about the "Genre Seeds" text box).
- Strict Collection mode specifically requires a Seed Collection to work; other inputs are ignored.
To use specific tracks as inputs to generating your playlist enter one or more comma-separated Track ID (ratingKeys; e.g., 12345). To find a Track ID use the Export module in the tool and look for the “Track_ID” variable in the track level CSV file. Additionally, you can find this information within Plex by clicking the three dots on a track, selecting “Get Info”, then selecting “View XML” from the pop-up window. In the window that appears find “Track ratingKey=” and grab the specific ID number for that track.
How is this affected by Seed Strategy choice?
- Works on: Sonic Tracks Mix, Sonic Journey, Sonic Combo, Sonic Album Mix, Sonic Artist Mix, Deep Dive, and History + Seeds.
- Ignored by: Genre Mode, Strict Collection.
- Does it affect the tracklist? Yes, directly.
- Explanation: For "Sonic Tracks" or "Journey," these specific songs are used as the targets for similarity matching. For "Album" or "Deep Dive" modes, the script looks up the parent album/artist of these tracks and uses those as the seeds.
To use specific artists as inputs to generating your playlist enter the artist names in a comma-separated list.
How is this affected by Seed Strategy choice?
- Works on: Sonic Artist Mix, Sonic Album Mix, Sonic Combo, Deep Dive, and History + Seeds.
- Ignored by: Genre Mode, Strict Collection, Sonic Journey, Sonic Tracks Mix.
- Does it affect the tracklist? Yes, but via expansion.
- Explanation: In "Deep Dive," this grabs the artist's discography. In "Sonic Artist" modes, it finds other artists who sound similar to these names. Note that "Sonic Journey" ignores this input because it requires specific track waveforms to build a path, which an Artist name cannot provide.
To use specific collections as inputs to generating your playlist enter the collection names in a comma-separated list. Note: track, album, and artist level collections will all work.
How is this affected by Seed Strategy choice?
- Works on: ALL Sonic Modes, Deep Dive, History + Seeds, and Strict Collection.
- Ignored by: Genre Mode.
- Does it affect the tracklist? Yes.
- Explanation: Like playlists, this unpacks into a list of tracks for most modes. However, if you are using "Strict Collection" mode, this input is mandatory. That mode uses this collection as the exclusive source pool and ignores other inputs.
To use specific playlists as inputs to generating your new playlist enter the playlist names in a comma-separated list.
How is this affected by Seed Strategy choice?
- Works on: Sonic Tracks Mix, Sonic Journey, Sonic Combo, Sonic Album Mix, Sonic Artist Mix, Deep Dive, and History + Seeds.
- Ignored by: Genre Mode, Strict Collection.
- Does it affect the tracklist? Yes, by unpacking into tracks.
- Explanation: The script immediately "unpacks" the playlist into a list of individual tracks. Once unpacked, these function exactly like Seed track ratingKeys
All input parameters can be saved and loaded. Choose a Preset Name for saving and click “Save current settings as preset.” Load presets from the “Load existing preset” list and clear the form inputs back to defaults with the “Reset Inputs” button.
To have your playlist appear in Plex with a custom name add a label to the “Custom playlist title (optional) box.
7.5 Playlist parameters
Prevents track fatigue by excluding songs you have listened to recently.
- Input: Number of days (integer).
- Logic: Checks the viewedAt (Last Played) timestamp of every candidate track. If the track was played within the last X days, it is removed from the pool, even if it is a perfect sonic match.
- 0 = Disabled (Allows tracks played today).
Determines the time window used when harvesting tracks from your listening history.
- Input: Number of days (integer).
- Usage:
- History + Seeds Mode: Defines the window for "Top Tracks."
- Historical Ratio: If you blend history into a genre playlist, this setting defines how far back the script looks to find your "favorites."
- Default: 30 days.
The target length for the final playlist.
- Input: Integer (e.g., 50, 100).
- Note: In "Sonic Journey" mode, this acts as an approximate target, but the actual path length may vary slightly depending on how the algorithm connects the start and end tracks.
Controls the "width" of the net cast when searching for similar music in Sonic modes.
- Input: Integer (Standard default is 20).
- Logic: For every seed track you provide, the script asks Plex for the top N sonically similar tracks.
- Impact:
- Lower values (e.g., 5-10): Tighter matches, very similar to the seed, but less variety.
- Higher values (e.g., 100): More variety and discovery, but potential for less relevant matches.
Specific to Deep Dive mode. Controls how aggressively the script mines an artist's discography to find albums.
- Input: Integer (Tracks per artist).
- Logic: When you seed an artist, the script grabs this many "top tracks" from them to identify which albums to pull from.
- Impact: A higher number ensures more albums from that artist are covered (e.g., finding the "Deep Cuts" album, not just the "Greatest Hits" album).
Determines the balance between "New Discovery" (Seeds/Genre) and "Nostalgia" (Your History).
- Input: Decimal between 0.0 and 1.0.
- 0.0 (Pure Discovery): The playlist is built entirely from your seeds or genre rules.
- 0.3 (30% History): The script reserves 30% of the playlist slots for tracks from your listening history (filtered by the History Lookback settings).
- 1.0 (Pure History): The playlist is strictly your top tracks, essentially ignoring other seeds.
Determines if you get "hits" or "deep cuts" from that genre.
Range:
- 1.0 (Exploit): Strictly picks the highest-scoring tracks (the "Best" matches).
- 0.0 (Explore): Completely shuffles the candidate pool (Pure Random).
Recommendation: A value of 0.7 ensures high quality tracks while allowing for some surprises. If you want less “hits” and more “deep cuts” use a value of 0.3 or lower.
A post-processing step that reorders the final playlist to ensure optimal flow.
- Checkbox: On/Off.
- Logic: It does not select which songs are in the playlist, only where they sit. It uses a "Scout + Chain" method to arrange tracks so that each song is sonically similar to the one before it, creating a seamless listening experience rather than a jarring shuffle.
The fallback safety net. If your specific inputs (e.g., "Sonic matches for this obscure track") result in fewer songs than your Max Tracks target, this setting determines how to fill the empty space.
- Options:
- History: Fills the remainder with your top played tracks (subject to History filters).
- Genre: Fills the remainder with random tracks matching the Genre Seeds (if provided).
- None: The playlist will simply be shorter than requested.
Track ratings are measured on 10 pt scale, where 4.5 stars is a rating of 9 and 5 stars is a rating of 10.
Set minimum track rating for inclusion on a playlist (0-10).
Set album track rating for inclusion on a playlist (0-10).
Set minimum artist rating for inclusion on a playlist (0-10).
If “Allow unrated items” is checked then items (tracks/albums/artists) can still appear on a playlist.
If Min Track Rating > 0:
- It checks the Track's rating.
- If the rating is None (unrated) and "Allow Unrated" is OFF, the track is rejected. If Min Album Rating > 0:
- It looks up the Album.
- If the Album's rating is None and "Allow Unrated" is OFF, the track is rejected (even if the track itself is rated 5 stars). If Min Artist Rating > 0:
- It looks up the Artist.
- If the Artist's rating is None and "Allow Unrated" is OFF, the track is rejected (even if the track and its album are rated 5 stars).
Tip: If you want to omit low rated tracks but include unrated tracks, set a minimum rating score and check the allow unrated items box.
Based on number of plays in Plex (viewCount). Use –1 to ignore a bound. Example: min=0, max=0 will include only never-played tracks.
Variables:
- Min play count (–1 = no minimum)
- Set minimum number of plays for each track.
- Max play count (–1 = no maximum)
- Set maximum number of plays for each track.
Inputs of 0 represents no minimum for each setting.
Variables for setting album ranges:
- Min album year (0 = none) o e.g., “1965” (or later)
- Max album year (0 = none) o e.g., “2000 (or earlier)
Variables for setting track duration ranges:
- Min track duration (sec, 0 = none)
- Max track duration (sec, 0 = none)
Determines if you get more newly added tracks or older tracks (those in your library longer)
Range:
- 1.0 = Prefer the newest tracks available in the current selection of candidate tracks.
- 0.0 = Ignore date when selecting tracks for playlist.
Set a cap for how many tracks from specific albums or artists are allowed (0 = no cap).
Variables:
- Max tracks per artist (0 = no cap)
- Max tracks per album (0 = no cap)
When do "History Filters" apply? They apply only to tracks pulled from your listening history in these three specific scenarios:
- Historical Ratio: If you are running a "Genre" playlist but have Historical Ratio set to 0.3 (30%), the script pulls 30% of the tracks from your listening history. Those specific tracks will be filtered by History Min Rating / History Max Play Count.
- History Mode: If your Seed Mode is set to "History + Seeds", the history portion obeys these filters.
- Fallback: If your Genre seeds generate 0 results and the script falls back to History, the fallback tracks obey these filters.
Tracks harvested via Genre Seeds (or Sonic similarity, or Deep Dive) ignore the "History Filters."
Variables:
- History: min track rating (0–10)
- History: max play count (–1 = no max)
These filters allow you to include or omit tracks based on genre or collection inclusion. Note: These inputs behave differently based on seed strategy choices.
List genre tagging for tracks and albums that you want included in your playlist (note: artist level genre tagging is ignored for this input).
How is this affected by Seed Strategy choice?
- Works on: Genre Mode (and "Auto" if it guesses Genre).
- Ignored by: Deep Dive, Sonic Modes, History, Strict Collection.
- Does it affect the tracklist? Only if you are in Genre Mode.
- Explanation: If you are in "Sonic Journey" mode and you type "Rock" here, the script ignores it. It does not force your Sonic Journey to be Rock songs. It is strictly used to start the playlist in Genre Mode.
List any collections in your plex library that a track must be included within to be present in your generated playlist.
How is this affected by Seed Strategy choice?
- Works on: ALL Modes.
- Does it affect the tracklist? Yes, drastically.
- Explanation: This acts as a strict gatekeeper. If you run a "Sonic Journey" or "Deep Dive" but put "My Favorites" in this box, the script will generate the playlist normally, but then delete every song that is not in your "My Favorites" collection.
List any collections in your plex library that will omit any track that is included within them (e.g., “Christmas” or “Holiday” if you don’t want music from this collection appearing).
How is this affected by Seed Strategy choice?
- Works on: ALL Modes.
- Does it affect the tracklist? Yes.
- Explanation: This applies the final "cleanup" to every mode. If you exclude the "Christmas" collection, those songs are removed regardless of whether they came from a Sonic match, a Deep Dive, or your History.
List any genres you do not want present in your playlist. Note: This variable checks all levels for each track (track, album, and artist metadata).
How is this affected by Seed Strategy choice?
- Works on: ALL Modes.
- Does it affect the tracklist? Yes.
- Explanation: This runs a "scorched earth" check on Track/Album/Artist tags. It will strip these genres out of any playlist type (Sonic, History, etc.).
Choose whether or not to be strict with genre inclusion. If checked, only genres listed in the genre seeds box will be allowed. If unchecked, then the percentage of tracks outside the listed genres will map onto inputted slider value.
Hierarchy of checks when "Genre Strict" is on:
- Track Genres (First Priority):
- If the specific song is tagged "Rock", it passes, even if the Album is "Pop".
- Album Genres (Second Priority):
- If the song has no tags, it checks the Album. If the Album is "Rock", it passes.
- Artist Genres (Third Priority):
- If the Song and Album are empty, it checks the Artist. If the Artist is tagged "Rock", it passes.
How is this affected by Seed Strategy choice?
- Works on: ALL Modes, assuming you provided at least one genre tag in the Genre seeds box.
You can automate the generation of your playlists so they refresh with new music automatically (e.g., waking up to a fresh "Morning Coffee" mix every day). For Unraid users, the recommended method is using the User Scripts plugin.
- Prerequisite: Install the User Scripts plugin via the Unraid Apps tab.
- Create a Preset: Ensure you have saved your desired settings as a Preset inside the Music Manager for Plex web interface (e.g., "Indie Mix").
- Add New Script:
- Go to Settings > User Scripts.
- Click "Add New Script".
- Name it (e.g., Playlist Creator - Indie Mix).
- Enter the Script: Click the gear icon next to your new script and select "Edit Script". Paste the following code:
#!/bin/bash
# Run the Playlist Creator inside the Docker container using a saved preset
# Replace "Indie Mix" with your exact Preset Name (keep the quotes)
docker exec Music-Manager-for-Plex python /app/Extras/Scripts/playlist_creator.py --preset "Indie Mix"
# or to schedule regular metadata exports
#!/bin/bash
docker exec -e OUTPUT_CSV="/app/Exports/Track_Level_Info.csv" Music-Manager-for-Plex python /app/Extras/Scripts/export_library_metadata.py
- Save Changes.
8.2 Scheduling (Cron Syntax)
To run the script automatically, you need to define a schedule using Cron Syntax in the "Custom" schedule box.
A Cron schedule consists of 5 fields separated by spaces: * Minute * Hour * Day_of_Month * Month * Day_of_Week
Breakdown: * Minute: 0-59 * Hour: 0-23 (24-hour format, e.g., 5 = 5 AM, 17 = 5 PM) * Day of Month: 1-31 * Month: 1-12 * Day of Week: 0-7 (0 and 7 are Sunday, 1 is Monday, etc.)
The Galaxy Explorer is a 3D visualization tool that maps the artists in your library as a celestial constellation. It transforms your metadata into a physics-based network where proximity represents similarity.
Key Features:
- Metadata-Driven Star Map: Navigate a 3D environment where every "star" represents an artist, positioned based on their relationships within the Plex ecosystem.
- Relationship Clustering: The explorer uses the Louvain method to detect communities, color-coding artists into clusters based on shared similarities
- The "Missing Artist" Overlay: Toggle the visibility of artists not currently in your library to identify collection gaps suggested by Plex's similarity data.
- Focus Mode: Selecting an artist centers the camera and highlights their immediate "Similar Artist" neighbors, allowing you to trace the web of influences across your library.
How to use:
- Navigate to the Galaxy Explorer tab.
- Click Launch Galaxy Explorer to initialize the network simulation.
- Select a recent Artist_Level_Info.csv from your Exports folder or upload a new one.
- Interact with the galaxy using your mouse to rotate, zoom, and explore connections. Note: This tool is computationally taxing and may take a while to complete depending on both the power of your computer and the size of your music library.
The Artist Recommender is a discovery tool designed to help you expand your music collection intelligently. It identifies artists that are frequently related to your current library but are missing from your collection. This tool weights suggestions based on your listening intensity to guide results to better align with your personal taste.
Key Features
- Gap Analysis: Scans the "Similar Artist" metadata of every artist in your library and compares it against your existing collection to find the "missing links".
- Listening Intensity Weighting: Uses a priority scoring formula that combines the frequency of a recommendation with your total play counts for the referring artists.
- Fuzzy Match Filtering: Employs a robust cleaning process (stripping punctuation and normalizing case) to ensure the engine doesn't recommend artists you already own under a slightly different name.
- Automated Data Preservation: Every time you generate recommendations, the app automatically saves a timestamped CSV to your Exports/ folder (YYYY_MM_DD Artist_Recommendations.csv) for easy access later.
How to Use
- Navigate to the Artist Recommender tab.
- Select a recent Artist_Level_Info.csv from the dropdown menu.
- Click Generate Recommendations.
Data Dictionary:
- Missing_Artist: The name of an artist identified in Plex's "Similar Artist" metadata who is not currently found in your library.
- Related_Library_Artists: A comma-separated list of artists already in your collection that Plex has identified as being similar to the recommended artist.
- Recommendation_Count: The total number of unique artists in your library that point to this missing artist as a "similar" peer.
- Related_Library_Artists_Total_Play_Count: The aggregate sum of all plays you have logged for the artists in your library that are related to the recommendation.
- Priority_Score = Recommendation_Count x log10 (Related_Library_Artists_Total_Play_Count + 1)
- Token Security: Never commit your config.txt to GitHub.
- "Sonic Analysis" Error: If the Playlist Creator fails, ensure you have enabled "Sonic Analysis" in your Plex Library settings and that the scheduled task has completed processing your music.
- Bulk Edits: Writes to Plex are potentially destructive. Always Export a backup CSV before running a bulk update script.