blakeblackshear / blakeblackshear/frigate

Add i18n Support to Backend

Open
#17,962 7 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement planned
Dominant language
TypeScript
Stars
36k
Forks
3.6k
Avg merge
8h 57m
Merged PRs (30d)
118

Description

Describe what you are trying to accomplish and why in non technical terms
Currently, certain system messages lack multilingual support, including:

  • Configuration file modification responses
  • Error messages from functional modules
  • Labels in GenAI requests

This creates usability barriers for non-English speaking users.

Describe the solution you'd like

For frontend-bound messages:

  • APIs should return:
{
  "//": "↓↓ value: '{{camera}} load failed! Please check config.' ↓↓",
  "i18n_key": "camera_load_failed",
  "params": {"camera": "Camera Name"},
  "//": "Original message",
  "message": "Camera Name load failed! Please check config."
}

Regarding GenAI label localization:
The labels currently sent to AI service providers are monolingual, which may impact result accuracy. We propose having the backend directly fetch localized labels from i18n's objects.json language files to achieve proper multilingual support.

Describe alternatives you've considered
None

Additional context
None

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by mapping the backend responses for configuration-file modifications and functional-module errors, then inspect the GenAI request path and the i18n objects.json language files. Define how localized labels and structured message fields should be returned across these areas; done means the affected messages and GenAI labels support the intended multilingual behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
api, backend, localization
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.