Skip to content

A self-hosted media server and file management system

fix: storyboard paths are inconsistent and have no record

aminnausinc4f6342e1d37
diff --git a/app/Http/Resources/Metadata/StoryboardResource.php b/app/Http/Resources/Metadata/StoryboardResource.php
index 9c5e7870..63e70597 100644
--- a/app/Http/Resources/Metadata/StoryboardResource.php
+++ b/app/Http/Resources/Metadata/StoryboardResource.php
@@ -20,6 +20,7 @@ class StoryboardResource extends JsonResource {
'tile_width' => $this->tile_width,
'tile_height' => $this->tile_height,
'interval_seconds' => $this->interval_seconds,
+ 'path' => $this->path ? "/storage/{$this->path}" : null,
];
}
}
diff --git a/app/Jobs/Metadata/GenerateStoryboard.php b/app/Jobs/Metadata/GenerateStoryboard.php
index 02a766c7..928992e9 100644
--- a/app/Jobs/Metadata/GenerateStoryboard.php
+++ b/app/Jobs/Metadata/GenerateStoryboard.php
@@ -87,7 +87,7 @@ class GenerateStoryboard extends ManagedSubTask {
$metadata = Metadata::where('uuid', $this->uuid)->firstOrFail();
$metadata->load('video');
- $outputDir = 'metadata/media/' . Metadata::buildMetadataDirectory($metadata) . '/storyboard';
+ $outputDir = 'metadata/metadata/' . Metadata::buildMetadataDirectory($metadata) . '/storyboard';
$publicDisk = Storage::disk('public');
$publicDisk->makeDirectory($outputDir);
@@ -134,7 +134,7 @@ class GenerateStoryboard extends ManagedSubTask {
throw new FFmpegException('FFmpeg produced no output files');
}
- DB::transaction(function () use ($options, $timeElapsed, $rawCommand) {
+ DB::transaction(function () use ($options, $timeElapsed, $rawCommand, $outputDir) {
Storyboard::updateOrCreate(['metadata_uuid' => $this->uuid], [
'tile_rows' => $options->rows,
'tile_cols' => $options->cols,
@@ -145,6 +145,7 @@ class GenerateStoryboard extends ManagedSubTask {
'modified_at' => now(),
'generation_time' => $timeElapsed,
'command' => $rawCommand,
+ 'path' => $outputDir,
]);
$this->updateStoryboardScannedAt(now());
diff --git a/app/Models/Storyboard.php b/app/Models/Storyboard.php
index 2dec9f0a..a02ce29d 100644
--- a/app/Models/Storyboard.php
+++ b/app/Models/Storyboard.php
@@ -24,6 +24,8 @@ class Storyboard extends Model {
*
* command -> text (nullable)
* generation_time -> float (nullable)
+ *
+ * path -> text (nullable)
*/
protected $casts = [
'modified_at' => 'datetime',
@@ -41,6 +43,7 @@ class Storyboard extends Model {
'modified_at',
'generation_time',
'command',
+ 'path',
];
public function metadata(): BelongsTo {
@@ -54,6 +57,7 @@ class Storyboard extends Model {
'tile_width',
'tile_height',
'interval_seconds',
+ 'path',
];
}
}
diff --git a/database/migrations/2026_05_31_144220_add_path_to_storyboard.php b/database/migrations/2026_05_31_144220_add_path_to_storyboard.php
new file mode 100644
index 00000000..b9ff4b5b
--- /dev/null
+++ b/database/migrations/2026_05_31_144220_add_path_to_storyboard.php
@@ -0,0 +1,25 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+ /**
+ * Run the migrations.
+ */
+ public function up(): void {
+ Schema::table('storyboards', function (Blueprint $table) {
+ $table->text('path')->nullable();
+ });
+ }
+
+ /**
+ * Reverse the migrations.
+ */
+ public function down(): void {
+ Schema::table('storyboards', function (Blueprint $table) {
+ $table->dropColumn(['path']);
+ });
+ }
+};
diff --git a/resources/js/contracts/media.ts b/resources/js/contracts/media.ts
index 065cbf9a..9a4137b7 100644
--- a/resources/js/contracts/media.ts
+++ b/resources/js/contracts/media.ts
@@ -163,6 +163,7 @@ export interface StoryboardResource {
tile_width: number;
tile_height: number;
interval_seconds: number;
+ path?: string;
}
export interface ImageResource {
diff --git a/resources/js/service/storyboard/index.ts b/resources/js/service/storyboard/index.ts
index 1454a546..cc260f49 100644
--- a/resources/js/service/storyboard/index.ts
+++ b/resources/js/service/storyboard/index.ts
@@ -7,6 +7,8 @@ export function buildStoryboardCues(uuid: string, durationSeconds: number, story
const tilesPerSheet = rows * cols;
const cues: StoryboardCue[] = [];
+ const dir = storyboard.path ?? `/storage/metadata/metadata/${uuid.slice(0, 2)}/${uuid}/storyboard`;
+
for (let t = 0; t < durationSeconds; t += interval) {
const index = Math.floor(t / interval);
const sheet = Math.floor(index / tilesPerSheet) + 1;
@@ -19,7 +21,7 @@ export function buildStoryboardCues(uuid: string, durationSeconds: number, story
cues.push({
start: t,
end: Math.min(t + interval, durationSeconds) + padding,
- image: `/storage/metadata/${uuid.slice(0, 2)}/${uuid}/storyboard/${sheet}.jpg`,
+ image: `${dir}/${sheet}.jpg`,
x: col * tileWidth,
y: row * tileHeight,
w: tileWidth,