Skip to content

High performance self-hosted photo and video management solution.

feat(web): add geolocation utility (#20758)

Johann662d44536e85
diff --git a/i18n/en.json b/i18n/en.json
index ccd0c9d7fe..5d215e2c36 100644
--- a/i18n/en.json
+++ b/i18n/en.json
@@ -461,6 +461,7 @@
"app_bar_signout_dialog_title": "Sign out",
"app_settings": "App Settings",
"appears_in": "Appears in",
+ "apply_count": "Apply ({count, number})",
"archive": "Archive",
"archive_action_prompt": "{count} added to Archive",
"archive_or_unarchive_photo": "Archive or unarchive photo",
@@ -1073,12 +1074,18 @@
"gcast_enabled": "Google Cast",
"gcast_enabled_description": "This feature loads external resources from Google in order to work.",
"general": "General",
+ "geolocation_instruction_all_have_location": "All assets for this date already have location data. Try showing all assets or select a different date",
+ "geolocation_instruction_location": "Click on an asset with GPS coordinates to use its location, or select a location directly from the map",
+ "geolocation_instruction_no_date": "Select a date to manage location data for photos and videos from that day",
+ "geolocation_instruction_no_photos": "No photos or videos found for this date. Select a different date to show them",
"get_help": "Get Help",
"get_wifiname_error": "Could not get Wi-Fi name. Make sure you have granted the necessary permissions and are connected to a Wi-Fi network",
"getting_started": "Getting Started",
"go_back": "Go back",
"go_to_folder": "Go to folder",
"go_to_search": "Go to search",
+ "gps": "GPS",
+ "gps_missing": "No GPS",
"grant_permission": "Grant permission",
"group_albums_by": "Group albums by...",
"group_country": "Group by country",
@@ -1262,6 +1269,7 @@
"main_branch_warning": "You're using a development version; we strongly recommend using a release version!",
"main_menu": "Main menu",
"make": "Make",
+ "manage_geolocation": "Manage location",
"manage_shared_links": "Manage shared links",
"manage_sharing_with_partners": "Manage sharing with partners",
"manage_the_app_settings": "Manage the app settings",
@@ -1722,6 +1730,7 @@
"select_user_for_sharing_page_err_album": "Failed to create album",
"selected": "Selected",
"selected_count": "{count, plural, other {# selected}}",
+ "selected_gps_coordinates": "selected gps coordinates",
"send_message": "Send message",
"send_welcome_email": "Send welcome email",
"server_endpoint": "Server Endpoint",
@@ -1832,8 +1841,10 @@
"shift_to_permanent_delete": "press ⇧ to permanently delete asset",
"show_album_options": "Show album options",
"show_albums": "Show albums",
+ "show_all_assets": "Show all assets",
"show_all_people": "Show all people",
"show_and_hide_people": "Show & hide people",
+ "show_assets_without_location": "Show assets without location",
"show_file_location": "Show file location",
"show_gallery": "Show gallery",
"show_hidden_people": "Show hidden people",
@@ -1993,6 +2004,7 @@
"unstacked_assets_count": "Un-stacked {count, plural, one {# asset} other {# assets}}",
"untagged": "Untagged",
"up_next": "Up next",
+ "update_location_action_prompt": "Update the location of {count} selected assets with:",
"updated_at": "Updated",
"updated_password": "Updated password",
"upload": "Upload",
@@ -2017,6 +2029,7 @@
"use_biometric": "Use biometric",
"use_current_connection": "use current connection",
"use_custom_date_range": "Use custom date range instead",
+ "use_this_location": "Click to use location",
"user": "User",
"user_has_been_deleted": "This user has been deleted.",
"user_id": "User ID",
diff --git a/web/src/lib/assets/empty-5.svg b/web/src/lib/assets/empty-5.svg
new file mode 100644
index 0000000000..e9e24d0499
--- /dev/null
+++ b/web/src/lib/assets/empty-5.svg
@@ -0,0 +1 @@
+<svg width="900" height="600" viewBox="0 0 900 600" fill="none" xmlns="http://www.w3.org/2000/svg"><path fill="transparent" d="M0 0h900v600H0z"/><path fill-rule="evenodd" clip-rule="evenodd" d="M249.841 115.734v250.041c0 13.572 10.867 24.563 24.287 24.563h147.186l64.25-91.581c3.063-4.369 10.722-4.369 13.786 0l22.494 32.07.175.25.152-.221 48.243-70.046c3.336-4.85 11.695-4.85 15.031 0l63.892 92.779v12.215-250.07c0-13.572-10.897-24.562-24.288-24.562H274.128c-13.42 0-24.287 10.99-24.287 24.562z" fill="#9d9ea3"/><path d="M362.501 281.935c-34.737 0-62.896-28.16-62.896-62.897 0-34.736 28.159-62.896 62.896-62.896s62.897 28.16 62.897 62.896c0 34.737-28.16 62.897-62.897 62.897z" fill="#fff"/><path d="M449.176 445.963H259.725c-7.79 0-14.188-6.399-14.188-14.188 0-7.882 6.398-14.281 14.188-14.281h189.451c7.882 0 14.28 6.399 14.28 14.281 0 7.789-6.398 14.188-14.28 14.188zm189.543.002H501.662c-7.882 0-14.281-6.399-14.281-14.281 0-7.882 6.399-14.281 14.281-14.281h137.057c7.883 0 14.281 6.399 14.281 14.281 0 7.882-6.398 14.281-14.281 14.281zm-298.503 62.592h-80.491c-7.79 0-14.188-6.398-14.188-14.188 0-7.882 6.398-14.281 14.188-14.281h80.491c7.882 0 14.281 6.399 14.281 14.281 0 7.79-6.399 14.188-14.281 14.188zm298.503.002H388.065c-7.882 0-14.28-6.398-14.28-14.28s6.398-14.281 14.28-14.281h250.654c7.883 0 14.281 6.399 14.281 14.281 0 7.882-6.398 14.28-14.281 14.28z" fill="#E1E4E5"/></svg>
\ No newline at end of file
diff --git a/web/src/lib/components/asset-viewer/detail-panel-location.svelte b/web/src/lib/components/asset-viewer/detail-panel-location.svelte
index 42cbefadf1..783eba9c5f 100644
--- a/web/src/lib/components/asset-viewer/detail-panel-location.svelte
+++ b/web/src/lib/components/asset-viewer/detail-panel-location.svelte
@@ -16,18 +16,22 @@
let isShowChangeLocation = $state(false);
- async function handleConfirmChangeLocation(gps: { lng: number; lat: number }) {
+ const onClose = async (point?: { lng: number; lat: number }) => {
isShowChangeLocation = false;
+ if (!point) {
+ return;
+ }
+
try {
asset = await updateAsset({
id: asset.id,
- updateAssetDto: { latitude: gps.lat, longitude: gps.lng },
+ updateAssetDto: { latitude: point.lat, longitude: point.lng },
});
} catch (error) {
handleError(error, $t('errors.unable_to_change_location'));
}
- }
+ };
</script>
{#if asset.exifInfo?.country}
@@ -85,6 +89,6 @@
{#if isShowChangeLocation}
<Portal>
- <ChangeLocation {asset} onConfirm={handleConfirmChangeLocation} onCancel={() => (isShowChangeLocation = false)} />
+ <ChangeLocation {asset} {onClose} />
</Portal>
{/if}
diff --git a/web/src/lib/components/assets/thumbnail/thumbnail.svelte b/web/src/lib/components/assets/thumbnail/thumbnail.svelte
index 9af9287c76..e01f2dc4f6 100644
--- a/web/src/lib/components/assets/thumbnail/thumbnail.svelte
+++ b/web/src/lib/components/assets/thumbnail/thumbnail.svelte
@@ -197,7 +197,7 @@
<div
class={[
'focus-visible:outline-none flex overflow-hidden',
- disabled ? 'bg-gray-300' : 'bg-immich-primary/20 dark:bg-immich-dark-primary/20',
+ disabled ? 'bg-gray-300' : 'bg-primary/30 dark:bg-primary/70',
]}
style:width="{width}px"
style:height="{height}px"
diff --git a/web/src/lib/components/photos-page/actions/change-location-action.svelte b/web/src/lib/components/photos-page/actions/change-location-action.svelte
index 0ad93e5d81..c0f9c6c2a0 100644
--- a/web/src/lib/components/photos-page/actions/change-location-action.svelte
+++ b/web/src/lib/components/photos-page/actions/change-location-action.svelte
@@ -4,10 +4,10 @@
import { getSelectedAssets } from '$lib/utils/asset-utils';
import { handleError } from '$lib/utils/handle-error';
import { updateAssets } from '@immich/sdk';
- import MenuOption from '../../shared-components/context-menu/menu-option.svelte';
- import { getAssetControlContext } from '../asset-select-control-bar.svelte';
import { mdiMapMarkerMultipleOutline } from '@mdi/js';
import { t } from 'svelte-i18n';
+ import MenuOption from '../../shared-components/context-menu/menu-option.svelte';
+ import { getAssetControlContext } from '../asset-select-control-bar.svelte';
interface Props {
menuItem?: boolean;
@@ -18,16 +18,21 @@
let isShowChangeLocation = $state(false);
- async function handleConfirm(point: { lng: number; lat: number }) {
+ async function handleConfirm(point?: { lng: number; lat: number }) {
isShowChangeLocation = false;
+
+ if (!point) {
+ return;
+ }
+
const ids = getSelectedAssets(getOwnedAssets(), $user);
try {
await updateAssets({ assetBulkUpdateDto: { ids, latitude: point.lat, longitude: point.lng } });
+ clearSelect();
} catch (error) {
handleError(error, $t('errors.unable_to_update_location'));
}
- clearSelect();
}
</script>
@@ -39,5 +44,5 @@
/>
{/if}
{#if isShowChangeLocation}
- <ChangeLocation onConfirm={handleConfirm} onCancel={() => (isShowChangeLocation = false)} />
+ <ChangeLocation onClose={handleConfirm} />
{/if}
diff --git a/web/src/lib/components/shared-components/change-location.svelte b/web/src/lib/components/shared-components/change-location.svelte
index 0829adaf4e..831fae02c2 100644
--- a/web/src/lib/components/shared-components/change-location.svelte
+++ b/web/src/lib/components/shared-components/change-location.svelte
@@ -21,11 +21,11 @@
interface Props {
asset?: AssetResponseDto | undefined;
- onCancel: () => void;
- onConfirm: (point: Point) => void;
+ point?: Point;
+ onClose: (point?: Point) => void;
}
- let { asset = undefined, onCancel, onConfirm }: Props = $props();
+ let { asset = undefined, point: initialPoint, onClose }: Props = $props();
let places: PlacesResponseDto[] = $state([]);
let suggestedPlaces: PlacesResponseDto[] = $state([]);
@@ -38,14 +38,20 @@
let previousLocation = get(lastChosenLocation);
- let assetLat = $derived(asset?.exifInfo?.latitude ?? undefined);
- let assetLng = $derived(asset?.exifInfo?.longitude ?? undefined);
+ let assetLat = $derived(initialPoint?.lat ?? asset?.exifInfo?.latitude ?? undefined);
+ let assetLng = $derived(initialPoint?.lng ?? asset?.exifInfo?.longitude ?? undefined);
let mapLat = $derived(assetLat ?? previousLocation?.lat ?? undefined);
let mapLng = $derived(assetLng ?? previousLocation?.lng ?? undefined);
let zoom = $derived(mapLat !== undefined && mapLng !== undefined ? 12.5 : 1);
+ $effect(() => {
+ if (mapElement && initialPoint) {
+ mapElement.addClipMapMarker(initialPoint.lng, initialPoint.lat);
+ }
+ });
+
$effect(() => {
if (places) {
suggestedPlaces = places.slice(0, 5);
@@ -55,14 +61,14 @@
}
});
- let point: Point | null = $state(null);
+ let point: Point | null = $state(initialPoint ?? null);
- const handleConfirm = () => {
- if (point) {
+ const handleConfirm = (confirmed?: boolean) => {
+ if (point && confirmed) {
lastChosenLocation.set(point);
- onConfirm(point);
+ onClose(point);
} else {
- onCancel();
+ onClose();
}
};
@@ -109,6 +115,11 @@
point = { lng: longitude, lat: latitude };
mapElement?.addClipMapMarker(longitude, latitude);
};
+
+ const onUpdate = (lat: number, lng: number) => {
+ point = { lat, lng };
+ mapElement?.addClipMapMarker(lng, lat);
+ };
</script>
<ConfirmModal
@@ -116,7 +127,7 @@
title={$t('change_location')}
icon={mdiMapMarkerMultipleOutline}
size="medium"
- onClose={(confirmed) => (confirmed ? handleConfirm() : onCancel())}
+ onClose={handleConfirm}
>
{#snippet promptSnippet()}
<div class="flex flex-col w-full h-full gap-2">
@@ -197,14 +208,7 @@
</div>
<div class="grid sm:grid-cols-2 gap-4 text-sm text-start mt-4">
- <CoordinatesInput
- lat={point ? point.lat : assetLat}
- lng={point ? point.lng : assetLng}
- onUpdate={(lat, lng) => {
- point = { lat, lng };
- mapElement?.addClipMapMarker(lng, lat);
- }}
- />
+ <CoordinatesInput lat={point ? point.lat : assetLat} lng={point ? point.lng : assetLng} {onUpdate} />
</div>
</div>
{/snippet}
diff --git a/web/src/lib/components/shared-components/date-picker.svelte b/web/src/lib/components/shared-components/date-picker.svelte
new file mode 100644
index 0000000000..67b1ee73a9
--- /dev/null
+++ b/web/src/lib/components/shared-components/date-picker.svelte
@@ -0,0 +1,113 @@
+<script lang="ts">
+ import { Button } from '@immich/ui';
+ import { t } from 'svelte-i18n';
+
+ interface Props {
+ onDateChange: (year?: number, month?: number, day?: number) => Promise<void>;
+ onClearFilters?: () => void;
+ defaultDate?: string;
+ }
+
+ let { onDateChange, onClearFilters, defaultDate }: Props = $props();
+
+ let selectedYear = $state<number | undefined>(undefined);
+ let selectedMonth = $state<number | undefined>(undefined);
+ let selectedDay = $state<number | undefined>(undefined);
+
+ const currentYear = new Date().getFullYear();
+ const yearOptions = Array.from({ length: 30 }, (_, i) => currentYear - i);
+
+ const monthOptions = Array.from({ length: 12 }, (_, i) => ({
+ value: i + 1,
+ label: new Date(2000, i).toLocaleString('default', { month: 'long' }),
+ }));
+
+ const dayOptions = $derived.by(() => {
+ if (!selectedYear || !selectedMonth) {
+ return [];
+ }
+ const daysInMonth = new Date(selectedYear, selectedMonth, 0).getDate();
+ return Array.from({ length: daysInMonth }, (_, i) => i + 1);
+ });
+
+ if (defaultDate) {
+ const [year, month, day] = defaultDate.split('-');
+ selectedYear = Number.parseInt(year);
+ selectedMonth = Number.parseInt(month);
+ selectedDay = Number.parseInt(day);
+ }
+
+ const filterAssetsByDate = async () => {
+ await onDateChange(selectedYear, selectedMonth, selectedDay);
+ };
+
+ const clearFilters = () => {
+ selectedYear = undefined;
+ selectedMonth = undefined;
+ selectedDay = undefined;
+ if (onClearFilters) {
+ onClearFilters();
+ }
+ };
+</script>
+
+<div class="mt-2 mb-2 p-2 rounded-lg">
+ <div class="flex flex-wrap gap-4 items-end w-136">
+ <div class="flex-1 min-w-20">
+ <label for="year-select" class="immich-form-label">
+ {$t('year')}
+ </label>
+ <select
+ id="year-select"
+ bind:value={selectedYear}
+ onchange={filterAssetsByDate}
+ class="text-sm w-full mt-1 px-3 py-1 border border-gray-300 dark:border-gray-600 rounded-lg focus:outline-none focus:ring-1 focus:ring-primary focus:border-primary bg-white dark:bg-gray-700 text-gray-900 dark:text-white"
+ >
+ <option value={undefined}>{$t('year')}</option>
+ {#each yearOptions as year (year)}
+ <option value={year}>{year}</option>
+ {/each}
+ </select>
+ </div>
+
+ <div class="flex-2 min-w-24">
+ <label for="month-select" class="immich-form-label">
+ {$t('month')}
+ </label>
+ <select
+ id="month-select"
+ bind:value={selectedMonth}
+ onchange={filterAssetsByDate}
+ disabled={!selectedYear}
+ class="text-sm w-full mt-1 px-3 py-1 border border-gray-300 dark:border-gray-600 rounded-lg focus:outline-none focus:ring-1 focus:ring-primary focus:border-primary bg-white dark:bg-gray-700 text-gray-900 dark:text-white disabled:opacity-50 disabled:bg-gray-400"
+ >
+ <option value={undefined}>{$t('month')}</option>
+ {#each monthOptions as month (month.value)}
+ <option value={month.value}>{month.label}</option>
+ {/each}
+ </select>
+ </div>
+
+ <div class="flex-1 min-w-16">
+ <label for="day-select" class="immich-form-label">
+ {$t('day')}
+ </label>
+ <select
+ id="day-select"
+ bind:value={selectedDay}
+ onchange={filterAssetsByDate}
+ disabled={!selectedYear || !selectedMonth}
+ class="text-sm w-full mt-1 px-3 py-1 border border-gray-300 dark:border-gray-600 rounded-lg focus:outline-none focus:ring-1 focus:ring-primary focus:border-primary bg-white dark:bg-gray-700 text-gray-900 dark:text-white disabled:opacity-50 disabled:bg-gray-400"
+ >
+ <option value={undefined}>{$t('day')}</option>
+ {#each dayOptions as day (day)}
+ <option value={day}>{day}</option>
+ {/each}
+ </select>
+ </div>
+
+ <div class="flex">
+ <Button size="small" color="secondary" variant="ghost" onclick={clearFilters}>{$t('reset')}</Button>
+ </div>
+ </div>
+</div>
diff --git a/web/src/lib/components/utilities-page/geolocation/geolocation.svelte b/web/src/lib/components/utilities-page/geolocation/geolocation.svelte
new file mode 100644
index 0000000000..0efde6df7e
--- /dev/null
+++ b/web/src/lib/components/utilities-page/geolocation/geolocation.svelte
@@ -0,0 +1,104 @@
+<script lang="ts">
+ import Thumbnail from '$lib/components/assets/thumbnail/thumbnail.svelte';
+ import { AppRoute } from '$lib/constants';
+ import type { AssetInteraction } from '$lib/stores/asset-interaction.svelte';
+ import { toTimelineAsset } from '$lib/utils/timeline-util';
+ import { type AssetResponseDto } from '@immich/sdk';
+ import { t } from 'svelte-i18n';
+
+ interface Props {
+ asset: AssetResponseDto;
+ assetInteraction: AssetInteraction;
+ onSelectAsset: (asset: AssetResponseDto) => void;
+ onMouseEvent: (asset: AssetResponseDto) => void;
+ onLocation: (location: { latitude: number; longitude: number }) => void;
+ }
+
+ let { asset, assetInteraction, onSelectAsset, onMouseEvent, onLocation }: Props = $props();
+
+ let assetData = $derived(
+ JSON.stringify(
+ {
+ originalFileName: asset.originalFileName,
+ localDateTime: asset.localDateTime,
+ make: asset.exifInfo?.make,
+ model: asset.exifInfo?.model,
+ gps: {
+ latitude: asset.exifInfo?.latitude,
+ longitude: asset.exifInfo?.longitude,
+ },
+ location: asset.exifInfo?.city ? `${asset.exifInfo?.country} - ${asset.exifInfo?.city}` : undefined,
+ },
+ null,
+ 2,
+ ),
+ );
+ let boxWidth = $state(300);
+ let timelineAsset = $derived(toTimelineAsset(asset));
+ const hasGps = $derived(!!asset.exifInfo?.latitude && !!asset.exifInfo?.longitude);
+</script>
+
+<div
+ class="w-full aspect-square rounded-xl border-3 transition-colors font-semibold text-xs dark:bg-black bg-gray-200 border-gray-200 dark:border-gray-800"
+ bind:clientWidth={boxWidth}
+ title={assetData}
+>
+ <div class="relative w-full h-full overflow-hidden rounded-lg">
+ <Thumbnail
+ asset={timelineAsset}
+ onClick={() => {
+ if (asset.exifInfo?.latitude && asset.exifInfo?.longitude) {
+ onLocation({ latitude: asset.exifInfo?.latitude, longitude: asset.exifInfo?.longitude });
+ } else {
+ onSelectAsset(asset);
+ }
+ }}
+ onSelect={() => onSelectAsset(asset)}
+ onMouseEvent={() => onMouseEvent(asset)}
+ selected={assetInteraction.hasSelectedAsset(asset.id)}
+ selectionCandidate={assetInteraction.hasSelectionCandidate(asset.id)}
+ thumbnailSize={boxWidth}
+ readonly={hasGps}
+ />
+
+ {#if hasGps}
+ <div class="absolute bottom-1 end-3 px-4 py-1 rounded-xl text-xs transition-colors bg-success text-black">
+ {$t('gps')}
+ </div>
+ {:else}
+ <div class="absolute bottom-1 end-3 px-4 py-1 rounded-xl text-xs transition-colors bg-danger text-light">
+ {$t('gps_missing')}
+ </div>
+ {/if}
+ </div>
+ <div class="text-center mt-4 px-4 text-sm font-semibold truncate" title={asset.originalFileName}>
+ <a href={`${AppRoute.PHOTOS}/${asset.id}`} target="_blank" rel="noopener noreferrer">
+ {asset.originalFileName}
+ </a>
+ </div>
+ <div class="text-center my-3">
+ <p class="px-4 text-xs font-normal truncate text-dark/75">
+ {new Date(asset.localDateTime).toLocaleDateString(undefined, {
+ year: 'numeric',
+ month: 'short',
+ day: 'numeric',
+ })}
+ </p>
+ <p class="px-4 text-xs font-normal truncate text-dark/75">
+ {new Date(asset.localDateTime).toLocaleTimeString(undefined, {
+ hour: '2-digit',
+ minute: '2-digit',
+ second: '2-digit',
+ timeZone: 'UTC',
+ })}
+ </p>
+ {#if hasGps}
+ <p class="text-primary mt-2 text-xs font-normal px-4 text-center truncate">
+ {asset.exifInfo?.country}
+ </p>
+ <p class="text-primary text-xs font-normal px-4 text-center truncate">
+ {asset.exifInfo?.city}
+ </p>
+ {/if}
+ </div>
+</div>
diff --git a/web/src/lib/components/utilities-page/utilities-menu.svelte b/web/src/lib/components/utilities-page/utilities-menu.svelte
index 5484ce4ea0..97e205fcd1 100644
--- a/web/src/lib/components/utilities-page/utilities-menu.svelte
+++ b/web/src/lib/components/utilities-page/utilities-menu.svelte
@@ -1,29 +1,23 @@
<script lang="ts">
import Icon from '$lib/components/elements/icon.svelte';
import { AppRoute } from '$lib/constants';
- import { mdiContentDuplicate, mdiImageSizeSelectLarge } from '@mdi/js';
+ import { mdiContentDuplicate, mdiCrosshairsGps, mdiImageSizeSelectLarge } from '@mdi/js';
import { t } from 'svelte-i18n';
+
+ const links = [
+ { href: AppRoute.DUPLICATES, icon: mdiContentDuplicate, label: $t('review_duplicates') },
+ { href: AppRoute.LARGE_FILES, icon: mdiImageSizeSelectLarge, label: $t('review_large_files') },
+ { href: AppRoute.GEOLOCATION, icon: mdiCrosshairsGps, label: $t('manage_geolocation') },
+ ];
</script>
<div class="border border-gray-300 dark:border-immich-dark-gray rounded-3xl pt-1 pb-6 dark:text-white">
<p class="text-xs font-medium p-4">{$t('organize_your_library').toUpperCase()}</p>
- <a
- href={AppRoute.DUPLICATES}
- class="w-full hover:bg-gray-100 dark:hover:bg-immich-dark-gray flex items-center gap-4 p-4"
- >
- <span
- ><Icon path={mdiContentDuplicate} class="text-immich-primary dark:text-immich-dark-primary" size="24" />
- </span>
- {$t('review_duplicates')}
- </a>
- <a
- href={AppRoute.LARGE_FILES}
- class="w-full hover:bg-gray-100 dark:hover:bg-immich-dark-gray flex items-center gap-4 p-4"
- >
- <span
- ><Icon path={mdiImageSizeSelectLarge} class="text-immich-primary dark:text-immich-dark-primary" size="24" />
- </span>
- {$t('review_large_files')}
- </a>
+ {#each links as link (link.href)}
+ <a href={link.href} class="w-full hover:bg-gray-100 dark:hover:bg-immich-dark-gray flex items-center gap-4 p-4">
+ <span><Icon path={link.icon} class="text-immich-primary dark:text-immich-dark-primary" size="24" /> </span>
+ {link.label}
+ </a>
+ {/each}
</div>
diff --git a/web/src/lib/constants.ts b/web/src/lib/constants.ts
index f2de6d5deb..a4cdb656b4 100644
--- a/web/src/lib/constants.ts
+++ b/web/src/lib/constants.ts
@@ -52,6 +52,7 @@ export enum AppRoute {
UTILITIES = '/utilities',
DUPLICATES = '/utilities/duplicates',
LARGE_FILES = '/utilities/large-files',
+ GEOLOCATION = '/utilities/geolocation',
FOLDERS = '/folders',
TAGS = '/tags',
diff --git a/web/src/lib/modals/GeolocationUpdateConfirmModal.svelte b/web/src/lib/modals/GeolocationUpdateConfirmModal.svelte
new file mode 100644
index 0000000000..7bad707447
--- /dev/null
+++ b/web/src/lib/modals/GeolocationUpdateConfirmModal.svelte
@@ -0,0 +1,33 @@
+<script lang="ts">
+ import { Button, HStack, Modal, ModalBody, ModalFooter } from '@immich/ui';
+ import { t } from 'svelte-i18n';
+
+ interface Props {
+ location: { latitude: number | undefined; longitude: number | undefined };
+ assetCount: number;
+ onClose: (confirm?: true) => void;
+ }
+
+ let { location, assetCount, onClose }: Props = $props();
+</script>
+
+<Modal title={$t('confirm')} size="small" {onClose}>
+ <ModalBody>
+ <p>
+ {$t('update_location_action_prompt', {
+ values: {
+ count: assetCount,
+ },
+ })}
+ </p>
+
+ <p>- {$t('latitude')}: {location.latitude}</p>
+ <p>- {$t('longitude')}: {location.longitude}</p>
+ </ModalBody>
+ <ModalFooter>
+ <HStack fullWidth>
+ <Button shape="round" color="secondary" fullWidth onclick={() => onClose()}>{$t('cancel')}</Button>
+ <Button shape="round" type="submit" fullWidth onclick={() => onClose(true)}>{$t('confirm')}</Button>
+ </HStack>
+ </ModalFooter>
+</Modal>
diff --git a/web/src/lib/utils/date-time.spec.ts b/web/src/lib/utils/date-time.spec.ts
index d96bef45d6..bca57863a9 100644
--- a/web/src/lib/utils/date-time.spec.ts
+++ b/web/src/lib/utils/date-time.spec.ts
@@ -1,5 +1,5 @@
import { writable } from 'svelte/store';
-import { getAlbumDateRange, timeToSeconds } from './date-time';
+import { buildDateRangeFromYearMonthAndDay, getAlbumDateRange, timeToSeconds } from './date-time';
describe('converting time to seconds', () => {
it('parses hh:mm:ss correctly', () => {
@@ -75,3 +75,24 @@ describe('getAlbumDate', () => {
expect(getAlbumDateRange({ startDate: '2021-01-01T00:00:00+05:00' })).toEqual('Jan 1, 2021');
});
});
+
+describe('buildDateRangeFromYearMonthAndDay', () => {
+ it('should build correct date range for a specific day', () => {
+ const result = buildDateRangeFromYearMonthAndDay(2023, 1, 8);
+
+ expect(result.from).toContain('2023-01-08T00:00:00');
+ expect(result.to).toContain('2023-01-09T00:00:00');
+ });
+
+ it('should build correct date range for a month', () => {
+ const result = buildDateRangeFromYearMonthAndDay(2023, 2);
+ expect(result.from).toContain('2023-02-01T00:00:00');
+ expect(result.to).toContain('2023-03-01T00:00:00');
+ });
+
+ it('should build correct date range for a year', () => {
+ const result = buildDateRangeFromYearMonthAndDay(2023);
+ expect(result.from).toContain('2023-01-01T00:00:00');
+ expect(result.to).toContain('2024-01-01T00:00:00');
+ });
+});
diff --git a/web/src/lib/utils/date-time.ts b/web/src/lib/utils/date-time.ts
index 8a50df9cfe..bf87d041cc 100644
--- a/web/src/lib/utils/date-time.ts
+++ b/web/src/lib/utils/date-time.ts
@@ -85,3 +85,33 @@ export const getAlbumDateRange = (album: { startDate?: string; endDate?: string
*/
export const asLocalTimeISO = (date: DateTime<true>) =>
(date.setZone('utc', { keepLocalTime: true }) as DateTime<true>).toISO();
+
+/**
+ * Creates a date range for filtering assets based on year, month, and day parameters
+ */
+export const buildDateRangeFromYearMonthAndDay = (year: number, month?: number, day?: number) => {
+ const baseDate = DateTime.fromObject({
+ year,
+ month: month || 1,
+ day: day || 1,
+ });
+
+ let from: DateTime;
+ let to: DateTime;
+
+ if (day) {
+ from = baseDate.startOf('day');
+ to = baseDate.plus({ days: 1 }).startOf('day');
+ } else if (month) {
+ from = baseDate.startOf('month');
+ to = baseDate.plus({ months: 1 }).startOf('month');
+ } else {
+ from = baseDate.startOf('year');
+ to = baseDate.plus({ years: 1 }).startOf('year');
+ }
+
+ return {
+ from: from.toISO() || undefined,
+ to: to.toISO() || undefined,
+ };
+};
diff --git a/web/src/lib/utils/navigation.ts b/web/src/lib/utils/navigation.ts
index 642c8165df..c3fe051f12 100644
--- a/web/src/lib/utils/navigation.ts
+++ b/web/src/lib/utils/navigation.ts
@@ -145,3 +145,16 @@ export const clearQueryParam = async (queryParam: string, url: URL) => {
await goto(url, { keepFocus: true });
}
};
+
+export const getQueryValue = (queryKey: string) => {
+ const url = globalThis.location.href;
+ const urlObject = new URL(url);
+ return urlObject.searchParams.get(queryKey);
+};
+
+export const setQueryValue = async (queryKey: string, queryValue: string) => {
+ const url = globalThis.location.href;
+ const urlObject = new URL(url);
+ urlObject.searchParams.set(queryKey, queryValue);
+ await goto(urlObject, { keepFocus: true });
+};
diff --git a/web/src/lib/utils/string-utils.ts b/web/src/lib/utils/string-utils.ts
index 0170c34737..3795af40c7 100644
--- a/web/src/lib/utils/string-utils.ts
+++ b/web/src/lib/utils/string-utils.ts
@@ -5,3 +5,13 @@ export const removeAccents = (str: string) => {
export const normalizeSearchString = (str: string) => {
return removeAccents(str.toLocaleLowerCase());
};
+
+export const buildDateString = (year: number, month?: number, day?: number) => {
+ return [
+ year.toString(),
+ month && !Number.isNaN(month) ? month.toString() : undefined,
+ day && !Number.isNaN(day) ? day.toString() : undefined,
+ ]
+ .filter((date) => date !== undefined)
+ .join('-');
+};
diff --git a/web/src/routes/(user)/utilities/geolocation/+page.svelte b/web/src/routes/(user)/utilities/geolocation/+page.svelte
new file mode 100644
index 0000000000..c251146b45
--- /dev/null
+++ b/web/src/routes/(user)/utilities/geolocation/+page.svelte
@@ -0,0 +1,321 @@
+<script lang="ts">
+ import emptyUrl from '$lib/assets/empty-5.svg';
+ import UserPageLayout from '$lib/components/layouts/user-page-layout.svelte';
+ import ChangeLocation from '$lib/components/shared-components/change-location.svelte';
+ import DatePicker from '$lib/components/shared-components/date-picker.svelte';
+ import EmptyPlaceholder from '$lib/components/shared-components/empty-placeholder.svelte';
+ import Geolocation from '$lib/components/utilities-page/geolocation/geolocation.svelte';
+ import GeolocationUpdateConfirmModal from '$lib/modals/GeolocationUpdateConfirmModal.svelte';
+ import { AssetInteraction } from '$lib/stores/asset-interaction.svelte';
+ import { cancelMultiselect } from '$lib/utils/asset-utils';
+ import { buildDateRangeFromYearMonthAndDay } from '$lib/utils/date-time';
+ import { setQueryValue } from '$lib/utils/navigation';
+ import { buildDateString } from '$lib/utils/string-utils';
+ import { toTimelineAsset } from '$lib/utils/timeline-util';
+ import { searchAssets, updateAssets, type AssetResponseDto } from '@immich/sdk';
+ import { Button, LoadingSpinner, modalManager, Text } from '@immich/ui';
+ import {
+ mdiMapMarkerMultipleOutline,
+ mdiMapMarkerOff,
+ mdiPencilOutline,
+ mdiSelectAll,
+ mdiSelectRemove,
+ } from '@mdi/js';
+ import { t } from 'svelte-i18n';
+ import type { PageData } from './$types';
+
+ interface Props {
+ data: PageData;
+ }
+
+ let { data }: Props = $props();
+ let partialDate = $state<string | null>(data.partialDate);
+ let isLoading = $state(false);
+ let assets = $state<AssetResponseDto[]>([]);
+ let shiftKeyIsDown = $state(false);
+ let assetInteraction = new AssetInteraction();
+ let location = $state<{ latitude: number; longitude: number }>({ latitude: 0, longitude: 0 });
+ let assetsToDisplay = $state(500);
+ let takenRange = $state<{ takenAfter?: string; takenBefore?: string } | null>(null);
+ let locationUpdated = $state(false);
+ let showOnlyAssetsWithoutLocation = $state(false);
+
+ // Filtered assets based on location filter
+ let filteredAssets = $derived(
+ showOnlyAssetsWithoutLocation
+ ? assets.filter((asset) => !asset.exifInfo?.latitude || !asset.exifInfo?.longitude)
+ : assets,
+ );
+
+ void init();
+
+ async function init() {
+ if (partialDate) {
+ const [year, month, day] = partialDate.split('-');
+ const { from: takenAfter, to: takenBefore } = buildDateRangeFromYearMonthAndDay(
+ Number.parseInt(year),
+ Number.parseInt(month),
+ Number.parseInt(day),
+ );
+ takenRange = { takenAfter, takenBefore };
+ const dateString = buildDateString(Number.parseInt(year), Number.parseInt(month), Number.parseInt(day));
+ await setQueryValue('date', dateString);
+ await loadAssets();
+ }
+ }
+
+ const loadAssets = async () => {
+ if (takenRange) {
+ isLoading = true;
+
+ const searchResult = await searchAssets({
+ metadataSearchDto: {
+ withExif: true,
+ takenAfter: takenRange.takenAfter,
+ takenBefore: takenRange.takenBefore,
+ size: assetsToDisplay,
+ },
+ });
+
+ assets = searchResult.assets.items;
+ isLoading = false;
+ }
+ };
+
+ const handleDateChange = async (selectedYear?: number, selectedMonth?: number, selectedDay?: number) => {
+ partialDate = selectedYear ? buildDateString(selectedYear, selectedMonth, selectedDay) : null;
+ if (!selectedYear) {
+ assets = [];
+ return;
+ }
+ try {
+ const { from: takenAfter, to: takenBefore } = buildDateRangeFromYearMonthAndDay(
+ selectedYear,
+ selectedMonth,
+ selectedDay,
+ );
+ const dateString = buildDateString(selectedYear, selectedMonth, selectedDay);
+ takenRange = { takenAfter, takenBefore };
+ await setQueryValue('date', dateString);
+ await loadAssets();
+ } catch (error) {
+ console.error('Failed to filter assets by date:', error);
+ }
+ };
+
+ const handleClearFilters = async () => {
+ assets = [];
+ assetInteraction.clearMultiselect();
+ await setQueryValue('date', '');
+ };
+
+ const toggleLocationFilter = () => {
+ showOnlyAssetsWithoutLocation = !showOnlyAssetsWithoutLocation;
+ };
+
+ const handleUpdate = async () => {
+ const confirmed = await modalManager.show(GeolocationUpdateConfirmModal, {
+ location: location ?? { latitude: 0, longitude: 0 },
+ assetCount: assetInteraction.selectedAssets.length,
+ });
+
+ if (!confirmed) {
+ return;
+ }
+
+ await updateAssets({
+ assetBulkUpdateDto: {
+ ids: assetInteraction.selectedAssets.map((asset) => asset.id),
+ latitude: location?.latitude ?? undefined,
+ longitude: location?.longitude ?? undefined,
+ },
+ });
+
+ void loadAssets();
+ handleDeselectAll();
+ };
+
+ // Assets selection handlers
+ // TODO: might be refactored to use the same logic as in asset-grid.svelte and gallery-viewer.svelte
+ const handleSelectAssets = (asset: AssetResponseDto) => {
+ const timelineAsset = toTimelineAsset(asset);
+ const deselect = assetInteraction.hasSelectedAsset(asset.id);
+
+ if (deselect) {
+ for (const candidate of assetInteraction.assetSelectionCandidates) {
+ assetInteraction.removeAssetFromMultiselectGroup(candidate.id);
+ }
+ assetInteraction.removeAssetFromMultiselectGroup(asset.id);
+ } else {
+ for (const candidate of assetInteraction.assetSelectionCandidates) {
+ assetInteraction.selectAsset(candidate);
+ }
+ assetInteraction.selectAsset(timelineAsset);
+ }
+
+ assetInteraction.clearAssetSelectionCandidates();
+ assetInteraction.setAssetSelectionStart(deselect ? null : timelineAsset);
+ };
+
+ const selectAssetCandidates = (endAsset: AssetResponseDto) => {
+ if (!shiftKeyIsDown) {
+ return;
+ }
+
+ const startAsset = assetInteraction.assetSelectionStart;
+ if (!startAsset) {
+ return;
+ }
+
+ let start = assets.findIndex((a) => a.id === startAsset.id);
+ let end = assets.findIndex((a) => a.id === endAsset.id);
+
+ if (start > end) {
+ [start, end] = [end, start];
+ }
+
+ assetInteraction.setAssetSelectionCandidates(assets.slice(start, end + 1).map((a) => toTimelineAsset(a)));
+ };
+ const assetMouseEventHandler = (asset: AssetResponseDto) => {
+ if (assetInteraction.selectionActive) {
+ selectAssetCandidates(asset);
+ }
+ };
+ // Keyboard handlers
+ const onKeyDown = (event: KeyboardEvent) => {
+ if (event.key === 'Shift') {
+ event.preventDefault();
+ shiftKeyIsDown = true;
+ }
+ if (event.key === 'Escape' && assetInteraction.selectionActive) {
+ cancelMultiselect(assetInteraction);
+ }
+ };
+ const onKeyUp = (event: KeyboardEvent) => {
+ if (event.key === 'Shift') {
+ event.preventDefault();
+ shiftKeyIsDown = false;
+ }
+ };
+ const handleSelectAll = () => {
+ assetInteraction.selectAssets(filteredAssets.map((a) => toTimelineAsset(a)));
+ };
+ const handleDeselectAll = () => {
+ cancelMultiselect(assetInteraction);
+ };
+
+ const handlePickOnMap = async () => {
+ const point = await modalManager.show(ChangeLocation, {
+ point: {
+ lat: location.latitude,
+ lng: location.longitude,
+ },
+ });
+ if (!point) {
+ return;
+ }
+
+ location = { latitude: point.lat, longitude: point.lng };
+ };
+</script>
+
+<svelte:document onkeydown={onKeyDown} onkeyup={onKeyUp} />
+
+<UserPageLayout title={data.meta.title} scrollbar={true}>
+ {#snippet buttons()}
+ <div class="flex gap-2 justify-end place-items-center">
+ {#if filteredAssets.length > 0}
+ <Text class="hidden md:block text-xs mr-4 text-dark/50">{$t('geolocation_instruction_location')}</Text>
+ {/if}
+ <div class="border flex place-items-center place-content-center px-2 py-1 bg-primary/10 rounded-2xl">
+ <p class="text-xs text-gray-500 font-mono mr-5 ml-2 uppercase">{$t('selected_gps_coordinates')}</p>
+ <Text
+ title="latitude, longitude"
+ class="rounded-3xl font-mono text-sm text-primary px-2 py-1 transition-all duration-100 ease-in-out {locationUpdated
+ ? 'bg-primary/90 text-light font-semibold scale-105'
+ : ''}">{location.latitude.toFixed(3)}, {location.longitude.toFixed(3)}</Text
+ >
+ </div>
+
+ <Button size="small" color="secondary" variant="ghost" leadingIcon={mdiPencilOutline} onclick={handlePickOnMap}
+ >{$t('location_picker_choose_on_map')}</Button
+ >
+ <Button
+ leadingIcon={mdiMapMarkerMultipleOutline}
+ size="small"
+ color="primary"
+ disabled={assetInteraction.selectedAssets.length === 0}
+ onclick={() => handleUpdate()}
+ >
+ {$t('apply_count', { values: { count: assetInteraction.selectedAssets.length } })}
+ </Button>
+ </div>
+ {/snippet}
+
+ <div class="bg-light flex items-center justify-between flex-wrap border-b">
+ <div class="flex gap-2 items-center">
+ <DatePicker
+ onDateChange={handleDateChange}
+ onClearFilters={handleClearFilters}
+ defaultDate={partialDate || undefined}
+ />
+ </div>
+
+ <div class="flex gap-2">
+ <Button
+ size="small"
+ leadingIcon={showOnlyAssetsWithoutLocation ? mdiMapMarkerMultipleOutline : mdiMapMarkerOff}
+ color={showOnlyAssetsWithoutLocation ? 'primary' : 'secondary'}
+ variant="ghost"
+ onclick={toggleLocationFilter}
+ >
+ {showOnlyAssetsWithoutLocation ? $t('show_all_assets') : $t('show_assets_without_location')}
+ </Button>
+ <Button
+ leadingIcon={assetInteraction.selectionActive ? mdiSelectRemove : mdiSelectAll}
+ size="small"
+ color="secondary"
+ variant="ghost"
+ onclick={assetInteraction.selectionActive ? handleDeselectAll : handleSelectAll}
+ >
+ {assetInteraction.selectionActive ? $t('unselect_all') : $t('select_all')}
+ </Button>
+ </div>
+ </div>
+
+ {#if isLoading}
+ <div class="h-full w-full flex items-center justify-center">
+ <LoadingSpinner size="giant" />
+ </div>
+ {/if}
+
+ {#if filteredAssets && filteredAssets.length > 0}
+ <div class="grid gap-4 grid-cols-2 sm:grid-cols-3 lg:grid-cols-4 xl:grid-cols-6 mt-4">
+ {#each filteredAssets as asset (asset.id)}
+ <Geolocation
+ {asset}
+ {assetInteraction}
+ onSelectAsset={(asset) => handleSelectAssets(asset)}
+ onMouseEvent={(asset) => assetMouseEventHandler(asset)}
+ onLocation={(selected) => {
+ location = selected;
+ locationUpdated = true;
+ setTimeout(() => {
+ locationUpdated = false;
+ }, 1000);
+ }}
+ />
+ {/each}
+ </div>
+ {:else}
+ <div class="w-full">
+ {#if partialDate == null}
+ <EmptyPlaceholder text={$t('geolocation_instruction_no_date')} src={emptyUrl} />
+ {:else if showOnlyAssetsWithoutLocation && filteredAssets.length === 0 && assets.length > 0}
+ <EmptyPlaceholder text={$t('geolocation_instruction_all_have_location')} src={emptyUrl} />
+ {:else}
+ <EmptyPlaceholder text={$t('geolocation_instruction_no_photos')} src={emptyUrl} />
+ {/if}
+ </div>
+ {/if}
+</UserPageLayout>
diff --git a/web/src/routes/(user)/utilities/geolocation/+page.ts b/web/src/routes/(user)/utilities/geolocation/+page.ts
new file mode 100644
index 0000000000..f5c227a7ef
--- /dev/null
+++ b/web/src/routes/(user)/utilities/geolocation/+page.ts
@@ -0,0 +1,17 @@
+import { authenticate } from '$lib/utils/auth';
+import { getFormatter } from '$lib/utils/i18n';
+import { getQueryValue } from '$lib/utils/navigation';
+import type { PageLoad } from './$types';
+
+export const load = (async ({ url }) => {
+ await authenticate(url);
+ const partialDate = getQueryValue('date');
+ const $t = await getFormatter();
+
+ return {
+ partialDate,
+ meta: {
+ title: $t('manage_geolocation'),
+ },
+ };
+}) satisfies PageLoad;