fix: update repository links to point to the correct melodee-project URLs

Author: sphildreth

Dockerfile

@@ -93,6 +93,6 @@ HEALTHCHECK --interval=30s --timeout=5s --start-period=60s --retries=3 \
     CMD curl -fsS http://localhost:8080/health || exit 1
 
 # OCI Labels
-LABEL org.opencontainers.image.source="https://github.com/sphildreth/melodee"
+LABEL org.opencontainers.image.source="https://github.com/melodee-project/melodee"
 LABEL org.opencontainers.image.description="Melodee music server"
 LABEL org.opencontainers.image.licenses="MIT"

README.md

@@ -121,105 +121,29 @@ Before installing, test drive Melodee on our demo server:
 
 👉 **[https://demo.melodee.org](https://demo.melodee.org)** (Username: `demo`, Password: `Mel0deeR0cks!`)
 
-### Prerequisites
-
-- [Podman](https://podman.io/) or Docker
-- [Podman Compose](https://github.com/containers/podman-compose) (for Podman users)
-- Python 3 (for setup script)
-
-### 🐍 Automated Setup (Recommended)
+### Automated Setup (Recommended)
 
 ```bash
-# Clone the repository
-git clone https://github.com/sphildreth/melodee.git
+git clone https://github.com/melodee-project/melodee.git
 cd melodee
-
-# Run the setup script with auto-start
 python3 scripts/run-container-setup.py --start
 ```
 
-The script will:
-- Run preflight checks (disk space, memory, ports, required files)
-- Detect your container runtime (Podman or Docker)
-- Generate a secure `.env` file with random passwords and JWT tokens
-- Build the container image
-- Start the containers and wait for health checks
-- Provide you with the URL to access Melodee
-
-#### Setup Script Options
-
-```bash
-python3 scripts/run-container-setup.py --check-only  # Just run checks
-python3 scripts/run-container-setup.py --start       # Setup and start containers
-python3 scripts/run-container-setup.py --update      # Update existing deployment
-python3 scripts/run-container-setup.py --update -y   # Update without prompts (CI/CD)
-```
-
-### 🐳 Manual Deploy with Podman
+The script handles preflight checks, runtime detection, secure configuration, building, and startup.
 
-1. **Clone the repository**
-   ```bash
-   git clone https://github.com/sphildreth/melodee.git
-   cd melodee
-   ```
-
-2. **Configure environment variables**
-   ```bash
-   # Copy and edit the example environment file
-   cp example.env .env
-   nano .env
-   ```
-
-   Update the following variables in `.env`:
-   ```bash
-   # Database password (change this!)
-   DB_PASSWORD=your_secure_password_here
-
-   # Port configuration
-   MELODEE_PORT=8080
-   ```
-
-3. **Build and deploy**
-   ```bash
-   # Using Podman (build first, then start)
-   podman compose build
-   podman compose up -d
-
-   # Or using Docker Compose
-   docker compose up -d --build
-   ```
-
-4. **Access the application**
-   - 📚 Read the [documentation](https://melodee.org) on how to get started
-   - Web Interface: http://localhost:8080
-   - Register as a new user, the first user will be setup as administrator
-   - Configure clients to connect to your server
-   - Enjoy an ad-free and self-hosted music streaming service 🎉
+📖 **Full installation guide**: [melodee.org/installing](https://melodee.org/installing/)
 
 ### 📦 Updating Melodee
 
-The safest way to update is using the setup script:
-
 ```bash
 cd melodee
 git pull
 python3 scripts/run-container-setup.py --update
 ```
 
-This preserves all your data volumes while updating the application code. For automated/CI deployments:
-
-```bash
-git pull && python3 scripts/run-container-setup.py --update --yes
-```
-
-**Manual update:**
-```bash
-git pull origin main
-podman compose build      # Rebuild with new code
-podman compose up -d      # Recreate containers (volumes preserved)
-```
+Your data (database, music library, playlists) is preserved during updates. Database migrations run automatically.
 
-> **Note**: Database migrations run automatically during container startup. Your data (database, music library, playlists) is preserved during updates.
+📖 **Full upgrade guide**: [melodee.org/upgrade](https://melodee.org/upgrade/)
 
 ## 🏠 Homelab Deployment
 
@@ -230,7 +154,7 @@ Melodee is designed to run in homelab environments with support for various hard
 - **NAS Integration**: Mount external storage for large music collections
 - **Container Orchestration**: Docker Compose, Podman Compose, or Docker Swarm
 
-For detailed homelab deployment guides, check out our [documentation](https://melodee.org).
+📖 **Deployment guides**: [melodee.org/installing](https://melodee.org/installing/) | [melodee.org/upgrade](https://melodee.org/upgrade/)
 
 ### 🗂️ Volume Management
 

design/backlog/onboarding-backlog.md

@@ -216,7 +216,7 @@ Publish pre-built images to GitHub Container Registry so users can pull instead
 **Proposed Usage**:
 ```bash
 # Instead of building locally
-podman pull ghcr.io/sphildreth/melodee:latest
+podman pull ghcr.io/melodee-project/melodee:latest
 podman compose up -d
 ```
 
@@ -232,7 +232,7 @@ podman compose up -d
 - Manual dispatch for testing
 
 **Acceptance Criteria**:
-- [ ] Images published to ghcr.io/sphildreth/melodee
+- [ ] Images published to ghcr.io/melodee-project/melodee
 - [ ] amd64 and arm64 architectures supported
 - [ ] compose.yml updated to pull from GHCR
 - [ ] Local build still works as fallback

docs/_data/toc.yml

@@ -14,6 +14,8 @@
   links:
     - title: "Homelab Deployment"
       url: "homelab"
+    - title: "Upgrade Guide"
+      url: "upgrade"
     - title: "Hardware & Performance"
       url: "hardware"
     - title: "Backup & Recovery"

docs/_posts/2026-01-12-melodee-1-8-0-released.md

@@ -0,0 +1,78 @@
+---
+title: "Melodee 1.8.0 Released"
+date: 2026-01-12
+badges:
+  - type: info
+    tag: release
+---
+
+We're excited to announce the release of Melodee 1.8.0, packed with new features for an enhanced music streaming experience!
+
+<!--more-->
+
+## What's New in 1.8.0
+
+### Party Mode
+Collaborative listening sessions with shared queues and synchronized playback control. Perfect for gatherings or remote listening parties with friends and family.
+
+- Create and manage party sessions
+- Shared queue management
+- Real-time playback synchronization
+- Participant roles and permissions
+
+### Jukebox Mode
+Server-side audio playback via MPV or MPD backends, enabling whole-home audio setups.
+
+- Control playback from any device
+- Support for MPV and MPD audio backends
+- Ideal for dedicated audio endpoints
+
+### Podcast Support
+Full podcast subscription and playback support with tracking.
+
+- Subscribe to podcasts via RSS or OPML import
+- Automatic episode downloads
+- Playback position tracking
+- Integration with OpenSubsonic podcast APIs
+
+### Custom Theming
+Personalize Melodee's appearance with custom themes.
+
+- Create custom color schemes
+- Custom fonts and branding
+- Hide/show navigation items
+- Theme pack import/export
+
+### Music Charts
+Curated album charts updated automatically.
+
+- Billboard chart integration
+- Multiple chart sources
+- Automatic updates via background jobs
+
+### Additional Improvements
+
+- **Jellyfin API compatibility** - Use Jellyfin clients with Melodee
+- **Deezer search engine** - Additional metadata source
+- **Enhanced scrobbling** - Improved Last.fm integration
+- **Performance improvements** - Faster library scanning and streaming
+
+## Upgrading
+
+To upgrade to 1.8.0, follow the [upgrade guide](/docs/upgrading/).
+
+Database migrations will run automatically on startup.
+
+## Documentation
+
+- [Party Mode Guide](/party-mode/)
+- [Jukebox Setup](/jukebox/)
+- [Podcast Configuration](/podcasts/)
+- [Theming Guide](/theming/)
+- [Charts Configuration](/charts/)
+
+## Thank You
+
+Thanks to everyone who contributed to this release through bug reports, feature requests, and pull requests!
+
+Questions or feedback? Join our [Discord community](https://discord.gg/bfMnEUrvbp) or open an issue on [GitHub](https://github.com/melodee-project/melodee/issues).

docs/index.markdown

@@ -16,10 +16,16 @@ New to Melodee? Start with our [Quick Start Guide for Homelabs](/quickstart/) to
 ## Key Features
 
 - **Scalable Architecture**: Handle millions of tracks with efficient background processing
-- **Dual API Support**: OpenSubsonic compatibility and native REST API
+- **Multi-API Support**: OpenSubsonic, Jellyfin, and native REST API compatibility
 - **Advanced Media Processing**: Automatic format conversion, metadata normalization, and validation
 - **Staging Workflow**: Review and edit metadata before publishing to your library
-- **Multiple Client Support**: Compatible with popular Subsonic clients plus official desktop and mobile apps
+- **Party Mode**: Collaborative listening sessions with shared queues and playback control
+- **Jukebox Mode**: Server-side audio playback via MPV/MPD for whole-home audio
+- **Podcast Support**: Subscribe, download, and stream podcasts with full playback tracking
+- **Custom Theming**: Personalize the UI with custom color schemes, fonts, and branding
+- **Music Charts**: Curated album charts updated automatically from Billboard and other sources
+- **Scrobbling**: Last.fm integration for play history tracking
+- **Multiple Client Support**: Compatible with popular Subsonic/Jellyfin clients
 
 ## Homelab Focus
 
@@ -31,15 +37,35 @@ Melodee is designed with homelab enthusiasts in mind:
 
 ## Documentation Sections
 
+### Getting Started
 - [Quick Start for Homelabs](/quickstart/) - Fast path to your first deployment
 - [Installation](/installing/) - Detailed setup instructions
 - [Configuration](/configuration/) - Tuning and optimization
 - [Configuration Reference](/configuration-reference/) - Comprehensive configuration options
-- [API Overview](/apis/) - Comparison of API options and interactive documentation
+
+### Features
+- [Libraries](/libraries/) - Managing your music collection
+- [Charts](/charts/) - Curated album charts
+- [Playlists](/playlists/) - Creating and managing playlists
+- [Jukebox](/jukebox/) - Server-side audio playback
+- [Party Mode](/party-mode/) - Collaborative listening sessions
+- [Podcasts](/podcasts/) - Podcast subscription and playback
+- [Theming](/theming/) - Customize the UI appearance
+- [Requests](/requests/) - User music requests
+- [Scrobbling](/scrobbling/) - Last.fm integration
+- [Shares](/shares/) - Sharing music with others
+- [Query Language (MQL)](/mql/) - Advanced search queries
+
+### Deployment & Operations
 - [Homelab Deployment](/homelab/) - Homelab-specific guidance
 - [Hardware & Performance](/hardware/) - Hardware recommendations and optimization
 - [Backup & Recovery](/backup/) - Data protection strategies
-- [API Documentation](/api/) - Native API reference
+- [Background Jobs](/jobs/) - Scheduled task management
+- [Command Line Interface](/cli/) - CLI tools and utilities
+
+### API & Integration
+- [API Overview](/apis/) - Comparison of API options
+- [API Documentation](/api/) - Native REST API reference
 
 ## Community
 

docs/pages/index.md

@@ -33,18 +33,23 @@ This server has sample permissively licensed music files for testing purposes. T
 
 ## Feature Highlights
 
-- Media normalization & configurable tag rewrite rules.
-- Regex driven cleanup (featuring/with removal, numbering fixes, stray tokens).
-- Multi‑stage pipeline (Inbound ➜ Staging ➜ Storage).
-- Pluggable metadata & artwork fetch (MusicBrainz local cache, Last.FM, Spotify, iTunes).
-- Real‑time transcoding (MP3, Ogg, Opus, etc.) with range & partial streaming.
-- Cron‑like job scheduler (scans, enrichment, cleanup, background sync).
-- Multi‑library federation (spread storage across NAS / mounts).
-- Blazor Server UI for metadata, artwork, users, config & monitoring.
-- OpenSubsonic compatibility (tested against several popular clients).
-- Native REST API (versioned) for custom integrations.
-- User features: starring, ratings, scrobbling, play tracking.
-- Concurrency‑aware streaming limiter & optional buffered responses.
+- Media normalization & configurable tag rewrite rules
+- Regex driven cleanup (featuring/with removal, numbering fixes, stray tokens)
+- Multi‑stage pipeline (Inbound ➜ Staging ➜ Storage)
+- Pluggable metadata & artwork fetch (MusicBrainz local cache, Last.FM, Spotify, iTunes, Deezer)
+- Real‑time transcoding (MP3, Ogg, Opus, etc.) with range & partial streaming
+- Cron‑like job scheduler (scans, enrichment, cleanup, background sync)
+- Multi‑library federation (spread storage across NAS / mounts)
+- Blazor Server UI for metadata, artwork, users, config & monitoring
+- [Party Mode](/party-mode/) - Collaborative listening with shared queues
+- [Jukebox](/jukebox/) - Server-side audio playback via MPV/MPD
+- [Podcasts](/podcasts/) - Subscribe, download, and stream podcasts
+- [Custom Theming](/theming/) - Personalize colors, fonts, and branding
+- [Music Charts](/charts/) - Curated album charts from Billboard and more
+- [Scrobbling](/scrobbling/) - Last.fm integration for play tracking
+- OpenSubsonic & Jellyfin API compatibility
+- Native REST API (versioned) for custom integrations
+- User features: starring, ratings, playlists, play history
 
 ## Tested OpenSubsonic Clients
 
@@ -58,12 +63,12 @@ This server has sample permissively licensed music files for testing purposes. T
 
 ## Quick Links
 
-- Installation: /installing/
-- Configuration: /configuration/
-- Libraries Concept: /libraries/
-- API Reference (OpenSubsonic + Native): /api/
-- Changelog / News: /news/
-- About & Project Direction: /about/
+- [Installation](/installing/) - Get Melodee up and running
+- [Configuration](/configuration/) - Tune settings for your environment
+- [Libraries](/libraries/) - Understand the library concept
+- [API Reference](/api/) - OpenSubsonic + Native API documentation
+- [News](/news/) - Changelog and announcements
+- [About](/about/) - Project direction and philosophy
 
 ## Contributing
 

docs/pages/theming.md

@@ -30,7 +30,7 @@ Custom themes allow you to personalize Melodee's appearance beyond the built-in
 
 ### Available Custom Themes
 
-Pre-built custom theme packs are available in the [Melodee repository's `/themes` directory](https://github.com/sphildreth/melodee/tree/main/themes):
+Pre-built custom theme packs are available in the [Melodee repository's `/themes` directory](https://github.com/melodee-project/melodee/tree/main/themes):
 
 | Theme | Base | Description |
 |-------|------|-------------|