A self-hosted media server and file management system
Vue ffmpegfile-serverjellyfinlaravelmediamedia-playermedia-servermediabrowsermediaservermusicmusic-librarymusic-playermusicplayerself-hostedvuejs
feat: add explore page to readme
aminnausin87c91a847e2e
diff --git a/README.md b/README.mdindex 0b9256f0..02b7c732 100755--- a/README.md+++ b/README.md@@ -52,7 +52,7 @@ MediaServer is naturally folder-oriented and great for mixed, personal, or highlBoth can serve shows, movies, and music but with different approaches.| Feature | Jellyfin | MediaServer |-|---------|----------|-------------|+| --------- | ---------- | ------------- || **Content Focus** | Official metadata-first; built for movies/TV/Music | Folder-first; great for mixed/personal content and TV shows / music || **Watch History** | Only resume + watched flag | Full watch history with timestamps, re-watch counts, total view counts, per-user history, and playback heatmaps || **Player Experience** | Fullscreen; no browsing while playing | YouTube-style; browse folders while watching |@@ -220,17 +220,18 @@ Below are screenshots of the current webpage on Desktop and Android. -->-### Desktop Browser View+### Desktop Player<p align="center">- <img src="https://github.com/user-attachments/assets/c163a27d-0c14-47e8-bb5e-cda06a9c635c" width="700" alt="Desktop Home View" />+ <img src="./doc/img/pages/player_dark.png#gh-dark-mode-only" width="838" alt="Desktop Player Dark Mode" />+ <img src="./doc/img/pages/player_light.png#gh-light-mode-only" width="838" alt="Desktop Player Light Mode" /></p><!-- -->-### Android Browser View+### Mobile Player<!--@@ -238,19 +239,26 @@ Below are screenshots of the current webpage on Desktop and Android.--><p align="center">- <img src="https://github.com/user-attachments/assets/083daf6b-b4c0-49f8-823b-228a32060e7b" width="250" alt="Android Dark Mode" />- - <img src="https://github.com/user-attachments/assets/e010eec1-7aef-40ab-ab1b-4c1054a83e1b" width="250" alt="Android Light Mode" />+<img src="./doc/img/pages-mobile/player_dark.png" width="350" alt="Android Dark Mode" />+ +<img src="./doc/img/pages-mobile/player_light.png" width="350" alt="Android Light Mode" />+</p>++### Explore Page++<p align="center">+ <img src="./doc/img/pages/explore_dark.jpeg#gh-dark-mode-only" width="838" alt="Desktop Explore Dark Mode" />+ <img src="./doc/img/pages/explore_light.jpeg#gh-light-mode-only" width="838" alt="Desktop Explore Light Mode" /></p>### Open Graph Preview Example<p align="center">- <img src="https://github.com/user-attachments/assets/2b4ebe41-c515-41c9-a76e-0fcd5db3d2f6" width="700" alt=Open Graph Preview>+ <img src="./doc/img/features/preview.png" width="838" alt=Open Graph Preview></p><details>-<summary>Other Pages</summary>+<summary>Other Pages (outdated screenshots)</summary>### Music Player@@ -286,6 +294,12 @@ Below are screenshots of the current webpage on Desktop and Android.<img src="https://github.com/user-attachments/assets/05a2e4fd-e1c4-4fce-baed-31c850315a4c" width="700" alt="Player Option 2" /></p>+### Folder Info++<p align="center">+ <img src="./doc/img/pages/folder_info.jpeg" width="836" alt="Folder Info" />+</p>+### Setup Page<p align="center">@@ -341,7 +355,7 @@ Below are screenshots of the current webpage on Desktop and Android.[](https://github.com/aminnausin/mediaServer/releases)-MediaServer can be run via Docker (recommended) or a standard manual installation.+MediaServer can be run via Docker (recommended) or directly with PHP.### 🐳 Docker Installation (Recommended)@@ -401,9 +415,10 @@ To set up MediaServer without Docker, you’ll need:- Frontend (for compiling only): [Node.js](https://nodejs.org/en) with [Vue 3](https://vuejs.org/) + [Tailwind CSS](https://tailwindcss.com/)- Media tools: [FFmpeg](https://www.ffmpeg.org/) *(required)*, [ExifTool](https://exiftool.org/) *(optional)*- HTTPS: A valid SSL certificate is required to enable certain metadata features+- Use the nginx config in the docker folder for optimal caching> [!TIP]-> You can use [Laragon](https://laragon.org/) to simplify local setup. This will only be available on the host machine.+> You can use [Laragon](https://laragon.org/) to try it out locally. This will only be available on the host machine.```bash# 1. Clone the repository@@ -460,12 +475,8 @@ npm run vite:php-<a href="https://www.star-history.com/#aminnausin/mediaserver&Date">- <picture>- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=aminnausin/mediaserver&type=Date&theme=dark" />- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=aminnausin/mediaserver&type=Date" />- <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=aminnausin/mediaserver&type=Date" />- </picture>+<a href="https://www.star-history.com/?repos=aminnausin%2Fmediaserver&type=date&legend=top-left">+ <img alt="Star History Chart" width=814 src="./doc/img/star-history-202682.png" /></a>## Similar Projects@@ -480,6 +491,4 @@ npm run vite:phpMediaServer is intended for personal use only. It is designed to help users organise and access **their own legally obtained media** on a self-hosted server.-This project **does not condone or support piracy**, and I do not encourage the use of MediaServer for unauthorised distribution or consumption of copyrighted material.--Please respect local laws and content ownership rights when using this software.+This project **does not condone or support piracy**. Please respect local laws and content ownership rights when using this software.diff --git a/doc/img/features/preview.png b/doc/img/features/preview.pngnew file mode 100644index 00000000..ef2b66fdBinary files /dev/null and b/doc/img/features/preview.png differdiff --git a/doc/img/pages-mobile/archive/dark_old.png b/doc/img/pages-mobile/archive/dark_old.pngnew file mode 100644index 00000000..d3803f21Binary files /dev/null and b/doc/img/pages-mobile/archive/dark_old.png differdiff --git a/doc/img/pages-mobile/archive/dark_old_2.png b/doc/img/pages-mobile/archive/dark_old_2.pngnew file mode 100644index 00000000..cf64f972Binary files /dev/null and b/doc/img/pages-mobile/archive/dark_old_2.png differdiff --git a/doc/img/pages-mobile/archive/player_light.jpeg b/doc/img/pages-mobile/archive/player_light.jpegnew file mode 100644index 00000000..3a99e59aBinary files /dev/null and b/doc/img/pages-mobile/archive/player_light.jpeg differdiff --git a/doc/img/pages-mobile/player_dark.png b/doc/img/pages-mobile/player_dark.pngnew file mode 100644index 00000000..a6e584afBinary files /dev/null and b/doc/img/pages-mobile/player_dark.png differdiff --git a/doc/img/pages-mobile/player_light.png b/doc/img/pages-mobile/player_light.pngnew file mode 100644index 00000000..dd4435eeBinary files /dev/null and b/doc/img/pages-mobile/player_light.png differdiff --git a/doc/img/pages/archive/Screenshot_2-8-2026_222759.jpeg b/doc/img/pages/archive/Screenshot_2-8-2026_222759.jpegnew file mode 100644index 00000000..35e9364bBinary files /dev/null and b/doc/img/pages/archive/Screenshot_2-8-2026_222759.jpeg differdiff --git a/doc/img/pages/archive/player_dark_old.png b/doc/img/pages/archive/player_dark_old.pngnew file mode 100644index 00000000..af121226Binary files /dev/null and b/doc/img/pages/archive/player_dark_old.png differdiff --git a/doc/img/pages/explore_dark.jpeg b/doc/img/pages/explore_dark.jpegnew file mode 100644index 00000000..e5df76a8Binary files /dev/null and b/doc/img/pages/explore_dark.jpeg differdiff --git a/doc/img/pages/explore_light.jpeg b/doc/img/pages/explore_light.jpegnew file mode 100644index 00000000..3f3bd705Binary files /dev/null and b/doc/img/pages/explore_light.jpeg differdiff --git a/doc/img/pages/folder_info.jpeg b/doc/img/pages/folder_info.jpegnew file mode 100644index 00000000..35e9364bBinary files /dev/null and b/doc/img/pages/folder_info.jpeg differdiff --git a/doc/img/pages/player_dark.png b/doc/img/pages/player_dark.pngnew file mode 100644index 00000000..8c562352Binary files /dev/null and b/doc/img/pages/player_dark.png differdiff --git a/doc/img/pages/player_light.png b/doc/img/pages/player_light.pngnew file mode 100644index 00000000..082e7d39Binary files /dev/null and b/doc/img/pages/player_light.png differdiff --git a/doc/img/star-history-202682.png b/doc/img/star-history-202682.pngnew file mode 100644index 00000000..313f17a0Binary files /dev/null and b/doc/img/star-history-202682.png differ