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

3.7 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Remove metadados EXIF, GPS, ICC e XMP de imagens para privacidade e arquivos menores.	07f61cdb2c26	human	1183378e41c2

Remover Metadados da Imagem

Remove metadados EXIF, GPS, perfis de cor ICC e metadados XMP de imagens. Útil para privacidade (remoção de coordenadas GPS, informações da câmera) e para reduzir o tamanho do arquivo.

Endpoints da API

Remover Metadados

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

Processa a imagem e retorna uma versão limpa com os metadados selecionados removidos.

Inspecionar Metadados

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

Retorna os metadados analisados como JSON sem modificar a imagem. Útil para pré-visualizar quais metadados existem antes de removê-los.

Parâmetros (Remoção)

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
stripExif	boolean	Não	`false`	Remove dados EXIF (configurações da câmera, datas etc.)
stripGps	boolean	Não	`false`	Remove apenas os dados de GPS/localização
stripIcc	boolean	Não	`false`	Remove o perfil de cor ICC
stripXmp	boolean	Não	`false`	Remove metadados XMP (Adobe, IPTC)
stripAll	boolean	Não	`true`	Remove todos os metadados de uma vez

Quando stripAll é true, ele sobrepõe as flags individuais e remove tudo.

Exemplo de Requisição

Remover todos os metadados:

curl -X POST http://localhost:1349/api/v1/tools/image/strip-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"stripAll": true}'

Remover apenas os dados de GPS (mantendo as informações da câmera e o perfil de cor):

curl -X POST http://localhost:1349/api/v1/tools/image/strip-metadata \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"stripAll": false, "stripGps": true}'

Inspecionar metadados sem modificar:

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

Exemplo de Resposta (Remoção)

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

Exemplo de Resposta (Inspeção)

{
  "filename": "photo.jpg",
  "fileSize": 2450000,
  "exif": {
    "Make": "Canon",
    "Model": "EOS R5",
    "DateTimeOriginal": "2024:03:15 14:30:00",
    "ExposureTime": "1/250",
    "FNumber": 2.8,
    "ISO": 400
  },
  "gps": {
    "GPSLatitudeRef": "N",
    "GPSLatitude": [37, 46, 30],
    "_latitude": 37.775,
    "_longitude": -122.4183
  },
  "icc": {
    "Profile Size": "3144 bytes",
    "Color Space": "RGB",
    "Description": "sRGB IEC61966-2.1"
  },
  "xmp": {
    "CreatorTool": "Adobe Photoshop 25.0"
  }
}

Notas

A imagem é recodificada em seu formato original após a remoção. JPEG usa mozjpeg com qualidade 90, PNG usa nível de compressão 9, WebP usa qualidade 85.
Remover perfis ICC pode causar mudanças sutis de cor se a imagem estiver marcada com um perfil não sRGB. Use stripIcc: false se a precisão de cor for importante.
O endpoint de inspeção analisa as coordenadas GPS em valores decimais de latitude/longitude (prefixados com underscore) para maior conveniência.
Formatos de entrada suportados: JPEG, PNG, WebP, AVIF, TIFF, GIF.

3.7 KiB Raw Blame History