Skip to content

A self-hosted media server and file management system

feat: edited_at timestamp for metadata

aminnausin426ebb123108
diff --git a/app/Http/Controllers/Api/V1/MetadataController.php b/app/Http/Controllers/Api/V1/MetadataController.php
index 8148ccd7..fd1bf69e 100644
--- a/app/Http/Controllers/Api/V1/MetadataController.php
+++ b/app/Http/Controllers/Api/V1/MetadataController.php
@@ -43,6 +43,7 @@ class MetadataController extends Controller {
}
$validated['editor_id'] = Auth::id();
+ $validated['edited_at'] = now();
$validated['composite_id'] = $compositeId;
$metadata = $existing
@@ -61,6 +62,7 @@ class MetadataController extends Controller {
$validated = $request->validated();
$validated['editor_id'] = Auth::id();
+ $validated['edited_at'] = now();
$metadata->update($validated);
$this->generateTagRelationships($metadata->id, $request->video_tags, $request->deleted_tags, 'metadata_id', VideoTag::class);
@@ -76,8 +78,9 @@ class MetadataController extends Controller {
throw new ModelNotFoundException('Song does not exist');
}
- $validated['title'] = $validated['track']; // Track is unused
+ $validated['title'] = $validated['track']; // ?? Track is unused ? I think this is by design? The title is displayed in more places than just the lyrics editor so it should not be changed by the external api.
$validated['editor_id'] = Auth::id();
+ $validated['edited_at'] = now();
$metadata->update($validated);
return response()->json(new VideoResource($metadata->video), 200);
diff --git a/app/Http/Resources/MetadataResource.php b/app/Http/Resources/MetadataResource.php
index fa19ee4d..e7245bfb 100644
--- a/app/Http/Resources/MetadataResource.php
+++ b/app/Http/Resources/MetadataResource.php
@@ -25,6 +25,7 @@ class MetadataResource extends JsonResource {
'date_released' => $this->date_released,
'date_updated' => $this->updated_at,
'date_uploaded' => $this->date_uploaded,
+ 'edited_at' => $this->edited_at,
],
'relationships' => [
'video_id' => $this->video_id,
diff --git a/app/Http/Resources/VideoResource.php b/app/Http/Resources/VideoResource.php
index 943e95da..ea98bc05 100755
--- a/app/Http/Resources/VideoResource.php
+++ b/app/Http/Resources/VideoResource.php
@@ -9,6 +9,70 @@ class VideoResource extends JsonResource {
/**
* Transform the resource into an array.
*
+ * VIDEO
+ * id -> int8 (pk) (index)
+ * folder_id -> int8 (fk) (not indexed ???)
+ *
+ * name -> varchar(255)
+ * path -> varchar(255) (index)
+ * date -> varchar(255)
+ *
+ * uuid -> uuid (index) (nullable) (un-maintained)
+ * created_at -> timestamp (nullable)
+ *
+ * title -> varchar(255) (nullable) (legacy - remove)
+ * description -> varchar(255) (nullable) (legacy - remove)
+ * duration -> int4 (nullable) (legacy - remove)
+ * episode -> int4 (nullable) (legacy - remove)
+ * season -> int4 (nullable) (legacy - remove)
+ * view_count -> int4 (nullable) (legacy - remove)
+ *
+ *
+ *
+ * METADATA
+ * id -> int8 (pk) (index)
+ * uuid -> uuid (index) (nullable)
+ * video_id -> int8 (fk) (index) (nullable)
+ * editor_id -> int8 (fk) (nullable)
+ * composite_id -> varchar(255) (index)
+ * logical_composite_id -> text (index) (generated)
+ *
+ * title -> varchar(255) (nullable)
+ * description -> text (nullable)
+ * season -> int4 (nullable)
+ * episode -> int4 (nullable)
+ * artist -> varchar(255) (nullable)
+ * album -> varchar(255) (nullable)
+ * lyrics -> text (nullable)
+ * captions -> text (nullable)
+ *
+ * raw_thumbnail_url -> varchar(255) (nullable)
+ * poster_url -> text (nullable)
+ *
+ * resolution_width -> int4 (nullable)
+ * resolution_height -> int4 (nullable)
+ * frame_rate -> int4 (nullable)
+ * bitrate -> int8 (nullable)
+ * codec -> varchar(255) (nullable)
+ * file_size -> int8 (nullable)
+ *
+ * mime_type -> varchar(255) (nullable)
+ * media_type -> int2 (enum) (default=0)
+ *
+ * duration -> int4 (nullable)
+ * view_count -> int4 (nullable) (default=0)
+ *
+ * date_released -> date (nullable)
+ * date_scanned -> date (nullable)
+ * date_uploaded -> timestamp (nullable)
+ *
+ * edited_at -> timestamptz (nullable)
+ * file_scanned_at -> timestamptz (nullable)
+ * subtitles_scanned_at -> timestamp (nullable)
+ * created_at -> timestamp (nullable)
+ * updated_at -> timestamp (nullable)
+ *
+ *
* @return array<string, mixed>
*/
public function toArray(Request $request): array {
@@ -41,6 +105,7 @@ class VideoResource extends JsonResource {
'date_updated' => $metadata?->updated_at ?: null, // Metadata Last Updated
'date_released' => $metadata?->date_released ?: null, // User Provided Release Date
'date_uploaded' => $metadata?->date_uploaded ?: null, // File Last Modified (Should be date_added)
+ 'edited_at' => $metadata?->edited_at,
'metadata' => $metadata,
'subtitles' => SubtitleResource::collection($metadata->subtitles ?? []),
];
diff --git a/app/Models/Metadata.php b/app/Models/Metadata.php
index 5d35b696..f0d9ffd2 100644
--- a/app/Models/Metadata.php
+++ b/app/Models/Metadata.php
@@ -13,6 +13,51 @@ use Illuminate\Database\Eloquent\Relations\HasMany;
class Metadata extends Model {
use HasEditableFields, HasFactory;
+ /**
+ * id -> int8 (pk) (index)
+ * video_id -> int8 (fk) (index) (nullable)
+ * composite_id -> varchar(255) (index)
+ *
+ * title -> varchar(255) (nullable)
+ * season -> int4 (nullable)
+ * episode -> int4 (nullable)
+ * duration -> int4 (nullable)
+ * view_count -> int4 (nullable) (default=0)
+ * description -> text (nullable)
+ * date_released -> date (nullable)
+ *
+ * editor_id -> int8 (fk) (nullable)
+ * created_at -> timestamp (nullable)
+ * updated_at -> timestamp (nullable)
+ * uuid -> uuid (index) (nullable)
+ *
+ *
+ * file_size -> int8 (nullable)
+ * date_scanned -> date (nullable)
+ * poster_url -> text (nullable)
+ * mime_type -> varchar(255) (nullable)
+ * captions -> text (nullable)
+ *
+ * date_uploaded -> timestamp (nullable)
+ *
+ * resolution_width -> int4 (nullable)
+ * resolution_height -> int4 (nullable)
+ * frame_rate -> int4 (nullable)
+ * bitrate -> int8 (nullable)
+ * codec -> varchar(255) (nullable)
+ * lyrics -> text (nullable)
+ *
+ * raw_thumbnail_url -> varchar(255) (nullable)
+ * media_type -> int2 (enum) (default=0)
+ * artist -> varchar(255) (nullable)
+ * album -> varchar(255) (nullable)
+ *
+ * subtitles_scanned_at -> timestamp (nullable)
+ * logical_composite_id -> text (index) (generated)
+ *
+ * edited_at -> timestamptz (nullable)
+ * file_scanned_at -> timestamptz (nullable)
+ */
protected $fillable = [
'uuid',
'composite_id',
@@ -39,6 +84,7 @@ class Metadata extends Model {
'media_type',
'album',
'artist',
+ 'edited_at',
];
protected $guarded = ['logical_composite_id'];
@@ -46,6 +92,7 @@ class Metadata extends Model {
protected $casts = [
'date_uploaded' => 'datetime',
'file_scanned_at' => 'datetime',
+ 'edited_at' => 'datetime',
'media_type' => MediaType::class,
];
diff --git a/database/migrations/2026_01_28_015215_add_edited_at_to_metadata.php b/database/migrations/2026_01_28_015215_add_edited_at_to_metadata.php
new file mode 100644
index 00000000..fd255d62
--- /dev/null
+++ b/database/migrations/2026_01_28_015215_add_edited_at_to_metadata.php
@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+ /**
+ * Run the migrations.
+ */
+ public function up(): void {
+ Schema::table('metadata', function (Blueprint $table) {
+ $table->timestampTz('edited_at')->nullable();
+ });
+
+ DB::table('metadata')->whereNotNull('editor_id')->update(['edited_at' => DB::raw('updated_at')]);
+ }
+
+ /**
+ * Reverse the migrations.
+ */
+ public function down(): void {
+ Schema::table('metadata', function (Blueprint $table) {
+ $table->dropColumn('edited_at');
+ });
+ }
+};
diff --git a/resources/js/components/modals/EditMediaModal.vue b/resources/js/components/modals/EditMediaModal.vue
index 056addf9..e941097b 100644
--- a/resources/js/components/modals/EditMediaModal.vue
+++ b/resources/js/components/modals/EditMediaModal.vue
@@ -20,8 +20,8 @@ const handleVideoDetailsUpdate = (res: any) => {
<template>
<BaseModal>
<template #title>{{ modal.props.title ?? 'Edit Track/Video' }}</template>
- <template #description v-if="modal.props.mediaResource.date_updated && modal.props.mediaResource.metadata?.editor_id">
- <EditItemHeader :edited_at="modal.props.mediaResource.date_updated" :editor_id="modal.props.mediaResource.metadata.editor_id" />
+ <template #description v-if="modal.props.mediaResource.edited_at && modal.props.mediaResource.metadata?.editor_id">
+ <EditItemHeader :edited_at="modal.props.mediaResource.edited_at" :editor_id="modal.props.mediaResource.metadata.editor_id" />
</template>
<EditVideo v-if="modal.props.mediaResource" :video="modal.props.mediaResource" @handleFinish="handleVideoDetailsUpdate" />
</BaseModal>
diff --git a/resources/js/contracts/media.ts b/resources/js/contracts/media.ts
index f1fae9c7..69f648ae 100644
--- a/resources/js/contracts/media.ts
+++ b/resources/js/contracts/media.ts
@@ -70,6 +70,7 @@ export interface MetadataResource {
date_released?: string;
date_updated?: string;
date_uploaded?: string;
+ edited_at?: string;
};
relationships: {
video_id?: number;
@@ -97,6 +98,7 @@ export interface VideoResource {
date_released?: string;
date_updated?: string;
date_uploaded?: string;
+ edited_at?: string;
metadata?: Metadata;
subtitles: SubtitleResource[];
}