Skip to content
TwistedUmbrellaX edited this page Feb 14, 2022 · 9 revisions

The first (and only) true Z Flip cover screen IME

After releasing the code to enable keyboards as part of SamSprung TooUI, this is a standalone cover screen IME. This project has been developed in the hope of one day being natively supported.

Initial SamSprung Setup

If you would like to prevent incompatibility with Settings, Developer Options provides a toggle to allow overlays. This presents some risk for untrustworthy apps to interact with your device settings and should only be enabled if you trust all apps with overlay permission.

When launching the app, only the main switch is required. Once you've provided overlay permission, turning on the screen with the device closed launches the app. That's it. No widget selection.

The extended menu below the main toggle includes support and donation options. The first button displays the current build number and clicking it when it turns red will install updates. The second option will save or send a logcat, depending on whether you have access to automated reports. The last two options are for PayPal and Google Play donations, respectively.

Before reporting an issue, please make sure to install any pending updates. This can be done simply by launching the settings page. A popup will appear if there is a new update. The app (and cover overlay) will resume once it is installed.

PayPal and Google Play donations are accepted. Donations are completely optional, but are greatly appreciated and fund the creation of new features. Please keep in mind that many of these features are the driving motivation for other apps, too.

The final menu item is the current version identifier. This item does not perform any special actions.

Permissions

Accessibility will allow the keyboard to function. The accessibility service is strictly designed to transmit user-initiated key events. All accessibility actions are one way and do not read any information from the device.

Enabling accessibility will reveal the "Keyboard (IME)" settings. This is used to enable the onscreen keyboard. It only needs to be enabled as an option. It is not recommended to set it as default.

Notifications will enable the Android notification listener service. This is a lightweight and recently reliable method to retrieve notification content and interact with it. This service cooperates with accessibility to provide better notifications.

Usage statistics will allow the drawer to sort the app list by most recently used apps. This is done based on the last hour. When enabling this option, you will see your most recently used apps move to the bottom of the list on the bottom of the page.

Write settings allows launching apps that would otherwise crash due to incompatible configurations. All workarounds used are meant to be temporary and are reset whenever they are no longer required.

UI Options

The toggle button allows customizing the drawer as a list with text or a grid of icons. Click the button to swap between options.

The color bar is a theme option. Click the bar to reveal the sliders and customize your theme. There are no preset themes. The color you choose will be used throughout the various menus and icons of the cover interface.

If storage permission is provided, your wallpaper will also be used as a background in both the settings page and on the cover screen. This allows you to retain the personalization you've already done.

The list of apps are the ones that will be in your drawer. Toggle to hide. The app lists update with install and uninstall actions, so they will always remain current. Apps are shown by default, so return any time to hide them.

SamSprung Keyboard

Close the cover, go to an app, click a text box, and start typing. It works much like the stock Android keyboard, only smaller.

Use the direction keys at the bottom to swap between letters and the number pad. Additional pages will be added in future releases.

Press the X at the bottom to close.

Closing Remarks

I may die poor, but it will be with dignity.

This project is free and open source, as this functionality was never meant to be locked. This app has only one paid feature. Donators can submit issues directly from the menu with a logcat already attached.

There are a number of other features that are not visible when using SamSprung, but play a large role in making it run. These features, some proprietary, have been written or modified specifically for this project. Steal them if you must, but don't think it goes unnoticed.

Clone this wiki locally