[A-EDev]

Summary

• Headphones resume ([Bug]: irregular background playback #1450): a headset Play resumes music only after music was playing. It no longer resumes after notification Close, sleep timer Close app, or a video. New "Resume from headphones" switch, plus a shortcut row to allow background activity when Android restricts Flow.
• Home at launch ([Bug]: Homepage instant reload on startup #1447): cached cards you already saw are left out, and the fresh feed waits behind a pill-shaped "New videos" button instead of replacing the list under your finger.
• Video menu ([Feature]: Improve Video Download Experience on Android #1432): Download joins Save and Watch later in the button group, and Share moves to the first Options row. New "Ask every time" setting: off downloads at your download quality in one tap.
• Download sheet ([Feature]: * Add a setting to show the downloads tab in the main app interface. * Update the download options UI to be minimal and well organized as the one in the attachments. * Support share to download directly from the official YouTube or the other apps. #1382): the Classic menu is now a sheet with quality tiles, a codec group, an Audio Track picker, subtitles, audio-only tiles and the download folder. The Compact menu is also a sheet. Both share DownloadSheetFrame: a modal sheet from menus, and in the video player and Shorts the same FlowBottomSheet as comments and the description, so they open under the video. Their tiles and buttons use a darker container there so they stand apart from the sheet.

Related issue

Closes #1450
Closes #1447
Closes #1432
Closes #1382

Change type

• Bug fix
• Feature
• Refactor or maintenance
• Build, packaging, or CI
• Documentation

Validation

• ./gradlew :app:assembleGithubDebug passed
• ./gradlew :app:testGithubDebugUnitTest passed (4,439 tests, 0 failures, 2 skipped)
• I ran any additional flavor-specific build or test tasks affected by this change: ktlintCheck, :app:compileFossDebugKotlin, :app:compileGithubDebugAndroidTestKotlin, python3 .github/scripts/nightly_notes.py --check all passed
• I manually tested the affected behavior on an Android device or emulator.

Test device and Android version: POCO X6 Pro 5G, Android 16; Resizable emulator (tablet)

Screenshots or recordings

Risk and compatibility

• New preferences resume_from_headphones (default on) and download_ask_every_time (default on), so current behaviour is kept until changed. The headphone resume state is a marker file so the media button path can read it synchronously.

• No Room schema change.

• The change does not introduce secrets, private data, or unexpected telemetry.

• New user-facing text uses Android string resources.

• Dependency and lockfile changes are intentional and limited to this PR.

• Room schema changes include the required version bump and migration, or this PR does not change the Room schema.

• Breaking changes and upgrade steps are clearly documented.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.