termux / termux/termux-api

DisplayAPI

Open
#595 10 comments 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

API command request
Dominant language
Java
Stars
4.3k
Forks
920
PR merge metrics
No merged PRs in 30d

Description

Feature description

API that would provide info about the display like screen size.

Reference implementation

Have you checked if the feature is accessible through the Android API?

https://developer.android.com/reference/android/view/WindowMetrics

Do you know of other open-source apps that has a similar feature as the one you want? (Provide links)

https://bitbucket.org/oF2pks/kaltura-device-info-android/src/master/

Output from the kaltura app:

    "#DISPLAY=": {
        "Built-inScreen_falseHDR": {
            "Name": "Built-in Screen",
            "State": "ON",
            "ro.sf.lcd_density": "300",
            "RefreshRate": 60.000003814697266,
            "ScreenSpecs": "720 x 1280",
            "ViewingMetrics": "DisplayMetrics{density=1.875, width=720, height=1280, scaledDensity=1.875, xdpi=294.967, ydpi=295.563}",
            "AllMetrics": "720 x 1280, largest app 1280 x 1280, smallest app 720 x 720, appVsyncOff 2000000, presDeadline 11666666, mode 1, defaultMode 1, modes [{id=1, width=720, height=1280, fps=60.000004, alternativeRefreshRates=[]}], hdrCapabilities HdrCapabilities{mSupportedHdrTypes=[], mMaxLuminance=500.0, mMaxAverageLuminance=500.0, mMinLuminance=0.0}, userDisabledHdrTypes [], minimalPostProcessingSupported false, rotation 0, state ON}",
            "SupportedHdrTypes": "",
            "SupportedModes": "{id=1, width=720, height=1280, fps=60.000004, alternativeRefreshRates=[]}",
            "Mode": "{id=1, width=720, height=1280, fps=60.000004, alternativeRefreshRates=[]}",
            "RefreshRates21": "60.000004",
            "Cutout": "null"
        }
    }

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue points to Android's WindowMetrics API and the Kaltura device-info Android app as references. Start by reviewing how existing Termux:API functionality is exposed to command-line programs, then compare the available display data with the requested screen size, refresh, metrics, modes, HDR, and cutout details. Done means a defined display API exposes the agreed fields and output.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, java
Domain
api, cli, mobile
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.