readme

README.md

@@ -0,0 +1,188 @@
+# Plex Playlist Sync
+
+A web-based tool to sync your Spotify playlists with your Plex Music Library. Upload CSV exports from Spotify, match tracks with your Plex library, and create playlists automatically.
+
+![Plex Playlist Sync](./static/spotiflac.png)
+
+## Features
+
+- **Easy CSV Upload**: Drag and drop Spotify playlist CSV exports
+- **Smart Track Matching**: Fuzzy matching algorithm finds the best tracks in your Plex library
+- **Multiple Playlists**: Process multiple CSV files at once, either as separate playlists or merged into one
+- **Web Interface**: Clean, modern UI built with Flask and Bootstrap
+- **Docker Support**: Run easily in a containerized environment
+
+## Prerequisites
+
+- Python 3.9+ (or Docker)
+- Plex Media Server with music library
+- Spotify playlist CSV export (via [Exportify](https://exportify.net/) or similar)
+
+## Quick Start
+
+### Option 1: Local Installation
+
+1. Clone the repository:
+```bash
+git clone https://github.com/yourusername/plexsync.git
+cd plexsync
+```
+
+2. Install dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+3. Run the application:
+
+**Windows:**
+```batch
+start.bat
+```
+
+**Linux/Mac:**
+```bash
+chmod +x start.sh
+./start.sh
+```
+
+Or manually:
+```bash
+python app.py
+```
+
+4. Open your browser to `http://localhost:5000`
+
+### Option 2: Docker
+
+```bash
+docker-compose up -d
+```
+
+The app will be available at `http://localhost:5000`
+
+## How to Use
+
+### 1. Export Your Spotify Playlist
+
+1. Go to [Exportify](https://exportify.net/) or similar service
+2. Login with your Spotify account
+3. Select the playlist you want to export
+4. Download as CSV
+
+### 2. Get Your Plex Token
+
+1. Sign in to [Plex Web](https://app.plex.tv/desktop)
+2. Click your profile icon → Account Settings
+3. Click **Web** in the left sidebar under Account
+4. Look for `X-Plex-Token` in the URL
+5. Copy everything after `X-Plex-Token=`
+
+> ⚠️ **Security**: Keep your token private - it provides access to your Plex server!
+
+### 3. Configure and Sync
+
+1. Open Plex Playlist Sync in your browser
+2. Enter your Plex server URL (usually `http://localhost:32400` for local)
+3. Paste your Plex token
+4. Upload your CSV file(s)
+5. Choose whether to create unified or separate playlists
+6. Review matched tracks and create your playlists!
+
+## Want High-Quality Music? Check Out SpotiFLAC!
+
+Before syncing, you might want to download your Spotify playlists in maximum quality. **[SpotiFLAC](https://github.com/afkarxyz/SpotiFLAC)** is a tool that lets you download Spotify playlists in FLAC/MP3 quality.
+
+**Workflow:**
+1. Use **SpotiFLAC** to download your Spotify playlists in high quality
+2. Add the downloaded music folder to your Plex music library
+3. Scan your Plex library to import the new tracks
+4. Use **Plex Playlist Sync** to match and create playlists from your Spotify CSV exports
+
+This gives you the best of both worlds: Spotify's curated playlists with high-quality audio files in Plex!
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `PORT` | Server port | 5000 |
+| `FLASK_DEBUG` | Enable debug mode | 0 |
+| `PLEX_BASE_URL` | Your Plex server URL | - |
+| `PLEX_TOKEN` | Your Plex auth token | - |
+
+### Docker Volume
+
+The `uploads` folder is mounted as a volume for persistent CSV storage:
+
+```yaml
+volumes:
+  - ./uploads:/app/uploads
+```
+
+## Project Structure
+
+```
+plexsync/
+├── app.py                 # Main Flask application
+├── plexsync.py           # Track matching logic
+├── requirements.txt      # Python dependencies
+├── start.bat            # Windows startup script
+├── start.sh             # Linux/Mac startup script
+├── Dockerfile           # Docker image definition
+├── docker-compose.yml   # Docker Compose configuration
+├── static/              # Static assets (CSS, JS, images)
+├── templates/           # Jinja2 HTML templates
+└── uploads/             # Uploaded CSV storage
+```
+
+## Dependencies
+
+- Flask 2.x
+- Flask-Session
+- PlexAPI
+- python-dotenv
+- unidecode
+- Werkzeug
+
+See `requirements.txt` for full list and versions.
+
+## Security Notes
+
+- **Change the secret key** in `app.py` before deploying to production
+- Use HTTPS when accessing over the internet
+- Never share your Plex token
+- The app includes CSRF protection and secure session handling
+
+## Troubleshooting
+
+### "Could not connect to Plex server"
+- Verify your Plex URL is correct
+- Check that your token is valid
+- Ensure Plex server is running and accessible
+
+### "No tracks found"
+- Make sure your music is added to a Plex music library
+- Run a library scan in Plex first
+- Check CSV format matches expected columns (Track Name, Artist Name)
+
+### Match accuracy issues
+- Ensure your Plex library has good metadata
+- Try refreshing metadata for problematic albums in Plex
+- The matching algorithm handles minor spelling variations but needs recognizable track/artist names
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Acknowledgments
+
+- [PlexAPI](https://github.com/pkkid/python-plexapi) for the Python Plex interface
+- [Exportify](https://exportify.net/) for Spotify playlist export functionality
+- **[SpotiFLAC](https://github.com/afkarxyz/SpotiFLAC)** for high-quality music downloads
+- Bootstrap and Bootstrap Icons for the UI
+
+## Contributing
+
+Contributions welcome! Please open an issue or pull request.

templates/index.html

@@ -16,7 +16,7 @@
                 <div class="row align-items-center">
                     <div class="col-md-4 text-center mb-3 mb-md-0">
                         <a href="https://github.com/afkarxyz/SpotiFLAC" target="_blank" rel="noopener noreferrer">
-                            <img src="spotiflac.png" 
+                            <img src="../static/spotiflac.png" 
                                  alt="SpotiFLAC Screenshot" 
                                  class="img-fluid rounded shadow-sm"
                                  style="max-height: 200px;"