feat: Add description (#2237)

* Added dto, logic to insert description and web implementation

* create text field and update on remote database

* Update description and save changes

* styling

* fix web test

* fix server test

* preserve description on metadata extraction job run

* handle exif info is null situation

* pr feedback

* format openapi spec

* update createAssetDto

* refactor logic to service

* move files

* only owner can update description

* Render description correctly in shared album

* Render description correctly in shared link

* disable description edit for not owner of asset on mobile

* localization and clean up

* fix test

* Uses providers for description text (#2244)

* uses providers for description text

* comments

* fixes initial data setting

* fixes notifier

---------

Co-authored-by: martyfuhry <martyfuhry@gmail.com>

mobile/assets/i18n/en-US.json

@@ -262,5 +262,11 @@
   "version_announcement_overlay_text_1": "Hi friend, there is a new release of",
   "version_announcement_overlay_text_2": "please take your time to visit the ",
   "version_announcement_overlay_text_3": " and ensure your docker-compose and .env setup is up-to-date to prevent any misconfigurations, especially if you use WatchTower or any mechanism that handles updating your server application automatically.",
-  "version_announcement_overlay_title": "New Server Version Available \uD83C\uDF89"
+  "version_announcement_overlay_title": "New Server Version Available \uD83C\uDF89",
+  "advanced_settings_tile_title": "Advanced",
+  "advanced_settings_tile_subtitle": "Advanced user's settings",
+  "advanced_settings_troubleshooting_title": "Troubleshooting",
+  "advanced_settings_troubleshooting_subtitle": "Enable additional features for troubleshooting",
+  "description_input_submit_error": "Error updating description, check the log for more details",
+  "description_input_hint_text": "Add description..."
 }

mobile/lib/modules/asset_viewer/providers/asset_description.provider.dart

@@ -0,0 +1,93 @@
+import 'dart:async';
+
+import 'package:hooks_riverpod/hooks_riverpod.dart';
+import 'package:immich_mobile/modules/asset_viewer/services/asset_description.service.dart';
+import 'package:immich_mobile/shared/models/asset.dart';
+import 'package:immich_mobile/shared/models/exif_info.dart';
+import 'package:immich_mobile/shared/providers/db.provider.dart';
+import 'package:isar/isar.dart';
+
+class AssetDescriptionNotifier extends StateNotifier<String> {
+  final Isar _db;
+  final AssetDescriptionService _service;
+  final Asset _asset;
+
+  AssetDescriptionNotifier(
+    this._db,
+    this._service, 
+    this._asset,
+  ) : super('') {
+    _fetchLocalDescription();
+    _fetchRemoteDescription();
+  }
+
+  String get description => state;
+
+  /// Fetches the local database value for description
+  /// and writes it to [state]
+  void _fetchLocalDescription() async {
+    final localExifId = _asset.exifInfo?.id;
+
+    // Guard [localExifId] null
+    if (localExifId == null) {
+      return;
+    }
+
+    // Subscribe to local changes
+    final exifInfo = await _db
+        .exifInfos
+        .get(localExifId);
+
+    // Guard
+    if (exifInfo?.description == null) {
+      return;
+    }
+
+    state = exifInfo!.description!;
+  }
+
+  /// Fetches the remote value and sets the state
+  void _fetchRemoteDescription() async {
+    final remoteAssetId = _asset.remoteId;
+    final localExifId = _asset.exifInfo?.id;
+
+    // Guard [remoteAssetId] and [localExifId] null
+    if (remoteAssetId == null || localExifId == null) {
+      return;
+    }
+
+    // Reads the latest from the remote and writes it to DB in the service
+    final latest = await _service.readLatest(remoteAssetId, localExifId);
+
+    state = latest;
+  }
+
+  /// Sets the description to [description]
+  /// Uses the service to set the asset value
+  Future<void> setDescription(String description) async {
+    state = description;
+
+    final remoteAssetId = _asset.remoteId;
+    final localExifId = _asset.exifInfo?.id;
+
+    // Guard [remoteAssetId] and [localExifId] null
+    if (remoteAssetId == null || localExifId == null) {
+      return;
+    }
+
+    return _service
+        .setDescription(description, remoteAssetId, localExifId);
+  }
+}
+
+final assetDescriptionProvider = StateNotifierProvider
+    .autoDispose
+    .family<AssetDescriptionNotifier, String, Asset>(
+  (ref, asset) => AssetDescriptionNotifier(
+    ref.watch(dbProvider),
+    ref.watch(assetDescriptionServiceProvider),
+    asset,
+  ),
+);
+
+

mobile/lib/modules/asset_viewer/services/asset_description.service.dart

@@ -0,0 +1,62 @@
+import 'package:hooks_riverpod/hooks_riverpod.dart';
+import 'package:immich_mobile/shared/models/exif_info.dart';
+import 'package:immich_mobile/shared/providers/api.provider.dart';
+import 'package:immich_mobile/shared/providers/db.provider.dart';
+import 'package:immich_mobile/shared/services/api.service.dart';
+import 'package:isar/isar.dart';
+import 'package:openapi/api.dart';
+
+class AssetDescriptionService {
+  AssetDescriptionService(this._db, this._api);
+
+  final Isar _db;
+  final ApiService _api;
+
+  setDescription(
+    String description,
+    String remoteAssetId,
+    int localExifId,
+  ) async {
+    final result = await _api.assetApi.updateAsset(
+      remoteAssetId,
+      UpdateAssetDto(description: description),
+    );
+
+    if (result?.exifInfo?.description != null) {
+      var exifInfo = await _db.exifInfos.get(localExifId);
+
+      if (exifInfo != null) {
+        exifInfo.description = result!.exifInfo!.description;
+        await _db.writeTxn(
+          () => _db.exifInfos.put(exifInfo),
+        );
+      }
+    }
+  }
+
+  Future<String> readLatest(String assetRemoteId, int localExifId) async {
+    final latestAssetFromServer =
+        await _api.assetApi.getAssetById(assetRemoteId);
+    final localExifInfo = await _db.exifInfos.get(localExifId);
+
+    if (latestAssetFromServer != null && localExifInfo != null) {
+      localExifInfo.description =
+          latestAssetFromServer.exifInfo?.description ?? '';
+
+      await _db.writeTxn(
+        () => _db.exifInfos.put(localExifInfo),
+      );
+
+      return localExifInfo.description!;
+    }
+
+    return "";
+  }
+}
+
+final assetDescriptionServiceProvider = Provider(
+  (ref) => AssetDescriptionService(
+    ref.watch(dbProvider),
+    ref.watch(apiServiceProvider),
+  ),
+);

mobile/lib/modules/asset_viewer/ui/description_input.dart

@@ -0,0 +1,103 @@
+import 'package:easy_localization/easy_localization.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter_hooks/flutter_hooks.dart';
+import 'package:hooks_riverpod/hooks_riverpod.dart';
+import 'package:immich_mobile/modules/asset_viewer/providers/asset_description.provider.dart';
+import 'package:immich_mobile/shared/models/asset.dart';
+import 'package:immich_mobile/shared/ui/immich_toast.dart';
+import 'package:logging/logging.dart';
+import 'package:immich_mobile/shared/models/store.dart' as store;
+
+class DescriptionInput extends HookConsumerWidget {
+  DescriptionInput({
+    super.key,
+    required this.asset,
+  });
+
+  final Asset asset;
+  final Logger _log = Logger('DescriptionInput');
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final isDarkTheme = Theme.of(context).brightness == Brightness.dark;
+    final textColor = isDarkTheme ? Colors.white : Colors.black;
+    final controller = useTextEditingController();
+    final focusNode = useFocusNode();
+    final isFocus = useState(false);
+    final isTextEmpty = useState(controller.text.isEmpty);
+    final descriptionProvider = ref.watch(assetDescriptionProvider(asset).notifier);
+    final description = ref.watch(assetDescriptionProvider(asset));
+    final owner = store.Store.get(store.StoreKey.currentUser);
+    final hasError = useState(false);
+
+    controller.text = description;
+
+    submitDescription(String description) async {
+      hasError.value = false;
+      try {
+        await descriptionProvider.setDescription(
+          description,
+        );
+      } catch (error, stack) {
+        hasError.value = true;
+        _log.severe("Error updating description $error", error, stack);
+        ImmichToast.show(
+          context: context,
+          msg: "description_input_submit_error".tr(),
+          toastType: ToastType.error,
+        );
+      }
+    }
+
+    Widget? suffixIcon;
+    if (hasError.value) {
+      suffixIcon = const Icon(Icons.warning_outlined);
+    } else if (!isTextEmpty.value && isFocus.value) {
+      suffixIcon = IconButton(
+        onPressed: () {
+          controller.clear();
+          isTextEmpty.value = true;
+        },
+        icon: Icon(
+          Icons.cancel_rounded,
+          color: Colors.grey[500],
+        ),
+        splashRadius: 10,
+      );
+    }
+
+    return TextField(
+      enabled: owner.isarId == asset.ownerId,
+      focusNode: focusNode,
+      onTap: () => isFocus.value = true,
+      onChanged: (value) {
+        isTextEmpty.value = false;
+      },
+      onTapOutside: (a) async {
+        isFocus.value = false;
+        focusNode.unfocus();
+
+        if (description != controller.text) {
+          await submitDescription(controller.text);
+        }
+      },
+      autofocus: false,
+      maxLines: null,
+      keyboardType: TextInputType.multiline,
+      controller: controller,
+      style: const TextStyle(
+        fontSize: 14,
+      ),
+      decoration: InputDecoration(
+        hintText: 'description_input_hint_text'.tr(),
+        border: InputBorder.none,
+        hintStyle: TextStyle(
+          fontWeight: FontWeight.normal,
+          fontSize: 12,
+          color: textColor.withOpacity(0.5),
+        ),
+        suffixIcon: suffixIcon,
+      ),
+    );
+  }
+}

