[Android] Network: clarify server addresses and location errors
majklvi
git at videolan.org
Thu Jul 16 09:34:49 UTC 2026
vlc-android | branch: master | majklvi <miko.vaji at gmail.com> | Thu Jul 16 00:55:33 2026 +0200| [c3b20bc9a1070e3e8f43aee284d2a2b6b621296b] | committer: majklvi
Network: clarify server addresses and location errors
server_domain_hint
Old: Server address (domain name or IP)
New: Server address (host name or IP address)
Reason:
The field supplies the URI host for HTTP, HTTPS, FTP, FTPS, FTPES, and SFTP.
"Domain name" can imply only a registered domain, while "IP" omits the word
"address". The revised hint accurately covers both host names and IP addresses.
server_share_hint
Old: Network share name (or IP address)
New: Server address (host name or IP address)
Reason:
For SMB and NFS, this field is inserted as the URI host after the scheme; the
share or folder path is entered in a separate field. The old hint therefore
asks for the wrong part of the network location, while the revised hint matches
the value that the dialog actually expects.
server_servername_hint
Old: Server name, for convenience
New: Display name (optional)
Reason:
"For convenience" does not explain the field's purpose or that it may be left
empty. The value is only the favorite's display name, and the code falls back
to the server address when it is omitted. The revised hint states both facts
concisely.
open_mrl_dialog_msg
Old: Enter network address: e.g. http://, mms:// or rtsp://
New: Enter a network address, such as http://, mms://, or rtsp://
Reason:
The old input hint omits the article before the singular countable noun and
introduces its examples with the awkward sequence ": e.g.". The revised hint
uses a natural instruction and clearly presents the supported-scheme examples.
invalid_location
Old: The location %1$s cannot be played.
New: The media at %1$s cannot be played.
Reason:
A location is an address and is not itself played; VLC attempts to play the
media at that location. The revised error identifies the actual object of the
failed playback while preserving the location placeholder.
missing_location
Old: This media is from a unavailable storage and cannot be played.
New: This media is on an unavailable storage device and cannot be played.
Reason:
The old message uses the incorrect article "a" before "unavailable" and the
unnatural phrase "is from ... storage". The revised wording correctly explains
that the media resides on a storage device that is currently unavailable.
Implementation note:
Only the six default English resource values are changed. Resource keys, URI
construction, protocol handling, favorite storage, playback validation,
localized resources, and the %1$s placeholder remain unchanged.
Testing:
Parsed all 77 strings.xml catalogs, verified the six revised values and their
active network-server dialog, stream-input, playlist-manager, and remote-access
references, and confirmed from NetworkServerDialog that the address field forms
the URI host, the folder has a separate field, and an empty display name falls
back to the address. Confirmed that invalid_location retains exactly one %1$s
placeholder, that the diff contains only the default English strings.xml file,
that no localized values-* resources are changed, that the staging area is
empty, and that git diff --check succeeds. The application resources module
assembled and the VLC-Android Kotlin sources compiled successfully in the
official VLC-Android CI image (73 actionable tasks: 9 executed and 64
up-to-date). No emulator or on-device UI test was performed.
> https://code.videolan.org/videolan/vlc-android/commit/c3b20bc9a1070e3e8f43aee284d2a2b6b621296b
---
application/resources/src/main/res/values/strings.xml | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/application/resources/src/main/res/values/strings.xml b/application/resources/src/main/res/values/strings.xml
index 8da536fa0d..62e61d649a 100644
--- a/application/resources/src/main/res/values/strings.xml
+++ b/application/resources/src/main/res/values/strings.xml
@@ -239,11 +239,11 @@
<string name="remote_keyboard_navigation">Keyboard navigation</string>
<string name="server_add_title">Add a new server to favorites</string>
- <string name="server_domain_hint">Server address (domain name or IP)</string>
- <string name="server_share_hint">Network share name (or IP address)</string>
+ <string name="server_domain_hint">Server address (host name or IP address)</string>
+ <string name="server_share_hint">Server address (host name or IP address)</string>
<string name="server_folder_hint">Folder path (optional)</string>
<string name="server_username_hint">Username</string>
- <string name="server_servername_hint">Server name, for convenience</string>
+ <string name="server_servername_hint">Display name (optional)</string>
<string name="server_port">Port: </string>
<string name="login">Login</string>
<string name="password">Password</string>
@@ -256,15 +256,15 @@
<string name="favorite_removed">Removed from favorites</string>
<string name="streams">Streams</string>
- <string name="open_mrl_dialog_msg">Enter network address: e.g. http://, mms:// or rtsp://</string>
+ <string name="open_mrl_dialog_msg">Enter a network address, such as http://, mms://, or rtsp://</string>
<string name="empty" translatable="false"></string>
<string name="time_0" translatable="false">0:00</string>
<string name="load_1_period" translatable="false">.</string>
<string name="load_2_period" translatable="false">..</string>
<string name="load_3_period" translatable="false">...</string>
- <string name="invalid_location">The location %1$s cannot be played.</string>
- <string name="missing_location">This media is from a unavailable storage and cannot be played.</string>
+ <string name="invalid_location">The media at %1$s cannot be played.</string>
+ <string name="missing_location">This media is on an unavailable storage device and cannot be played.</string>
<string name="search">Search</string>
More information about the Android
mailing list