mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520 )

Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.

2026-07-15 21:55:51 +08:00

4.4 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Redigera EXIF-, IPTC-, GPS- och XMP-metadatafält i bilder utan att koda om pixlarna.	9271d3d8f278	human	e19a6cf535ce

Redigera bildmetadata

Redigera bildmetadatafält inklusive EXIF, IPTC, GPS-koordinater, datum och nyckelord. Använder ExifTool i bakgrunden, så metadata skrivs på plats utan att koda om pixlar, vilket bevarar full bildkvalitet.

API-slutpunkter

Redigera metadata

POST /api/v1/tools/image/edit-metadata

Skriver metadatafält till bilden och returnerar den ändrade filen.

Inspektera metadata

POST /api/v1/tools/image/edit-metadata/inspect

Returnerar den fullständiga metadatan från bilden via ExifTool som JSON. Ändrar inte bilden.

Parametrar (Redigera)

Parameter	Typ	Obligatorisk	Standard	Beskrivning
title	string	Nej	-	Bildtitel (XMP/EXIF)
author	string	Nej	-	Författarnamn
artist	string	Nej	-	Konstnärsnamn (EXIF Artist-tagg)
copyright	string	Nej	-	Upphovsrättsmeddelande
imageDescription	string	Nej	-	Bildbeskrivning (EXIF)
software	string	Nej	-	Programvarutagg
dateTime	string	Nej	-	EXIF DateTime-värde
dateTimeOriginal	string	Nej	-	EXIF DateTimeOriginal-värde
setAllDates	string	Nej	-	Ange alla datumfält samtidigt
dateShift	string	Nej	-	Förskjut alla datum med en offset (format: `+HH:MM` eller `-HH:MM`)
clearGps	boolean	Nej	`false`	Ta bort all GPS-data
gpsLatitude	number	Nej	-	Ange GPS-latitud (-90 till 90)
gpsLongitude	number	Nej	-	Ange GPS-longitud (-180 till 180)
gpsAltitude	number	Nej	-	Ange GPS-höjd i meter
keywords	string[]	Nej	-	Nyckelord/taggar att lägga till eller ange
keywordsMode	string	Nej	`"add"`	Hur nyckelord hanteras: `add` (lägg till) eller `set` (ersätt)
fieldsToRemove	string[]	Nej	`[]`	Lista över specifika metadatafältnamn att ta bort
iptcTitle	string	Nej	-	IPTC Object Name
iptcHeadline	string	Nej	-	IPTC Headline
iptcCity	string	Nej	-	IPTC City
iptcState	string	Nej	-	IPTC Province/State
iptcCountry	string	Nej	-	IPTC Country

Exempelbegäran

Ange författare och upphovsrätt:

curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"author": "Jane Smith", "copyright": "2024 Jane Smith"}'

Ange GPS-koordinater:

curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"gpsLatitude": 48.8566, "gpsLongitude": 2.3522, "gpsAltitude": 35}'

Ta bort GPS och lägg till nyckelord:

curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"clearGps": true, "keywords": ["landscape", "sunset"], "keywordsMode": "add"}'

Inspektera metadata:

curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata/inspect \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg"

Exempelsvar (Redigera)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 2452000
}

Anteckningar

Detta verktyg kräver att ExifTool är installerat på servern. Det ingår i Docker-avbildningen.
Metadata skrivs på plats, så ingen omkodning av pixlar sker. Ändringen av filstorleken är minimal (bara metadatabyten).
Parametern dateShift förskjuter alla datumfält med den angivna offseten, vilket är användbart för att korrigera tidszonsfel (t.ex. +02:00 eller -05:30).
Om inga ändringar begärs (alla parametrar utelämnade eller tomma) returneras originalfilen oförändrad.
Format som stöds: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC/HEIF.
För format som inte kan förhandsgranskas i webbläsaren (HEIF, TIFF) inkluderar svaret ett previewUrl-fält med en WebP-förhandsgranskning.

4.4 KiB Raw Blame History