mobile/lib/modules/asset_viewer/ui/exif_bottom_sheet.dart

@@ -2,25 +2,25 @@ import 'package:easy_localization/easy_localization.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_map/flutter_map.dart';
 import 'package:hooks_riverpod/hooks_riverpod.dart';
+import 'package:immich_mobile/modules/asset_viewer/ui/description_input.dart';
 import 'package:immich_mobile/shared/models/asset.dart';
-import 'package:immich_mobile/shared/models/exif_info.dart';
 import 'package:immich_mobile/shared/ui/drag_sheet.dart';
 import 'package:latlong2/latlong.dart';
 import 'package:immich_mobile/utils/bytes_units.dart';
 
 class ExifBottomSheet extends HookConsumerWidget {
-  final Asset assetDetail;
+  final Asset asset;
 
-  const ExifBottomSheet({Key? key, required this.assetDetail})
+  const ExifBottomSheet({Key? key, required this.asset}) : super(key: key);
-      : super(key: key);
 
   bool get showMap =>
-      assetDetail.exifInfo?.latitude != null &&
+      asset.exifInfo?.latitude != null && asset.exifInfo?.longitude != null;
-      assetDetail.exifInfo?.longitude != null;
 
   @override
   Widget build(BuildContext context, WidgetRef ref) {
-    final ExifInfo? exifInfo = assetDetail.exifInfo;
+    final exifInfo = asset.exifInfo;
+    var isDarkTheme = Theme.of(context).brightness == Brightness.dark;
+    var textColor = isDarkTheme ? Colors.white : Colors.black;
 
     buildMap() {
       return Padding(
@@ -76,19 +76,6 @@ class ExifBottomSheet extends HookConsumerWidget {
       );
     }
 
-    final textColor = Theme.of(context).primaryColor;
-
-    buildLocationText() {
-      return Text(
-        "${exifInfo?.city}, ${exifInfo?.state}",
-        style: TextStyle(
-          fontSize: 12,
-          fontWeight: FontWeight.bold,
-          color: textColor,
-        ),
-      );
-    }
-
     buildSizeText(Asset a) {
       String resolution = a.width != null && a.height != null
           ? "${a.height} x ${a.width}  "
@@ -128,13 +115,39 @@ class ExifBottomSheet extends HookConsumerWidget {
             children: [
               Text(
                 "exif_bottom_sheet_location",
-                style: TextStyle(fontSize: 11, color: textColor),
+                style: TextStyle(
+                  fontSize: 11,
+                  color: textColor,
+                  fontWeight: FontWeight.bold,
+                ),
               ).tr(),
               buildMap(),
-              if (exifInfo != null &&
+              RichText(
-                  exifInfo.city != null &&
+                text: TextSpan(
-                  exifInfo.state != null)
+                  style: TextStyle(
-                buildLocationText(),
+                    fontSize: 12,
+                    fontWeight: FontWeight.bold,
+                    color: textColor,
+                    fontFamily: 'WorkSans',
+                  ),
+                  children: [
+                    if (exifInfo != null && exifInfo.city != null)
+                      TextSpan(
+                        text: exifInfo.city,
+                      ),
+                    if (exifInfo != null &&
+                        exifInfo.city != null &&
+                        exifInfo.state != null)
+                      const TextSpan(
+                        text: ", ",
+                      ),
+                    if (exifInfo != null && exifInfo.state != null)
+                      TextSpan(
+                        text: "${exifInfo.state}",
+                      ),
+                  ],
+                ),
+              ),
               Text(
                 "${exifInfo!.latitude!.toStringAsFixed(4)}, ${exifInfo.longitude!.toStringAsFixed(4)}",
                 style: const TextStyle(fontSize: 12),
@@ -146,7 +159,7 @@ class ExifBottomSheet extends HookConsumerWidget {
     }
 
     buildDate() {
-      final fileCreatedAt = assetDetail.fileCreatedAt.toLocal();
+      final fileCreatedAt = asset.fileCreatedAt.toLocal();
       final date = DateFormat.yMMMEd().format(fileCreatedAt);
       final time = DateFormat.jm().format(fileCreatedAt);
 
@@ -167,27 +180,37 @@ class ExifBottomSheet extends HookConsumerWidget {
             padding: const EdgeInsets.only(bottom: 8.0),
             child: Text(
               "exif_bottom_sheet_details",
-              style: TextStyle(fontSize: 11, color: textColor),
+              style: TextStyle(
+                fontSize: 11,
+                color: textColor,
+                fontWeight: FontWeight.bold,
+              ),
             ).tr(),
           ),
           ListTile(
             contentPadding: const EdgeInsets.all(0),
             dense: true,
-            leading: const Icon(Icons.image),
+            leading: Icon(
+              Icons.image,
+              color: textColor.withAlpha(200),
+            ),
             title: Text(
-              assetDetail.fileName,
+              asset.fileName,
               style: TextStyle(
                 fontWeight: FontWeight.bold,
                 color: textColor,
               ),
             ),
-            subtitle: buildSizeText(assetDetail),
+            subtitle: buildSizeText(asset),
           ),
           if (exifInfo?.make != null)
             ListTile(
               contentPadding: const EdgeInsets.all(0),
               dense: true,
-              leading: const Icon(Icons.camera),
+              leading: Icon(
+                Icons.camera,
+                color: textColor.withAlpha(200),
+              ),
               title: Text(
                 "${exifInfo!.make} ${exifInfo.model}",
                 style: TextStyle(
@@ -203,80 +226,75 @@ class ExifBottomSheet extends HookConsumerWidget {
       );
     }
 
-    return SingleChildScrollView(
+    return GestureDetector(
-      child: Card(
+      onTap: () {
-        shape: const RoundedRectangleBorder(
+        // FocusScope.of(context).unfocus();
-          borderRadius: BorderRadius.only(
+      },
-            topLeft: Radius.circular(15),
+      child: SingleChildScrollView(
-            topRight: Radius.circular(15),
+        child: Card(
+          shape: const RoundedRectangleBorder(
+            borderRadius: BorderRadius.only(
+              topLeft: Radius.circular(15),
+              topRight: Radius.circular(15),
+            ),
           ),
-        ),
+          margin: const EdgeInsets.all(0),
-        margin: const EdgeInsets.all(0),
+          child: Container(
-        child: Container(
+            margin: const EdgeInsets.symmetric(horizontal: 16.0),
-          margin: const EdgeInsets.symmetric(horizontal: 8.0),
+            child: LayoutBuilder(
-          child: LayoutBuilder(
+              builder: (context, constraints) {
-            builder: (context, constraints) {
+                if (constraints.maxWidth > 600) {
-              if (constraints.maxWidth > 600) {
+                  // Two column
-                // Two column
+                  return Padding(
-                return Padding(
+                    padding: const EdgeInsets.symmetric(horizontal: 12.0),
-                  padding: const EdgeInsets.symmetric(horizontal: 12.0),
+                    child: Column(
-                  child: Column(
+                      crossAxisAlignment: CrossAxisAlignment.stretch,
-                    crossAxisAlignment: CrossAxisAlignment.stretch,
+                      children: [
-                    children: [
+                        buildDragHeader(),
-                      buildDragHeader(),
+                        buildDate(),
-                      buildDate(),
+                        if (asset.isRemote) DescriptionInput(asset: asset),
-                      const SizedBox(height: 32.0),
+                        Row(
-                      Row(
+                          mainAxisAlignment: MainAxisAlignment.spaceEvenly,
-                        mainAxisAlignment: MainAxisAlignment.spaceEvenly,
+                          crossAxisAlignment: CrossAxisAlignment.start,
-                        crossAxisAlignment: CrossAxisAlignment.start,
+                          children: [
-                        children: [
+                            Flexible(
-                          Flexible(
+                              flex: showMap ? 5 : 0,
-                            flex: showMap ? 5 : 0,
+                              child: Padding(
-                            child: Padding(
+                                padding: const EdgeInsets.only(right: 8.0),
-                              padding: const EdgeInsets.only(right: 8.0),
+                                child: buildLocation(),
-                              child: buildLocation(),
+                              ),
                             ),
-                          ),
+                            Flexible(
-                          Flexible(
+                              flex: 5,
-                            flex: 5,
+                              child: Padding(
-                            child: Padding(
+                                padding: const EdgeInsets.only(left: 8.0),
-                              padding: const EdgeInsets.only(left: 8.0),
+                                child: buildDetail(),
-                              child: buildDetail(),
+                              ),
                             ),
-                          ),
+                          ],
-                        ],
+                        ),
-                      ),
+                        const SizedBox(height: 50),
-                      const SizedBox(height: 50),
+                      ],
-                    ],
-                  ),
-                );
-              }
-
-              // One column
-              return Column(
-                crossAxisAlignment: CrossAxisAlignment.stretch,
-                children: [
-                  buildDragHeader(),
-                  buildDate(),
-                  const SizedBox(height: 16.0),
-                  if (showMap)
-                    Divider(
-                      thickness: 1,
-                      color: Colors.grey[600],
                     ),
-                  const SizedBox(height: 16.0),
+                  );
-                  buildLocation(),
+                }
-                  const SizedBox(height: 16.0),
+
-                  Divider(
+                // One column
-                    thickness: 1,
+                return Column(
-                    color: Colors.grey[600],
+                  crossAxisAlignment: CrossAxisAlignment.stretch,
-                  ),
+                  children: [
-                  const SizedBox(height: 16.0),
+                    buildDragHeader(),
-                  buildDetail(),
+                    buildDate(),
-                  const SizedBox(height: 50),
+                    if (asset.isRemote) DescriptionInput(asset: asset),
-                ],
+                    const SizedBox(height: 8.0),
-              );
+                    buildLocation(),
-            },
+                    SizedBox(height: showMap ? 16.0 : 0.0),
+                    buildDetail(),
+                    const SizedBox(height: 50),
+                  ],
+                );
+              },
+            ),
           ),
         ),
       ),

mobile/lib/modules/asset_viewer/views/gallery_viewer.dart

@@ -195,7 +195,12 @@ class GalleryViewerPage extends HookConsumerWidget {
               .getSetting<bool>(AppSettingsEnum.advancedTroubleshooting)) {
             return AdvancedBottomSheet(assetDetail: assetDetail!);
           }
-          return ExifBottomSheet(assetDetail: assetDetail!);
+          return Padding(
+            padding: EdgeInsets.only(
+              bottom: MediaQuery.of(context).viewInsets.bottom,
+            ),
+            child: ExifBottomSheet(asset: assetDetail!),
+          );
         },
       );
     }

mobile/lib/modules/settings/ui/advanced_settings/advanced_settings.dart

@@ -1,3 +1,4 @@
+import 'package:easy_localization/easy_localization.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_hooks/flutter_hooks.dart';
 import 'package:hooks_riverpod/hooks_riverpod.dart';
@@ -25,19 +26,25 @@ class AdvancedSettings extends HookConsumerWidget {
     return ExpansionTile(
       textColor: Theme.of(context).primaryColor,
       title: const Text(
-        "Advanced",
+        "advanced_settings_tile_title",
         style: TextStyle(
           fontWeight: FontWeight.bold,
         ),
-      ),
+      ).tr(),
+      subtitle: const Text(
+        "advanced_settings_tile_subtitle",
+        style: TextStyle(
+          fontSize: 13,
+        ),
+      ).tr(),
       children: [
         SettingsSwitchListTile(
           enabled: true,
           appSettingService: appSettingService,
           valueNotifier: isEnabled,
           settingsEnum: AppSettingsEnum.advancedTroubleshooting,
-          title: "Troubleshooting",
+          title: "advanced_settings_troubleshooting_title".tr(),
-          subtitle: "Enable additional features for troubleshooting",
+          subtitle: "advanced_settings_troubleshooting_subtitle".tr(),
         ),
       ],
     );

mobile/lib/shared/models/exif_info.dart

@@ -21,6 +21,7 @@ class ExifInfo {
   String? city;
   String? state;
   String? country;
+  String? description;
 
   @ignore
   String get exposureTime {
@@ -58,7 +59,8 @@ class ExifInfo {
         long = dto.longitude?.toDouble(),
         city = dto.city,
         state = dto.state,
-        country = dto.country;
+        country = dto.country,
+        description = dto.description;
 
   ExifInfo({
     this.fileSize,
@@ -74,6 +76,7 @@ class ExifInfo {
     this.city,
     this.state,
     this.country,
+    this.description,
   });
 }
 

server/apps/immich/src/api-v1/asset/asset-repository.ts

@@ -1,6 +1,6 @@
 import { SearchPropertiesDto } from './dto/search-properties.dto';
 import { CuratedLocationsResponseDto } from './response-dto/curated-locations-response.dto';
-import { AssetEntity, AssetType } from '@app/infra/entities';
+import { AssetEntity, AssetType, ExifEntity } from '@app/infra/entities';
 import { Inject, Injectable } from '@nestjs/common';
 import { InjectRepository } from '@nestjs/typeorm';
 import { Repository } from 'typeorm/repository/Repository';
@@ -55,6 +55,7 @@ export class AssetRepository implements IAssetRepository {
     private assetRepository: Repository<AssetEntity>,
 
     @Inject(ITagRepository) private _tagRepository: ITagRepository,
+    @InjectRepository(ExifEntity) private exifRepository: Repository<ExifEntity>,
   ) {}
 
   async getAllVideos(): Promise<AssetEntity[]> {
@@ -268,6 +269,17 @@ export class AssetRepository implements IAssetRepository {
       asset.tags = tags;
     }
 
+    if (asset.exifInfo != null) {
+      asset.exifInfo.description = dto.description || '';
+      await this.exifRepository.save(asset.exifInfo);
+    } else {
+      const exifInfo = new ExifEntity();
+      exifInfo.description = dto.description || '';
+      exifInfo.asset = asset;
+      await this.exifRepository.save(exifInfo);
+      asset.exifInfo = exifInfo;
+    }
+
     return await this.assetRepository.save(asset);
   }
 

server/apps/immich/src/api-v1/asset/asset.module.ts

@@ -2,7 +2,7 @@ import { Module } from '@nestjs/common';
 import { AssetService } from './asset.service';
 import { AssetController } from './asset.controller';
 import { TypeOrmModule } from '@nestjs/typeorm';
-import { AssetEntity } from '@app/infra/entities';
+import { AssetEntity, ExifEntity } from '@app/infra/entities';
 import { AssetRepository, IAssetRepository } from './asset-repository';
 import { DownloadModule } from '../../modules/download/download.module';
 import { TagModule } from '../tag/tag.module';
@@ -16,7 +16,7 @@ const ASSET_REPOSITORY_PROVIDER = {
 @Module({
   imports: [
     //
-    TypeOrmModule.forFeature([AssetEntity]),
+    TypeOrmModule.forFeature([AssetEntity, ExifEntity]),
     DownloadModule,
     TagModule,
     AlbumModule,

server/apps/immich/src/api-v1/asset/dto/update-asset.dto.ts

@@ -25,4 +25,8 @@ export class UpdateAssetDto {
     ],
   })
   tagIds?: string[];
+
+  @IsOptional()
+  @IsString()
+  description?: string;
 }

server/apps/microservices/src/processors/metadata-extraction.processor.ts

@@ -223,7 +223,6 @@ export class MetadataExtractionProcessor {
 
       const newExif = new ExifEntity();
       newExif.assetId = asset.id;
-      newExif.description = '';
       newExif.fileSizeInByte = data.format.size || null;
       newExif.dateTimeOriginal = fileCreatedAt ? new Date(fileCreatedAt) : null;
       newExif.modifyDate = null;

server/immich-openapi-specs.json

@@ -3675,6 +3675,11 @@
             "type": "string",
             "nullable": true,
             "default": null
+          },
+          "description": {
+            "type": "string",
+            "nullable": true,
+            "default": null
           }
         }
       },
@@ -5283,6 +5288,9 @@
           },
           "isArchived": {
             "type": "boolean"
+          },
+          "description": {
+            "type": "string"
           }
         }
       },

server/libs/domain/src/asset/response-dto/exif-response.dto.ts

@@ -23,6 +23,7 @@ export class ExifResponseDto {
   city?: string | null = null;
   state?: string | null = null;
   country?: string | null = null;
+  description?: string | null = null;
 }
 
 export function mapExif(entity: ExifEntity): ExifResponseDto {
@@ -46,5 +47,6 @@ export function mapExif(entity: ExifEntity): ExifResponseDto {
     city: entity.city,
     state: entity.state,
     country: entity.country,
+    description: entity.description,
   };
 }

server/libs/domain/test/fixtures.ts

@@ -343,6 +343,7 @@ const assetInfo: ExifResponseDto = {
   city: 'city',
   state: 'state',
   country: 'country',
+  description: 'description',
 };
 
 const assetResponse: AssetResponseDto = {

web/src/api/open-api/api.ts

@@ -1208,6 +1208,12 @@ export interface ExifResponseDto {
      * @memberof ExifResponseDto
      */
     'country'?: string | null;
+    /**
+     * 
+     * @type {string}
+     * @memberof ExifResponseDto
+     */
+    'description'?: string | null;
 }
 /**
  * 
@@ -2341,6 +2347,12 @@ export interface UpdateAssetDto {
      * @memberof UpdateAssetDto
      */
     'isArchived'?: boolean;
+    /**
+     * 
+     * @type {string}
+     * @memberof UpdateAssetDto
+     */
+    'description'?: string;
 }
 /**
  * 

web/src/lib/components/asset-viewer/asset-viewer.svelte

@@ -251,6 +251,18 @@
 			}
 		});
 	};
+
+	const disableKeyDownEvent = () => {
+		if (browser) {
+			document.removeEventListener('keydown', onKeyboardPress);
+		}
+	};
+
+	const enableKeyDownEvent = () => {
+		if (browser) {
+			document.addEventListener('keydown', onKeyboardPress);
+		}
+	};
 </script>
 
 <section
@@ -352,7 +364,13 @@
 			class="bg-immich-bg w-[360px] row-span-full transition-all overflow-y-auto dark:bg-immich-dark-bg dark:border-l dark:border-l-immich-dark-gray"
 			translate="yes"
 		>
-			<DetailPanel {asset} albums={appearsInAlbums} on:close={() => (isShowDetail = false)} />
+			<DetailPanel
+				{asset}
+				albums={appearsInAlbums}
+				on:close={() => (isShowDetail = false)}
+				on:description-focus-in={disableKeyDownEvent}
+				on:description-focus-out={enableKeyDownEvent}
+			/>
 		</div>
 	{/if}
 

web/src/lib/components/asset-viewer/detail-panel.svelte

@@ -5,14 +5,26 @@
 	import CameraIris from 'svelte-material-icons/CameraIris.svelte';
 	import MapMarkerOutline from 'svelte-material-icons/MapMarkerOutline.svelte';
 	import { createEventDispatcher } from 'svelte';
-	import { AssetResponseDto, AlbumResponseDto } from '@api';
+	import { AssetResponseDto, AlbumResponseDto, api } from '@api';
 	import { asByteUnitString } from '../../utils/byte-units';
 	import { locale } from '$lib/stores/preferences.store';
 	import { DateTime } from 'luxon';
 	import type { LatLngTuple } from 'leaflet';
+	import { page } from '$app/stores';
 
 	export let asset: AssetResponseDto;
 	export let albums: AlbumResponseDto[] = [];
+	let textarea: HTMLTextAreaElement;
+	let description: string;
+
+	$: {
+		// Get latest description from server
+		if (asset.id) {
+			api.assetApi
+				.getAssetById(asset.id)
+				.then((res) => (textarea.value = res.data?.exifInfo?.description || ''));
+		}
+	}
 
 	$: latlng = (() => {
 		const lat = asset.exifInfo?.latitude;
@@ -34,6 +46,27 @@
 
 		return undefined;
 	};
+
+	const autoGrowHeight = (e: Event) => {
+		const target = e.target as HTMLTextAreaElement;
+		target.style.height = 'auto';
+		target.style.height = `${target.scrollHeight}px`;
+	};
+
+	const handleFocusIn = () => {
+		dispatch('description-focus-in');
+	};
+
+	const handleFocusOut = async () => {
+		dispatch('description-focus-out');
+		try {
+			await api.assetApi.updateAsset(asset.id, {
+				description: description
+			});
+		} catch (error) {
+			console.error(error);
+		}
+	};
 </script>
 
 <section class="p-2 dark:bg-immich-dark-bg dark:text-immich-dark-fg">
@@ -48,6 +81,23 @@
 		<p class="text-immich-fg dark:text-immich-dark-fg text-lg">Info</p>
 	</div>
 
+	<div class="mx-4 mt-10">
+		<textarea
+			bind:this={textarea}
+			class="max-h-[500px]
+      text-base text-black bg-transparent dark:text-white border-b focus:border-b-2 border-gray-500 w-full focus:border-immich-primary dark:focus:border-immich-dark-primary transition-all resize-none overflow-hidden outline-none disabled:border-none"
+			placeholder={$page?.data?.user?.id !== asset.ownerId ? '' : 'Add a description'}
+			style:display={$page?.data?.user?.id !== asset.ownerId && textarea?.value == ''
+				? 'none'
+				: 'block'}
+			on:focusin={handleFocusIn}
+			on:focusout={handleFocusOut}
+			on:input={autoGrowHeight}
+			bind:value={description}
+			disabled={$page?.data?.user?.id !== asset.ownerId}
+		/>
+	</div>
+
 	<div class="px-4 py-4">
 		{#if !asset.exifInfo}
 			<p class="text-sm pb-4">NO EXIF INFO AVAILABLE</p>
@@ -178,7 +228,7 @@
 <section class="p-2 dark:text-immich-dark-fg">
 	<div class="px-4 py-4">
 		{#if albums.length > 0}
-			<p class="text-sm pb-4 ">APPEARS IN</p>
+			<p class="text-sm pb-4">APPEARS IN</p>
 		{/if}
 		{#each albums as album}
 			<a data-sveltekit-preload-data="hover" href={`/albums/${album.id}`}>

web/src/lib/components/shared-components/side-bar/side-bar.svelte

@@ -24,29 +24,50 @@
 	};
 
 	const getFavoriteCount = async () => {
-		const { data: assets } = await api.assetApi.getAllAssets(true, undefined);
+		try {
+			const { data: assets } = await api.assetApi.getAllAssets(true, undefined);
 
-		return {
+			return {
-			favorites: assets.length
+				favorites: assets.length
-		};
+			};
+		} catch {
+			return {
+				favorites: 0
+			};
+		}
 	};
 
 	const getAlbumCount = async () => {
-		const { data: albumCount } = await api.albumApi.getAlbumCountByUserId();
+		try {
-		return {
+			const { data: albumCount } = await api.albumApi.getAlbumCountByUserId();
-			shared: albumCount.shared,
+			return {
-			sharing: albumCount.sharing,
+				shared: albumCount.shared,
-			owned: albumCount.owned
+				sharing: albumCount.sharing,
-		};
+				owned: albumCount.owned
+			};
+		} catch {
+			return {
+				shared: 0,
+				sharing: 0,
+				owned: 0
+			};
+		}
 	};
 
 	const getArchivedAssetsCount = async () => {
-		const { data: assetCount } = await api.assetApi.getArchivedAssetCountByUserId();
+		try {
+			const { data: assetCount } = await api.assetApi.getArchivedAssetCountByUserId();
 
-		return {
+			return {
-			videos: assetCount.videos,
+				videos: assetCount.videos,
-			photos: assetCount.photos
+				photos: assetCount.photos
-		};
+			};
+		} catch {
+			return {
+				videos: 0,
+				photos: 0
+			};
+		}
 	};
 </script>