Skip to content

Announce download and upload percentage to screen readers - #1992

Open
mehranlatifi83 wants to merge 1 commit into
DrKLO:masterfrom
mehranlatifi83:feature/talkback-download-upload-percent
Open

mehranlatifi83 wants to merge 1 commit into
DrKLO:masterfrom
mehranlatifi83:feature/talkback-download-upload-percent

Conversation

@mehranlatifi83

@mehranlatifi83 mehranlatifi83 commented Jul 26, 2026 •

Copy link
Copy Markdown

Summary

Download and upload progress is only partly available to screen reader users. Documents, GIFs and videos announce the transferred size but never the percentage, and other media announce nothing at all while they are being transferred.

This change:

  • Announces the transfer as "Downloading 25%, 2 MB of 34 MB" when the message is reached, so the percentage comes before the sizes that were already announced.
  • Announces "Downloading 25%" for media that has no size to report, such as photos, voice messages and music, which previously stayed silent.
  • Follows the transfer while the message is being read: every 10% while the finger rests on it, and at most every 2.5 seconds while it only holds accessibility focus, and only when it moved at all. Messages that are neither touched nor focused stay silent.
  • Keeps those updates to what changed, the percentage and how much of the file arrived, since reaching the message already told what it is doing and how large it is.
  • Removes the duplicate upload announcement, where the same message reported both its uploaded size and a separate "Sending" percentage.
  • Keeps the spoken text in sync with the button state, so cancelling a download drops the progress from the message instead of leaving the last value behind.

Whether the transfer is running is taken from the same button state the visible icon uses, so audio, music and video all resolve correctly. Nothing changes visually, and only existing Telegram strings are used.

Checking it

With TalkBack on, start downloading a large file, a video or a photo, and swipe onto the message while it is on its way.

Before, a document, a GIF or a video said how much had arrived but never the percentage, and a photo, a voice message or a piece of music said nothing at all. Now the message says "Downloading 25%, 2 MB of 34 MB", or the percentage alone where there is no size to report.

Resting a finger on the message, or leaving it focused, follows the transfer as it moves. A message that is neither touched nor focused stays silent.

@mehranlatifi83
mehranlatifi83 force-pushed the feature/talkback-download-upload-percent branch 5 times, most recently from 5c1e168 to e6a36d0 Compare August 3, 2026 03:13
@mehranlatifi83
mehranlatifi83 force-pushed the feature/talkback-download-upload-percent branch 2 times, most recently from 7318686 to f105823 Compare August 29, 2026 19:07
@mehranlatifi83
mehranlatifi83 force-pushed the feature/talkback-download-upload-percent branch from f105823 to 2a26f86 Compare September 18, 2026 09:50
@mehranlatifi83
mehranlatifi83 force-pushed the feature/talkback-download-upload-percent branch from 2a26f86 to 32fd237 Compare September 27, 2026 10:45
Download and upload progress is only partly available to screen reader
users. Documents, GIFs and videos announce the transferred size but never
the percentage, and other media announce nothing at all while they are
being transferred.

This change:

- Announces the transfer as "Downloading 25%, 2 MB of 34 MB" when the
  message is reached, so the percentage comes before the sizes that were
  already announced.
- Announces "Downloading 25%" for media that has no size to report, such
  as photos, voice messages and music, which previously stayed silent.
- Follows the transfer while the message is being read: every 10% while
  the finger rests on it, and at most every 2.5 seconds while it only
  holds accessibility focus, and only when it moved at all. Messages that
  are neither touched nor focused stay silent.
- Keeps those updates to what changed, the percentage and how much of the
  file arrived, since reaching the message already told what it is doing
  and how large it is.
- Removes the duplicate upload announcement, where the same message
  reported both its uploaded size and a separate "Sending" percentage.
- Keeps the spoken text in sync with the button state, so cancelling a
  download drops the progress from the message instead of leaving the
  last value behind.

Whether the transfer is running is taken from the same button state the
visible icon uses, so audio, music and video all resolve correctly.
Nothing changes visually, and only existing Telegram strings are used.
@mehranlatifi83
mehranlatifi83 force-pushed the feature/talkback-download-upload-percent branch 2 times, most recently from bef3563 to 92b00d6 Compare October 1, 2026 23:01
@mehranlatifi83
mehranlatifi83 force-pushed the feature/talkback-download-upload-percent branch from 92b00d6 to 324ce34 Compare October 13, 2026 11:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant