# What تلفزيونك already does: look here before you build anything The same features explained for people, in Arabic: [FEATURES.md](FEATURES.md). For an agent working on a TV that has تلفزيونك, during the setup or any time after. When the person asks for something about the screensaver, the home screen or the TV, find it in the tables below and run its command. ## Rules - **Use the setting.** Everything below is already in the apps; one command changes it, the screen redraws, and it stays through every update. - **Never build or patch the apps for a request.** No editing `android/`, `src/` or `dist/`, no building an APK, no installing your own build, no turning the automatic update off. The next update would undo it, a build of your own can't update itself afterwards, and the TV is left on a version nobody else has. - **Not in the tables?** Tell the person, in Arabic, that it isn't in تلفزيونك yet, and that their words can go to the developer as a suggestion: add them to the share message at the end (`optimize/share.sh --preview --owner "" …`, see `docs/SETUP-PROMPT.md` step 8). Don't make it yourself. - **A problem goes to the developer's form, never to GitHub.** When something doesn't work, or the person says «بلّغ المطوّر عن مشكلة» (now or any time later, from this computer or another one): look into it first with the tools here, then `optimize/share.sh --preview --problem --agent "" --owner "" ""`, show the person the whole text, ask «أرسله؟», and only if the person says yes `optimize/share.sh --send`. Never open a GitHub issue, discussion, comment or pull request for the person, never use `gh` or the GitHub website on their behalf: the developer reads the form, and a GitHub post is public and can carry their details. If the TV doesn't answer, send it anyway: the report says so. - **Close to one?** Offer the nearest setting (a trip date: the countdown; a darker card: `cardstyle dark1`). - **After a change:** read it back (`optimize/saver.sh show`, `optimize/dock.sh show`) and look at a screenshot (`optimize/shot.sh screensaver` or `optimize/shot.sh home`, the `-small.png`) before you say it's done. - `optimize/saver.sh`, `optimize/dock.sh` and `optimize/music.sh` with no arguments list every option. Names and texts go in single quotes; no apostrophes inside them. The settings screen (for telling the person where a row is) opens on big buttons: «الأذان» wide on top (its state under it; OK opens the adhan's page with its switch first, so OK, OK turns it on or off), then two to a row from the right: «الموقع والصلاة», «الساعة والأرقام» (12/24 hours, digits, month names), «تلاوة وأذان», «البطاقات» (its two buttons «شاشة التوقف» and «الشاشة الرئيسية»), «المظهر», «مركز التحكم», «التحكم من الجوال», «تحديث تلفزيوني» (the apps' update, the page's update and auto-update), «أرسل تقرير» (a QR code to the share page with the versions only), «المزيد» («المباريات والأسواق», «التطبيقات والمفضلة», «جديد المسلسلات», «تصفية المواقع», and later «اللغة»). OK opens one (or does it at once), Back returns to the button it came from. With «اللغة» English the same screen is in English and laid out from the left (the buttons then run two to a row from the left). Which row is where: `SettingsHub.ROWS` in the screensaver app, and the list in docs/FEATURES.md. An on/off row has no switch: three green triangles at its start and its word in green while it is on. The commands below are unchanged. **By keys (D-pad), to the two football and markets pages** (tested path; Arabic screen, in English the sideways keys swap): *Settings → «المزيد» → «المباريات والأسواق»:* from the first button «الأذان», **▼ ×5** (to «أرسل تقرير»), **◀** to «المزيد», OK; OK on its first button «المباريات والأسواق»; the focus starts on **«مباريات اليوم»**: OK opens the matches page. Back, then **▼ ×4** to **«صفحة الأسواق»**, OK opens the markets page. From the home: OK on the stocks card (a home card set to «الأسهم») opens «الأسواق»; OK on the games widget (`optimize/saver.sh homelayout football`) opens «المباريات» on that game. ## The screensaver «شاشة تلفزيونك» | They ask for | The setting | Command | |---|---|---| | their city, prayer times for it | المدينة | `optimize/saver.sh cities`, then `optimize/saver.sh city ` (Arabic or English; a short form is fine if only one city matches; use `city 'GB|London'` to qualify the country); not listed: `optimize/saver.sh city ''