Files

T

Benoit Marty c88edc9621 Notification settings: pick custom sounds for messages and call ringtones (#6897 )

* Notification settings: pick custom sounds for messages and call ringtones (#6702)

* Feature: add notification sound settings for messages and calls

* Add sound not available banner, accessibility checks

* Fix build and Konsist convention violations

- libraries:preferences:api now uses io.element.android-compose-library
  so NotificationSound's @Immutable annotation can resolve, matching the
  pattern in libraries:matrix:api.
- Rename SoundUnavailableBannerStateProvider to
  NotificationSoundUnavailableStateProvider so the class name contains
  the parameter type as required by KonsistClassNameTest.

* Suppress LargeClass on RoomListPresenterTest

The three new sound-unavailable tests pushed the class past Detekt's
default LargeClass threshold. Matches the suppression pattern already
used on five presenter test classes under features/messages/impl/test.

* NotificationSettingsView: guard ringtone-picker launchers in inspection mode

rememberLauncherForActivityResult requires a LocalActivityResultRegistryOwner,
which Paparazzi-driven preview snapshot tests don't provide, causing
NotificationSettingsViewPreview to throw IllegalStateException for every
preview parameter. Extract the click handlers into a helper that returns a
no-op when LocalInspectionMode.current is true; the runtime path is unchanged.

* Handle unresolved notification sounds mid session

* Quality checks, refactor mid session error ui

* Suppress detekt LargeClass on NotificationSettingsPresenterTest

* Remove notification sound resilience layer, replace with file copy

* Reselect element sound option, code cleanup

* Add element fade notification sound option

* Fix new file headers

* Revert to flowOf(Unit) for announcement service

* Add ringtone picker dialog to match message selector

* Update strings in conjunction with ios

* Update test to reflect new string

* Sync strings.

* Update screenshots

* Fix test

* Remove not properly located translations.
This will be fixed in the next String sync.

* Fix test on CI

---------

Co-authored-by: Jenna Vassar <jenna.vassar@toptal.com>
Co-authored-by: ElementBot <android@element.io>

2026-05-28 16:54:12 +02:00

checkForbiddenTerms.py

2026-04-13 11:16:05 +02:00

config.json

Notification settings: pick custom sounds for messages and call ringtones (#6897 )

2026-05-28 16:54:12 +02:00

downloadStrings.sh

2025-11-10 11:05:05 +01:00

formatXmlResourcesFile.py

2025-11-10 11:05:05 +01:00

generateLocalazyConfig.py

2025-11-10 11:05:05 +01:00

importSupportedLocalesFromLocalazy.py

2025-11-10 11:05:05 +01:00

README.md

Update Localazy readme.

2023-08-31 14:17:14 +01:00

README.md

Localazy

Localazy is used to host the source strings and their translations.

Localazy project
- Key naming rules
  - Special suffixes
  - Placeholders
CLI Installation
Download translations
Add translations to a specific module

Localazy project

To add new strings, or to translate existing strings, go the the Localazy project: https://localazy.com/p/element. Please follow the key naming rules (see below).

Never edit manually the files localazy.xml or translations.xml!.

Key naming rules

For code clarity and in order to download strings to the correct module, here are some naming rules to follow as much as possible:

Keys for common strings, i.e. strings that can be used at multiple places must start by action. if this is a verb, or common. if not;
Keys for common accessibility strings must start by a11y.. Example: a11y.hide_password;
Keys for common strings should be named to match the string. Example: action.copy_link for the string Copy link;
When creating common strings, make sure to enable "Use dot (.) to create nested keys";
Keys for strings used in a single screen must start with screen_ followed by the screen name, followed by a free name. Example: screen_onboarding_welcome_title;
Keys can have _title or _subtitle suffixes. Example: screen_onboarding_welcome_title, screen_change_server_subtitle;
For dialogs, keys can have _dialog_title, _dialog_content, and _dialog_submit suffixes. Example: screen_signout_confirmation_dialog_title, screen_signout_confirmation_dialog_content, screen_signout_confirmation_dialog_submit;
a11y. pattern can be used for strings that are only used for accessibility. Example: a11y.hide_password, screen_roomlist_a11y_create_message;
Strings for error message can start by error_, or contain _error_ if used in a specific screen only. Example: error_some_messages_have_not_been_sent, screen_change_server_error_invalid_homeserver;

Note: those rules applies for strings and for plurals.

Special suffixes

if a key is suffixed by _ios, it will not be imported in the Android project;
if a key is suffixed by _android, it will not be imported in the iOS project.

So feel free to use those suffixes when necessary for instance when the string content is referring to something related to Android only, or iOS only.

Placeholders

Placeholders should have the form %1$s, %1$d, etc.. Please use numbered placeholders. Note that Localazy will take care of converting the placeholder to Android (-> %1$s) and iOS specific format (-> %1$@). Ideally add a comment on Localazy to explain with what the placeholder(s) will be replaced at runtime.

CLI Installation

To install the Localazy client, follow the instructions from here.

Download translations

In the root folder of the project, run:

./tools/localazy/downloadStrings.sh

It will update all the localazy.xml resource files. In case of merge conflicts, just erase the files and download again using the script.

To also include the translations, i.e. the translations.xml files, add --all argument:

./tools/localazy/downloadStrings.sh --all

Add translations to a specific module

Edit the file config.json to add a new module, or add a new item in includeRegex arrays, then run the script again to see the effect.

generateLocalazyConfig.py is the Python script that convert config.json to a localazy configuration file. Generally you should not edit this file.