# Usage
Screenshots retain their historical 1.2.4 provenance; use the [installation page](https://beatsad.github.io/quiet-tv/) for current downloads. Computer AI configuration below describes current source and has not shipped in a new APK. Older APKs retain their own controls and interfaces.
[简体中文](USAGE.zh-CN.md) [Home](../README.en.md)
## Remote navigation
| Key | Behavior |
| --- | --- |
| Left / Right | Browsing stops at row edges; second-screen sorting crosses rows and stops at list ends |
| Up / Down | Move one row between shortcuts, dock, and grid |
| OK | Current source: a short Home press waits up to about 400ms before opening the selected entry; settings keep their normal controls |
| Double OK on Home | Two short presses within 400ms enter the screensaver, even with automatic entry off |
| Hold OK on an app | Open the application actions menu; release does not launch the app |
| Back in the grid | Return to the dock |
| HOME | Return to the first screen, with focus in Favorite apps |
| Back from an application to Home | Keep the position and focus used before opening the application |
All Apps and Home order both use five columns. An incomplete last row uses the nearest valid column. Focus is saved locally for restoration. In 1.2.4, a new HOME request always takes priority and returns to the first screen; ordinary Back returns preserve the previous position. A historical build passed one Sony TV reboot. That historical result does not establish reboot or complete upgrade-state acceptance for 1.2.4.
In 1.2.4, the greeting, clock, date, weather, top-right shortcuts and dock scroll out together when entering All Apps, in both Classic and Art Gallery layouts. All Apps uses a smaller top gap and shows a centered, single-line name below every cover; long names end with an ellipsis, and row spacing stays consistent. More apps scroll continuously by row with focus, without scrollbars, an app count or footer labels. Up from the first grid row or Back from the grid restores the original home layout and the dock item selected before entering the grid.
Historical screenshots show published [1.2.4 test builds](https://github.com/BeatsAD/quiet-tv/releases/tag/v1.2.4). Captures come directly from a Sony BRAVIA VH1 / Android 12 running published ARM32 build 64; they do not establish full feature or other-device acceptance. See [capture provenance](assets/README.md).
Without a calibrated mapping, current development source opens system settings when Home receives the standard Menu key, and the input selector for the standard TV Input key. Actions run on key release; canceled presses do not launch anything. Keys handled directly by vendor firmware and private key codes still require validation on the target model and firmware. Computer AI setup can [calibrate Home, Input and Menu](agent/remote.md); mappings save locally for the model, firmware and Android user after all three actions are confirmed.
Current source adds Desktop Settings → Desktop → Interaction feedback → Key sounds, off by default. Enable it for soft navigation, selection and back sounds; disabling it silences feedback immediately and the preference persists locally. Boundaries and automatic focus restoration stay silent; held navigation sounds play at most once per 100 ms. This affects Quiet TV only and never changes system volume or other apps. This source feature has not shipped in a new APK; TV and external-speaker sound and latency still need device acceptance.
In the current development source, hold OK on Home’s Network or Settings button to test its entry. Test the current route first. If it fails, return, hold the same button, mark the failure and explicitly test the next entry. Only confirming that the requested settings opened normally remembers the route. If Network can only open the settings home, the test identifies that fallback and does not offer to remember it as a successful network entry; you can explicitly test the next entry. Ordinary navigation and a quick return never confirm success or open another menu automatically. Network and Settings preferences are separate; firmware or related system package updates require a new test. This feature is not released and still needs hardware validation.
Home inputs and HDMI selection in Watch TV share discovery rules. Current development source adds old XGIMI product configuration, Hisense Jamdeo inputs and explicit Xiaomi port records. Framework input types take priority; missing ports within a type are added only with complete, explicit port mappings, preserving hidden ports across aliases. Mappings are scoped to firmware and related system package versions; see [input configuration](agent/inputs.md). Failure to find an entry does not mean the TV has no input ports. The new protocols still need Quiet TV hardware acceptance on the relevant firmware.
## App management and Dock
Open 应用管理 (App Management) from All Apps. Management controls in this first Sony-targeted version are in Chinese.
Current development source adds a long-OK menu to Dock and second-screen apps. Dock supports move, replace, add, remove from Home, hide and uninstall; the second screen supports move, add to Home, hide and uninstall. Dock displays app entries only, with Add available in its long-press menu. Add/replace pickers use equal-sized rounded covers. The second screen has no title or category bar. Ordinary hidden apps can be restored from the Hidden apps filter immediately after Preinstalled apps under Desktop Settings → App Management; parental hiding remains separate. Adding to a full Dock requires choosing a replacement. Second-screen sorting inserts the moving app while preserving the relative order of other apps. Left and Right cross row boundaries and stop at list ends; Up and Down move by row. Dock keeps horizontal sorting. OK puts the app down and saves; Back cancels the unfinished move. This differs from the historical 1.2.4 behavior below and has not established physical-TV acceptance. User-app uninstall uses system confirmation and configured parental verification; protected components remain unavailable.
- The historical 1.2.4 首页应用 (Favorites) page supports up to five shortcuts: add, replace, remove, or move left/right. In 1.2.4, each reorder move saves automatically; OK or Back ends moving without undoing saved changes. Editing works without ADB.
- **Home order**: in 1.2.4, open App management → 应用排序. Press OK to select an entry, then use the arrows to move it. Each position change saves automatically; OK or Back ends moving. There are no save/reset buttons or save-on-exit prompts. Historical APKs retain their version-specific behavior. Wallpaper Settings, Desktop Settings and App Management can all move.
- Current development source filters All, User apps, Preinstalled apps, Hidden apps, Disabled and Recoverable, keeping package details and everyday artwork controls.
- Computer AI handles initial TCP ADB setup and device rules. App Management provides rule-scoped disable, enable, current-user uninstall and restore-install actions; published builds117/118 do not yet include these restored controls. Restoring installation does not restore deleted data.
- App Management → More → Help and recovery pauses takeover or restores the recorded original launcher. Missing records, disabled original launchers or unsupported system selection require computer recovery.
- Preserve the original launcher and recovery records. Disabling retains data; enabling a package cannot recover data removed by a historical uninstall. Inspect uncertain results before making another change.
Disabled Dock entries retain their order and reappear when enabled. Confirmed uninstalls remove the shortcut. An explicitly empty Dock stays empty across APK updates. See [implementation and hardware evidence](APP_MANAGEMENT.md).
Version 1.2.4 provides 应用列表 → 更换封面 (Change cover). Scan with a phone on the same network, select and crop an image, then confirm on the TV to apply it. 恢复默认 restores the app's current original artwork after confirmation. Recommended: 720 × 406 px; minimum: 360 × 203 px. JPG, PNG or static WebP, up to 2 MB per image. AI can help create a suitable image; no generation service is included. Cover changes work without ADB and retain the original app icon and package-operation protection. Current development source has five filters, a Connect management button and a More menu. See [app covers](APP_MANAGEMENT.md#自定义应用封面) for scope and hardware acceptance limits.
Home ordering works without ADB and leaves Dock independent. In custom order, newly visible apps append at the end; updates and name changes preserve positions. Disabled or pinned apps retain their order records until shown again; uninstalls remove records. Default order puts Desktop Settings, Wallpaper Settings and App Management first, followed by apps sorted by name. Settings stay on the device across normal in-place updates; physical remote, reboot, and upgrade behavior must be accepted on each target TV.
App details provide Change cover and Set as startup app. This capture shows the entries without changing app state.
## Child mode
Open App Management → 儿童模式. Set a six-digit parent PIN on first use and verify it when returning. Use the on-screen numeric keypad with arrows and OK. Password recovery uses your own recovery details; do not publish a PIN or recovery code.
After parent verification, hide or lock apps and configure per-session, recurring or unlimited use, with preset or custom durations. Recurring limits persist until changed: choose every day, weekdays, weekends or custom weekdays. Each selected date receives its own quota at local midnight without a PIN; unselected dates are blocked. Unused and parent-added time do not carry over. Restarting retains the current day’s usage. Exhausted limits open a rest screen; a parent can verify and add time for today, including an unselected date. The rest screen refreshes after midnight and lets the user continue without starting the app automatically. Counting needs the separate 儿童模式计时 accessibility service, distinct from desktop guard. See [child mode](APP_MANAGEMENT.md#儿童模式).
The capture shows an empty verification entry only. No password, rule or timing setting was changed.
## App autostart
Open Desktop Settings → App Management, select an app and choose 设为开机自启 in its details. The current target offers 关闭开机自启. More → 应用自启 shows the current target and lets you disable it even after uninstalling the app. It opens once after boot or an eligible standby wake enters Quiet TV, without repeating on HOME return. Enabling app autostart confirms that Watch TV on startup will be disabled; the saved TV source remains. See [app autostart](APP_MANAGEMENT.md#开机自启开发源码).
## Watch TV (development source)
Desktop Settings → Watch TV has three controls: TV source, Watch TV on startup and Watch now. Choose a directly callable HDMI port; Home and automatic boot entry share this one target. Without a target, the Home entry opens these settings instead of an autostart app. Watch TV is always available in the desktop app catalog. Use the existing long-press menu to add it to Home, remove it or replace another entry; source settings do not change Home positions.
First-time startup enablement opens the source for a picture and sound check. Return to settings and confirm to enable startup in one step. Watch now can also be used before enabling startup. Disabling startup retains manual watching; changing the source requires confirmation again. App autostart and TV startup are mutually exclusive. HDMI attempts once during the first three minutes of a full boot after Quiet TV becomes interactive and foreground, without repeating on HOME return or actively switching on standby wake. If no directly callable HDMI is found, TV source offers the available native input panels, including separate TCL quick and system panels. Opening a panel does not save an HDMI target, confirm playback or enable startup. With no usable panel, use the remote input key. Firmware and route changes require selection and testing again. Dispatch and user confirmation do not replace target-TV acceptance. See [Watch TV](APP_MANAGEMENT.md#hdmi-开机直达与看电视开发源码).
## Boot-ad management
Current source moves boot-ad maintenance to computer AI. It requires an explicit request, a matching execution rule, original-state records and recovery checks. No Quiet TV boot-ad rule has passed hardware acceptance; no universal ad-removal claim is made. Older APKs may retain their former controls. See [app management](APP_MANAGEMENT.md#开机广告).
## Language and initial configuration
Edit `app/src/main/assets/launcher.json`, then rebuild and update the APK. `dock` supplies up to five initial package names in left-to-right order. Once migrated, edit Dock in the TV interface; bundled changes do not overwrite saved preferences. `hidden` hides entries without disabling packages. Choose `zh` or `en` for `language`, and `time` or `home` for `greeting`. The current implementation does not implement the prompt's planned automatic `system` language mode.
The included application package list belongs to the Sony adaptation. Use actual packages installed on your target device; see the [Chinese configuration example](USAGE.zh-CN.md).
## Wallpapers
In current development source, open Wallpaper Settings from All Apps. Focusing a media card only previews it. Clicking or pressing OK on the card applies the desktop wallpaper, with no separate Set wallpaper button. Set saver in the centered bottom capsule independently selects screensaver media. Cards mark both uses. Back discards unapplied previews. Older APKs retain their original controls. Version 1.2.4 removes the top-right Manage button; long-press OK and confirm to delete. Back does not undo completed deletions.
- **Default color theme:** a black background with an app-colored glow. Always available and cannot be deleted.
- **Rotation interval:** the top-toolbar Rotate capsule opens a dropdown with Off, 1, 5, 15, 30 minutes and 1 hour. Up/Down only moves focus; OK saves, while Back cancels and returns focus to the capsule. Selecting an interval starts with the previewed item. Photos and videos rotate separately in list order; the default theme and Daily wallpaper are excluded. Fewer than two items in a category disables the control and shows a hint. Existing enabled slideshows retain five minutes; disabled ones stay off. The interval survives restart. Opening the picker, entering the screensaver or leaving Home pauses the timer; returning starts a full interval. Applying a single wallpaper stops rotation but retains the interval.
- **Daily wallpaper:** focus the card after Default color theme to preview; click or press OK on the card to apply and enable daily updates. Bing China is the only provider. Daily settings, provider selection and the update-check dialog are removed. The subtitle shows Bing China, Updates daily, and the currently cached image name when available; long names are truncated at the end. Daily mode disables local slideshow; selecting a local wallpaper leaves daily mode.
- **Daily updates and offline use:** updates run as needed when the home screen resumes, the day changes or connectivity returns. A new image is saved before replacing the previous one. Offline or failed updates keep the current wallpaper. An active legacy Btstu cache remains a temporary background until a Bing image is saved; no further Btstu requests are made. The daily card cannot be deleted. API and image CDN reachability depends on the network and TV firmware.
- **Bing filtering and storage:** inspect metadata for the latest eight images, skip images not offered for wallpaper download, and download only the most recent eligible image. Reuse an identical or newer Bing cache without moving back to an older image. Bing uses two fixed image slots in private app storage, overwritten in turn rather than accumulated by date; each image is limited to 8 MiB. The original download temporary file is released when the request ends. Prepared images remain available offline; leaving daily mode keeps the cache. Legacy Btstu files are retained without further updates or automatic deletion.
- **Delete:** focus an image or video card and long-press OK to open its confirmation dialog. Cancel has initial focus; select Delete to remove that one wallpaper. Releasing the held key neither applies the wallpaper nor confirms deletion. Uploaded images and videos delete only the TV copy. Default color theme and Daily wallpaper cannot be deleted. Deleting the fixed current photo restores the color theme; deleting the slideshow’s current photo advances to the next. Fewer than two items in the active category disables rotation. Deleting the current rotating video selects a remaining video.
- **File transfer:** open App Management → 文件传输 to receive files from a phone or computer on the same LAN, or select authorized local/USB files. Choose Preview and set as wallpaper, then confirm; receiving alone never changes the wallpaper. For an uploaded APK, select Install app on the TV, review its details, and confirm in the system installer; uploading never installs automatically. A file becomes downloadable only after selecting Send to phone or computer on the TV. Receipts are limited to 200 MB per file and 500 MB total; wallpaper imports retain per-file format and size limits and available-storage checks, without a wallpaper count or total-library quota. On Android 5+, a persistable directory read grant remembers the last directory for each local/USB source across restarts. Revoked grants or offline storage require renewed authorization or reconnection. See the [file-transfer guide](APP_MANAGEMENT.md#文件传输助手).
Accepts JPG, PNG and static WebP: up to 60 MB and 40 megapixels per input. Current development source removes photo-count and total-library quotas while retaining available-storage checks. Uploads and local imports are saved at up to 4K: a long edge of 3840 pixels and a short edge of 2160 pixels. Larger images are scaled proportionally without stretching or cropping; images within these limits retain their original bytes without enlargement or re-encoding. Resizing applies EXIF rotation and mirroring, retaining transparency as PNG or saving opaque images as JPEG at quality 90. Source files on the phone, local storage or USB drive are unchanged. Separate in-memory display images follow the app's rendering size, up to a 3840-pixel long edge; low-memory devices or memory classes below 256 MB use a 1920-pixel limit. Display cropping and a black background for transparent areas do not rewrite saved files. Existing wallpapers remain unchanged; importing them again applies the new limits. Convert HEIC to JPG before uploading.
After choosing a photo or video on the phone upload page, you can edit its wallpaper name. The field starts with the original filename without its extension; upload directly to keep that name. Names must be non-empty, contain no slashes or backslashes, and use up to 48 characters. The name appears in the TV wallpaper list without renaming the original file. Choosing another file resets the name; failed-upload retries retain your edit. No rename action or extra confirmation is added on the TV.
Version 1.2.4 supports video wallpapers, off by default. In the Video category, focusing a card starts a silent preview. In current source, click or press OK on the card to apply; if playback is still loading, the choice saves after the first frame without another confirmation. Previewing alone keeps the active wallpaper unchanged. Switching cards or leaving cancels a pending application. Turning it off or deleting the active video restores the previous photo, daily wallpaper or slideshow. With video rotation off, the selected video loops individually. Video rotation switches after the chosen dwell interval and saves the next selection only after its first frame; playback failure keeps the original selection. Videos stay outside photo rotation and release playback resources when the launcher leaves the foreground or the screen turns off. Failed playback keeps the saved wallpaper; press OK on the card to retry and apply.
Video import has no fixed file-size, frame-rate, resolution, bit-depth or HDR limit; a recognizable, unencrypted video track and enough available storage are required. Current development source removes video-count and total-library quotas, including posters. Available storage and file parsing are checked on upload. Declared decoder capabilities are diagnostic only and do not block import; returning to the TV starts an actual decode attempt in preview, and applying waits for the first frame. Android 5+ uses Media3 1.8.1 with bounded buffering and automatic decoder selection across brands: compatible hardware is preferred, while system software decoders are tried first when hardware declares the format unsupported. Initialization failures try other available decoders. A hardware video-decoding failure or first-frame timeout triggers one software-only attempt after the old player confirms release or process exit. Sound and pause settings are preserved; leaving the page cancels a pending retry. This requires a system software decoder for the format, and achievable frame rate depends on the TV. File-access, audio, encryption and output errors do not trigger video software retry. A failed software attempt shows the corresponding error and keeps the saved wallpaper. Current development source uses independent SurfaceView output for fullscreen wallpaper and screensavers on Android 8.1/API27 and later; Android 5.0–8.0 and the small file-transfer preview retain TextureView. Scrolling between Home and the second screen updates blur, brightness and fade without replacing the player or output. API27+ retains independent SurfaceView output; the blur overlay uses bounded asynchronous PixelCopy snapshots without reducing source decoding or unblurred video output resolution. A zero fade disables only the animation and still waits for the first-frame and covered-window handoff. Failed snapshots keep the last valid blur image. Actual output resolution and smoothness require separate acceptance. Brightness and fade use an overlay without relying on SurfaceView alpha blending. The Android 4.x profiles default to platform MediaPlayer in a private playback process. Android 4.1–4.4 (API16–19) explicitly retries once with an available system software decoder after a platform decoding failure or first-frame timeout and confirmed player retirement. A Java-only ExoPlayer 2.18.7 adapter provides audio sync and looping, with no added native decoder library; sound, pause and cancellation use the same handoff logic. Android 4.0/4.0.3 (API14/15) retains system-controlled MediaPlayer decoder selection. API17–19 use SurfaceView for ordinary fullscreen video and await the rendering-start callback; API14–16, small previews, and legacy videos with rotation metadata retain TextureView. Native outputs below API24 use the video poster for background blur. First-frame timeout retires the player. A native operation stalled for 2.5 seconds terminates only the playback process; subsequent playback is allowed after process death is confirmed, without repeatedly retrying the failed video. HOME and user data remain intact; vendor system media-service failures still require device diagnosis. Import permission does not establish playback support for an encoding, resolution, frame rate or HDR combination; 1080p60 support does not imply 4K60 support. GIF, animated WebP and wallpaper projects are not accepted. Landscape loops are recommended; portrait video is decoded at its actual encoded dimensions and center-cropped. No on-TV transcoding is performed.
The phone can preview its local file before and after upload. An unsupported browser preview does not block uploading an accepted container; the page asks the user to check playback on the TV. Phone preview does not establish TV playback compatibility. TV failures distinguish file access, unsupported format, decoding, first-frame timeout and output failure; the selected wallpaper and uploaded videos are retained, with platform/Media3 error codes in diagnostics. A 4K label describes the source, not verified full-resolution output. Native 4K, sustained smoothness, screensaver and standby behavior require target-TV acceptance. Scaling the image does not reduce decoding resolution; upload an actual lower-resolution copy on weaker devices. Older systems may use a placeholder for 4K posters.
The server runs only while the TV upload dialog is open. Leaving it, backgrounding Quiet TV, changing network addresses, or ten idle minutes ends the session and invalidates its QR code and connection code. Reconnecting refreshes both. Five incorrect codes pause verification for 30 seconds. If connection fails, check guest-network/device isolation and try a system browser. Failed uploads and storage errors leave existing wallpapers unchanged.
Version 1.2.4 no longer bundles the Big Sur photos, Golden Gate video or its poster, and removes Restore built-in wallpapers. Upload your own video to populate the Video category. On upgrade, retired built-in selections return to the previous available photo or the default color theme; uploaded photos, videos and daily wallpaper caches are preserved.
APK updates preserve uploaded wallpapers; uninstalling or clearing application data removes uploaded photos. Existing selections and rotation settings migrate on first launch. Both 1.2.4 profiles include the described management and uploads. Sony captures show the pages only; complete upload, deletion/recovery and upgrade-state acceptance remain pending. See [resource notices](../THIRD_PARTY_NOTICES.md) for provenance and licensing limits.
The upload dialog contains a local address, connection code and QR code, so its raw screenshot is kept private. Follow the current TV session; closing it invalidates that session.
## In-desktop screensaver (development source)
The wallpaper page shares its library with the screensaver. A wider single centered bottom capsule provides Set saver, automatic entry (Off, 1, 5, 10 or 15 minutes), Time and Weather. Changes save immediately. Time and Weather have no separate persistent background or border; their focus outlines appear during remote navigation. On first upgrade, automatic entry is off, media references the current wallpaper, and both information switches are on. Later wallpaper changes do not change the saver selection. Media is referenced by ID, never copied. Deleting selected saver media restores the default color background; failed saves retain the previous settings and show an error.
Idle timing runs only while Home is foreground and interactive with no settings window or popup. Remote, touch and mouse activity reset it; leaving Home, editing app order or turning the screen off stops it. Two short OK presses within 400ms enter the saver even with automatic entry off. A single Home OK therefore waits up to about 400ms. Focus movement, Back or leaving Home cancels pending confirmation; long, repeated and canceled presses cannot double-click. Settings retain their normal controls.
The first ordinary key or click only wakes Home, consuming the complete down/up gesture and restoring focus. Power, HOME and volume retain their system behavior. Saver playback uses the existing decoder, pauses slideshow, stays muted without changing wallpaper sound, and retains a cover until the first video frame. Exit restores the background before desktop controls. Time uses system time and timezone; weather shares existing location, source and cache with independent visibility and hides when unavailable.
Standard and Android 4.x share configuration, state and input logic, with Media3 or platform MediaPlayer playback and system-software fallback on API16–19. Sony remote feel, duplicate reports, sustained playback and standby wake still require target-TV acceptance. This source documentation does not indicate that published APKs include the feature.
## Desktop settings
Open Desktop Settings from All Apps. Current source shares seven tabs in this order: Desktop, Weather, App Management, Child mode, File transfer, Updates and Diagnostics. Home apps and App order tabs have been removed; use the desktop long-press menu to add, replace, remove or move apps. Old page entries and saved page states open App Management while retaining favorites and ordering. Computer AI handles technical setup. Historical 1.2.4 standard APKs also have Home setup. Use App Management → More → Help and recovery to pause or restore the original launcher. A pause does not change system HOME, and restoration retains a previously selected ADB-retention preference. See [setup and recovery](SETUP.md).
Unpublished source shares lightweight motion across Home/settings navigation, settings tabs and dialogs: settings enter in 180 ms and exit in 140 ms, tab content moves slightly for 160 ms, and dialogs enter in 160 ms and exit in 100 ms. Tab changes keep the backdrop and heading stable. Repeated keys select the latest target immediately; Back and dialog actions do not wait for animations. Home supplies its existing small backdrop to settings; direct settings entry decodes wallpaper in the background while controls appear first. Ordinary returns Home do not replay a wallpaper fade from black, and switching preview scenes reuses loaded artwork. These animations preserve main-wallpaper and native-video output resolution. Window transitions and smoothness still require acceptance on target TVs.
Desktop places controls on the left and a Home preview on the right. Focusing App names, Blur, Brightness or Fade in under Second-screen apps switches the preview to the app grid using the device’s actual apps, saved order and Home apps visibility. Focusing another desktop control restores the Home preview. Choose Classic or Gallery, and independently show or hide greeting, time, date, weather, Inputs, Network and Settings. Changes save immediately and update the preview using the current wallpaper, favorites and usable cached weather. The preview cannot receive focus or launch apps and makes no additional weather requests. Weather uses the full content area without a preview. Home uses the same layout, and switching layouts preserves visibility preferences and greeting text. The second screen always includes every visible app, including Home favorites, with its own saved order. Adding, replacing or removing a Home shortcut, or toggling Home apps visibility, keeps those apps in the grid and preserves their saved positions.
Current development source retains one valid preview scene per process and reuses it immediately when reopening Desktop Settings or returning to Desktop. Wallpaper, artwork, package state, ordering and hiding changes invalidate the corresponding content; time, cached weather, network and display controls continue to refresh. Closing the page releases its listeners and page references. Memory pressure, configuration changes or process restart may require a fresh first load. Vendor-TV acceptance is still required.
On upgrade, both time and date inherit the old combined preference once; they can then be changed independently. Unset quick-button preferences inherit the old group toggle. Remaining buttons retain their order, align right and are skipped by remote navigation when hidden. Restore them through All Apps → Desktop Settings even when all three are hidden. Version 1.2.4 provides the described layouts, live preview and independent display settings. Normal in-place updates retain preferences; physical remote, restart and upgrade retention still need acceptance on each target TV.
Desktop → App title controls the large title above the Dock and defaults to on. Hiding it keeps the Dock in place and updates the preview immediately. Changes apply when returning Home and persist locally across app restarts. This toggle is not included in the published packages yet.
Desktop → All apps → App names controls names below second-screen cards. It defaults to on and is independent of the Home App title setting. Hiding names preserves card spacing and order. Changes apply when returning Home and persist across restarts. Classic, Gallery and the Android 4.4 compatibility profile share this setting. This toggle is not included in the published packages yet.
The unpublished source adds separate Blur sliders under Home apps and Second-screen apps. Each ranges from 0–100% and defaults to 0 (clear). Remote left/right adjusts by 5%; touch dragging is also supported. Values save independently on this device. Home and second-screen blur update their respective previews; returning to the desktop applies each value to its wallpaper, blending during scrolling while icons and text stay sharp. Photos and video wallpapers share the setting in both layouts. The wallpaper picker and screensaver retain their original appearance. Static backgrounds use system GPU blur on Android 12+ and small background-filtered snapshots on older systems. Where native video snapshots are supported, both copying and filtering run in the background while native video output keeps its original resolution. Separate Home and second-screen blur caches blend during scrolling; keys and transitions defer new captures until movement settles. Visible blur updates at up to about 10 FPS, with a standby cache refreshed at about 1 FPS on clear pages. Older systems without video snapshot support retain the poster. Performance and appearance still require acceptance on target TVs.
Home apps and Second-screen apps also have independent Brightness and Fade in sliders in the unpublished source. Brightness ranges from 20–100% (default 100%), with 5% remote-key steps, and affects wallpaper pixels and the Dock background sample. Fade in ranges from 0–1.2 seconds (default 0.6), with 0.1-second steps; zero displays directly once the target frame is ready. The current page’s duration controls the initial desktop reveal, photo slideshow transitions and video poster-to-first-frame transitions; ordinary returns Home preserve continuous display. Scrolling blends brightness and selects the current page’s fade duration. The current page’s preview updates brightness immediately and replays the fade 200 milliseconds after its slider stops changing. Touch dragging is supported. Icons, text and cards retain their original clarity and brightness. The wallpaper picker and screensaver keep their own presentation. Physical remotes, sustained video playback and standby/wake still require target-TV acceptance.
## Home greeting
Open All Apps → Desktop Settings → Desktop → Home greeting. Show greeting controls the text independently of weather and time. Turning it off retains the saved text for the next time you enable it.
Select the input with your remote to use the system keyboard; Chinese input requires an installed Chinese IME. Alternatively, select Phone input, connect your phone to the TV’s local network and scan the QR code. You can also open the displayed address in a browser and enter the connection code. Sending only fills the TV draft: select Save on the TV to apply it. Cancel or Back discards both text and switch changes.
Saving empty text restores the time-based greeting. Long text is ellipsized on Home and remains complete in the editor. Existing fixed Welcome home configurations keep their text until edited. Each phone session accepts one submission and ends when you return to editing, background the app, change network addresses or leave it idle for ten minutes. Text is saved locally on the TV; no account or cloud service is required.
The Avatar row supports phone upload, change, removal and an independent visibility switch. Choose a JPG, PNG or static WebP original up to 10 MB, then drag or pinch to adjust the circular crop. The phone sends a 512 × 512 image, limited to 2 MB. The first upload enables the avatar in the draft; hiding it retains the image. It appears beside the greeting or on its own. Missing or invalid images leave no empty circle.
Uploading only updates the draft. Save on the TV applies text, avatar and both switches together; Cancel or Back keeps the saved settings. Upload sessions use a temporary QR link and connection code and end when the upload closes, the app backgrounds, the network changes or the session expires. Only the normalized avatar is kept in private app storage; original photos and location metadata are discarded. Updating the app retains saved settings, and upgrading from an older build does not add an avatar automatically.
## Home weather
Classic places the weather icon, temperature, conditions and city beside the greeting; Gallery centers the Home information. Toggle weather under All Apps → Desktop Settings → Desktop. The top Weather tab provides automatic location, city selection, refresh and service information. Turning off automatic location pins the resolved city; if no city is available, choose one first, or cancel to keep automatic location. Choosing a city turns automatic location off. City preferences remain editable while weather is hidden, without location or weather refresh requests. No ADB is needed and the system Settings button is unchanged.
Current development source supports QWeather, UAPI, OpenWeather and Open-Meteo. Weather source selects automatic failover or one fixed provider. Fixed-provider failures retain usable cache without silently switching. Automatic mode tries configured QWeather, UAPI and configured OpenWeather sequentially, skipping unsupported places. Open-Meteo is off by default because its free endpoint is for non-commercial use only; select it explicitly or enable Open-Meteo fallback to try it last. Enabling it explains the terms; Service information links attribution, licensing and the provider website. Rate limits are independent. Optional private build credentials are documented in [Contributing](../CONTRIBUTING.md#可选天气源配置--optional-weather-configuration). Clean builds still work with UAPI without credentials.
Weather places retain their own names and available coordinates independently of current administrative codes. Changdao and its former-county aliases use a reference point near the former county seat, rather than relabeling Penglai weather. This does not establish accuracy for every island. UAPI cannot represent standalone coordinate places and is skipped or reports that another source is needed. Open-Meteo current conditions are model estimates, not proof of a local station observation. Overseas connectivity, old Android HTTPS and island accuracy still require target-network and TV acceptance.
Existing manual selections and cache remain compatible. When online, independent administrative lookup can enrich an existing selection with coordinates; lookup failure preserves the selection and the QWeather name-lookup compatibility path. System coordinates can query coordinate providers directly without district lookup, using “Current location” if no name is available. IP estimation still requires UAPI. HTTPS verification stays enabled, and missing data never becomes 0°C or another place’s weather.
Automatic location prefers the system network provider. Missing services, unavailable providers, insufficient permission or location API exceptions fall back directly to IP estimation; a normal location request waits at most five seconds. Failed cancellation does not block Home startup or return, and late location callbacks cannot refresh twice. Manual cities and disabled weather do not acquire the system location service. Choose a city manually if IP estimation is inaccurate.
Choose a location using province/city/district dropdowns or Chinese keyword search. Typing searches bundled regions and supplemental place aliases offline; explicitly pressing Search also queries UAPI. Online results retain coordinates; streets and towns become independent places instead of using their parent district’s weather. Both TV and phone use the same place catalogue. Search requests and weather calls are separate, and unavailable online search leaves local selection usable. Complete Hong Kong, Macao and Taiwan divisions are not bundled. Phone input remains LAN-only: scan the QR or enter the six-digit code, send a candidate, then select Save on TV. The phone can only submit candidates offered by that session, never arbitrary coordinates or credentials. Cancel keeps the previous selection, and sessions expire after ten idle minutes.
Weather refreshes about every 30 minutes while Home is visible. Returning Home uses cached data first; backgrounding cancels location and scheduled requests. Home shows only the weather icon, temperature, conditions and city. Updating or failed refreshes keep usable cached weather without appending “Not updated” or other status messages. Weather is hidden when no usable data exists, the cache is over six hours old, or weather display is off. Data older than one hour, refresh failures and update times remain visible in Weather settings. If the upstream observation time cannot be parsed, cache retention uses fetch time and settings explicitly report that observation time is unavailable. Missing data never becomes 0°C or a default city's weather. Free access has dynamic rate limits and no perpetual availability guarantee; a 429 pauses refresh for at least 30 minutes and respects a longer service retry delay.
Android 4.4 enables TLS 1.2 for this connection only, retaining system trust and hostname verification with no plaintext fallback. Old firmware trust stores and OEM location behavior still need hardware acceptance. Icons use local native drawing, without video, WebView or continuous animation.
## Inputs and settings
Inputs are read from the actual TV Input list. The adapted Sony exposes HDMI 1–4, AV, and Live TV. An empty channel database offers settings without automatically tuning channels. Network and Settings open their corresponding system screens.
The standard profile checks known vendor input panels when the standard service is absent, restricted or empty. Only installed, enabled system components accessible to Quiet TV are offered. A single usable panel opens directly when the standard list is unavailable; multiple panels require a choice. Normal lists retain their entries and add usable system panels. BYINTEK U4's reported bogus standard list prefers its vendor panel. If a standard launch throws an error, the user can choose a system panel; a black screen without a launch error requires returning to Inputs and choosing that panel manually.
If no route is usable, a diagnostic dialog offers system settings. This does not establish that HDMI/AV ports are absent. Components and permissions are never changed automatically. See [compatibility](COMPATIBILITY.md) for the Hisense, TCL and BYINTEK candidates and hardware acceptance limits. The standard APK includes this fallback; legacy19 uses settings or the physical input key.
Ethernet has been checked. Wi-Fi names depend on location permission and the system location switch; switching to Wi-Fi has not been validated on hardware. Launching a media application does not verify its account, playback, sound, or third-party service.
## Updates and recovery
Current source provides App Management → 版本更新 (Version updates) → Check for updates. Older APKs may still use About. Automatic checks run every 24 hours while Home is in the foreground. The signed 1.2.4 feed is live. A matching newer software version shows a badge; after choosing Download, available sources are tried and the APK hash, package, version, system, architecture and signer are verified before user-confirmed installation.
A higher build of the same software version is not offered as an update. Versions without the entry need [manual installation](INSTALL.en.md). Installation restrictions or missing compatible packages do not trigger uninstalling, clearing data or forced downgrades. See [in-app updates](UPDATES.md).
Third-party apps update through their own channels. [Stock-home recovery](SETUP.md) uses this device's own original records, never another TV's system-package list.
The current version shares a callable app catalog across Home, sorting and favorites and adds detected OEM settings/input routes. Current development source caps new uploads and local imports at a 3840-pixel long edge and a 2160-pixel short edge, preserving smaller inputs without enlargement. Display images still follow the actual rendering size (3840px maximum, 1920px on low-memory devices). Existing photos remain unchanged; importing them again applies the new limits. Both profiles include the shared app/image changes; vendor input routing applies to standard, while legacy19 uses system settings. See [compatibility scope](COMPATIBILITY.md#本轮源码兼容改进).
### Current-source additions: files and parent verification
Files / USB imports a selected image or video into app storage before preview and application; originals are unchanged and USB can be removed after a successful import. The system picker is preferred. Older systems can browse readable storage with permission if no picker exists; newer systems require a system file grant, with LAN upload still available. Video wallpaper sound is off by default, persists when changed, and stops when leaving Home or turning the screen off.
Parent verification starts automatically after six digits. Creating or resetting a password still requires confirmation. Parents save their recovery code separately; the forgotten-password flow only accepts an existing code, and viewing the stored code requires parent verification. Timer rules can be saved before the accessibility service is ready, with an explicit inactive status. Entering the service configuration page does not enable the service. On-device expiry enforcement remains a separate validation step.
## Automatic input discovery (development source)
The Home Inputs button detects registered inputs and callable native input panels without asking for a TV model. Normal lists include all available native panels. With no standard inputs, a single ready panel can open directly; multiple panels require a choice. Existing explicit panel preference rules remain in effect. A native picker does not establish direct access to a particular HDMI port. Android 4.x checks native panels without invoking the API21 input framework.
Failures distinguish unavailable services, empty lists, hidden/filtered entries, read restrictions/errors, and missing, disabled or restricted native entries. Detect again is explicit; there is no repeated launch, permission change or component enabling. See [compatibility](COMPATIBILITY.md#信号源自动发现与原厂入口开发源码) for route provenance and the target-TV acceptance boundary.
Input discovery, saved HDMI validation and channel queries run in the background. Back, HOME, leaving Home, losing window focus or screen-off cancel pending Home work. Leaving Watch TV settings also prevents late launches or confirmations. An OEM transaction already issued may not be retractable; it is not proof of picture or audio success and is never automatically retried.