Skip to content

A self-hosted media server and file management system

feat: better quality og previews

aminnausin21fb524e1e1d
diff --git a/app/Http/Controllers/Api/V1/PreviewController.php b/app/Http/Controllers/Api/V1/PreviewController.php
deleted file mode 100644
index a7897a47..00000000
--- a/app/Http/Controllers/Api/V1/PreviewController.php
+++ /dev/null
@@ -1,55 +0,0 @@
-<?php
-
-namespace App\Http\Controllers\Api\V1;
-
-use App\Http\Controllers\Controller;
-use App\Http\Resources\FolderResource;
-use App\Models\Category;
-use App\Models\Folder;
-use Illuminate\Http\Request;
-
-class PreviewController extends Controller {
- public function showPreview(Request $request, $dir = null) {
- // Parse the URL path
- $path = $request->path(); // e.g. category/folder?video=123
- // You’ll need logic to resolve this to the right category/folder/video
-
- $data = [
- 'title' => 'Example Title',
- 'description' => 'An auto-generated preview for bots.',
- 'imageUrl' => 'https://yourcdn.com/cover.jpg',
- 'url' => $request->fullUrl(),
- ];
-
- try {
- $category = Category::where('is_private', false)->oldest('id')->first();
-
- // If no category is found, redirect to /setup
- if (! $category) {
- return response()->view('og-preview', $data);
- }
-
- $folder = $category->default_folder_id ? Folder::find($category->default_folder_id) : $category->folders()->first();
-
- if (! $folder) {
- return response()->view('og-preview', $data);
- }
-
- $folderResource = new FolderResource($folder);
-
- $data['title'] = "$category->name · $folderResource->name";
- $data['description'] = $folderResource->series->description ?? $category->description ?? 'No Description';
- $data['imageUrl'] = $folderResource->series->thumbnail_url ? $folderResource->series->thumbnail_url : asset('storage/thumbnails/default.webp');
- $data['raw'] = $folderResource->series->thumbnail_url ? $folderResource->series->thumbnail_url : asset('storage/thumbnails/default.webp');
-
- return response()->view('og-preview', $data);
- } catch (\Throwable $th) {
- return response()->view('og-preview', [
- 'title' => 'Example Title',
- 'description' => 'An auto-generated preview for bots.',
- 'imageUrl' => 'https://yourcdn.com/cover.jpg',
- 'url' => $request->fullUrl(),
- ]);
- }
- }
-}
diff --git a/app/Http/Controllers/DirectoryController.php b/app/Http/Controllers/DirectoryController.php
index 9593c37f..2650e536 100755
--- a/app/Http/Controllers/DirectoryController.php
+++ b/app/Http/Controllers/DirectoryController.php
@@ -109,5 +109,4 @@ class DirectoryController extends Controller {
}
}
-class ForbiddenException extends Exception {
-}
+class ForbiddenException extends Exception {}
diff --git a/app/Http/Middleware/MetadataSSR.php b/app/Http/Middleware/MetadataSSR.php
index 3623893b..5db9f96e 100644
--- a/app/Http/Middleware/MetadataSSR.php
+++ b/app/Http/Middleware/MetadataSSR.php
@@ -2,12 +2,20 @@
namespace App\Http\Middleware;
-use App\Http\Controllers\Api\V1\PreviewController;
+use App\Http\Resources\FolderResource;
+use App\Http\Resources\VideoResource;
+use App\Services\PathResolverService;
use Closure;
use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Log;
use Symfony\Component\HttpFoundation\Response;
class MetadataSSR {
+ public function __construct(
+ protected PathResolverService $pathResolver
+ ) {
+ }
+
/**
* Handle an incoming request.
*
@@ -15,12 +23,72 @@ class MetadataSSR {
*/
public function handle(Request $request, Closure $next): Response {
if ($this->isSocialMediaBot($request)) {
- return app(PreviewController::class)->showPreview($request);
+ return $this->generatePreviewResponse($request);
}
return $next($request);
}
+ protected function generatePreviewResponse(Request $request): Response {
+ $defaultData = [
+ 'title' => 'Media Server',
+ 'description' => 'An auto-generated preview for bots.',
+ 'secure_url' => asset('storage/thumbnails/default.webp'),
+ 'url' => $request->fullUrl(),
+ 'isAudio' => false,
+ 'mediaUrl' => null,
+ ];
+
+ try {
+ $categoryIdentifier = $request->route('dir');
+ $folderIdentifier = $request->route('folderName') ?? '';
+ $videoId = $request->query('video');
+
+ $category = $this->pathResolver->onlyPublic()->resolveCategory($categoryIdentifier);
+ $folder = $this->pathResolver->resolveFolder(identifier: $folderIdentifier, category: $category);
+
+ $folderResource = new FolderResource($folder);
+
+ $thumbnailUrl = $folder->series->thumbnail_url
+ ?? asset('storage/thumbnails/default.webp');
+
+ $data = array_merge($defaultData, [
+ 'title' => "$category->name · {$folderResource->series->title}",
+ 'description' => $folder->series->description
+ ?? 'No Description',
+ 'secure_url' => $thumbnailUrl,
+ ]);
+
+ $video = $videoId
+ ? $folder->videos()->find($videoId)
+ : null;
+
+ if ($video) {
+ $videoResource = new VideoResource($video);
+
+ $isAudio = str_starts_with($videoResource->metadata?->mime_type, 'audio');
+ $thumbnailUrl = $videoResource->metadata->poster_url
+ ? $videoResource->metadata->poster_url : $data['secure_url'];
+ $data = array_merge($data, [
+ 'title' => "{$folderResource->series->title} · {$video->metadata->title}",
+ 'description' => $video->metadata->description
+ ?? $data['description'],
+ 'secure_url' => $thumbnailUrl,
+ 'isAudio' => $isAudio,
+ 'duration' => $videoResource->metadata->duration, // For video/music duration tag
+ 'release_date' => $video->metadata->date_released ?? $video->metadata->date_uploaded,
+ 'mime_type' => $video->mime_type,
+ ]);
+ }
+
+ return response()->view('og-preview', $data);
+ } catch (\Throwable $th) {
+ Log::warning('Error generating link preview.', [$th->getMessage()]);
+
+ return response()->view('og-preview', $defaultData);
+ }
+ }
+
protected function isSocialMediaBot(Request $request): bool {
$userAgent = strtolower($request->header('User-Agent') ?? '');
diff --git a/app/Services/PathResolverService.php b/app/Services/PathResolverService.php
index 91cceca1..cdd5660a 100644
--- a/app/Services/PathResolverService.php
+++ b/app/Services/PathResolverService.php
@@ -13,6 +13,7 @@ class PathResolverService {
public function onlyPublic(bool $value = true): self {
$this->onlyPublic = $value;
+
return $this;
}
@@ -24,8 +25,8 @@ class PathResolverService {
public function resolveCategory(string $identifier, array $select = ['id', 'name', 'default_folder_id', 'is_private']): Category {
return $this->firstSuccessful([
- fn() => $this->resolveCategoryByName($identifier, $select),
- fn() => $this->resolveCategoryById($identifier, $select),
+ fn () => $this->resolveCategoryByName($identifier, $select),
+ fn () => $this->resolveCategoryById($identifier, $select),
], "No category found matching '{$identifier}'");
}
@@ -46,11 +47,13 @@ class PathResolverService {
}
public function resolveFolder(string $identifier, Category $category, ?Collection $folders = null): ?Folder {
- if (!$folders) $folders = Folder::where('category_id', $category->id)->get();
+ if (! $folders) {
+ $folders = Folder::where('category_id', $category->id)->get();
+ }
return $this->firstSuccessful([
- fn() => $this->resolveFolderByName($identifier, $category, $folders),
- fn() => $this->resolveFolderById($identifier, $category, $folders),
+ fn () => $this->resolveFolderByName($identifier, $category, $folders),
+ fn () => $this->resolveFolderById($identifier, $category, $folders),
], "No folder found in category '{$category->name}' matching '{$identifier}'");
}
diff --git a/resources/views/og-preview.blade.php b/resources/views/og-preview.blade.php
index 10b6d254..85e560e9 100644
--- a/resources/views/og-preview.blade.php
+++ b/resources/views/og-preview.blade.php
@@ -5,18 +5,39 @@
<meta charset="UTF-8">
<title>{{ $title }}</title>
+ @if($isAudio)
+ <meta property="og:type" content="music.song">
+ <meta property="og:audio:type" content="{{ $mime_type ?? 'audio/mpegf' }}">
+ <meta property="music:duration" content="{{ $duration ?? '' }}">
+ @else
+ <meta property="og:type" content="video.other">
+ <meta property="og:video:type" content="{{ $mime_type ?? 'video/mp4' }}">
+ <meta property="og:video:duration" content="{{ $duration ?? '' }}">
+ <meta property="og:video:release_date" content="{{ $release_date ?? '' }}">
+ @endif
+
<meta property="og:title" content="{{ $title }}">
<meta property="og:description" content="{{ $description }}">
- <meta property="og:image" content="{{ $imageUrl }}">
+ <meta property="og:image" content="{{ $secure_url }}">
<meta property="og:url" content="{{ $url }}">
- <meta property="og:type" content="video.other">
+
+
+ <meta property="og:site_name" content="{{ config('app.name', 'Media Server') }}">
<!-- <meta property="og:image" content="{{ asset('storage/thumbnails/default.webp') }}" /> -->
- <!-- <meta property="og:image" content="https://img.anili.st/media/176301" data-vue-meta="true"> -->
+ <meta property="og:image" content="https://img.anili.st/media/176301" data-vue-meta="true">
<!-- <meta property="og:url" content="https://anilist.co/anime/176301/The-Apothecary-Diaries-Season-2/" data-vue-meta="true"> -->
</head>
-<body>
+<body style="flex-direction: column; display: flex;">
+ <h1>{{ $title }}</h1>
+ <p>{{ $description }}</p>
+ @if($isAudio ?? false)
+ <p>🎵 Audio Content</p>
+ @else
+ <p>🎥 Video Content</p>
+ @endif
+ <img src="{{ $secure_url }}" width="200" />
</body>
</html>
\ No newline at end of file