Skip to content

feat: add opt-in home screen launcher via termux.properties#5095

Open
Frodotus wants to merge 1 commit into
termux:masterfrom
Frodotus:feature/home-screen-launcher
Open

feat: add opt-in home screen launcher via termux.properties#5095
Frodotus wants to merge 1 commit into
termux:masterfrom
Frodotus:feature/home-screen-launcher

Conversation

@Frodotus
Copy link
Copy Markdown

@Frodotus Frodotus commented Apr 28, 2026

Summary

Adds Termux as an optional home screen launcher, disabled by default. This implements the feature requested in #206.

  • Adds a HomeLauncherActivity activity-alias (disabled by default) with HOME and DEFAULT intent filters
  • Adds enable-home-screen-launcher property to termux.properties — set to true to enable
  • The component state is toggled at runtime in updateFileReceiverActivityComponentsState(), consistent with how disable-file-share-receiver and disable-file-view-receiver are handled

How to enable

Add to ~/.termux/termux.properties:

enable-home-screen-launcher=true

Then restart Termux. You can then select Termux as your home app from system Settings → Apps → Default apps → Home app.

Closes #206

Adds a disabled-by-default activity-alias (HomeLauncherActivity) that
registers Termux as a home screen launcher. Enable it by setting
enable-home-screen-launcher=true in termux.properties.

Implements the feature requested in termux#206.
@synthyst
Copy link
Copy Markdown

This is actually very cool feature, looking forward to it being accepted after the rewrite is done. :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

launcher mode support?

2 participants