Files
inkOS/DOCUMENTATION.md
2025-07-02 18:03:41 +03:00

4.8 KiB
Raw Permalink Blame History

📱 App Documentation


🔧 Features

Padding Size
Controls the gap between home app items. Font family and size can affect this spacing, so its recommended to adjust it for better visibility.

Re-order Apps
Easily drag and drop apps to rearrange their order in the home menu.

Extend Clickable Area
Makes the full horizontal area of app names clickable.
E.g., [Calendar] → [ Calendar ]

Number of Home Apps
Sets how many apps in total are featured on the home screen.

Number of Pages
Determines the total number of pages. Apps will be auto-divided across pages.

Enable Page Indicator
Displays dots on the right side to indicate the current page.

Show Clock
Enables the clock widget at the top of the home screen.

Show Battery
Enables the battery widget at the bottom of the home screen.


🅰 Fonts

Universal Font
Sets a single font family for all font-selectable items. When enabled, only text size can be modified.
Tip: Set a universal font, then disable it to customize specific fonts (e.g., a display font for the clock).

Settings Font/Text Size
Controls font family and text size for all settings menus.

App Font/Text Size
Controls font and size for home menu apps, app drawer, and hidden apps.

Clock Font/Text Size
Controls font and size for the Clock widget.

Battery Font/Text Size
Controls font and size for the Battery widget.

Label Notifications
Controls font and size for notification previews under app names.
E.g.,
Whatsapp
John: Message goes here
Character limit adjustable in Settings > Notifications.

Window Title/Font/Size
Sets the title string and its font/size for the notification window (opened by swiping left).

Body Font
Controls the body text in the notification window.


🎨 Look & Feel

Theme Mode
Switch between light and dark themes.

E-Ink Auto Refresh
Optimized for e-ink devices (e.g., Mudita Kompakt). Flashes the screen after exiting apps to clean ghosting artifacts.
Note: Doesn't apply to overlays like quick settings; press the home button to exit.

Show Status Bar
Displays the top status bar (carrier, clock, battery, Wi-Fi, Bluetooth).

Element Colors
Allows setting custom UI colors.
Recommended only for AMOLED displays. Not suitable for e-ink screens.


Gestures

Volume Keys Swipe
Navigate between pages using the volume keys.

Double Tap
Customize double tap to:

  • Restart launcher
  • Open notifications window
  • Disable the gesture

Click on Clock
Customize clock tap to:

  • Open clock (alarm app)
  • Restart launcher
  • Open notifications window

Swipe Left / Swipe Right
Default actions:

  • Swipe left: Open notifications
  • Swipe right: Open phone app
    You can also assign these to page navigation.

🔔 Notifications

Push Notifications
Enable or disable notifications system-wide.
System permission dialog will guide you.

Asterisk
Adds a * next to app names with pending notifications.

Label Notifications
Shows actual notification content below app names.
Great for chat/media apps.

Media Playing Asterisk
Displays a music note beside apps currently playing media.

Media Playing Name
Displays the name of currently playing media (e.g., song, podcast, audio file).

Home Notifications Allowlist
Choose which apps can show label notifications on the home screen.
Highly recommended for focus and clarity.

Chat Notifications
Controls for:

  • Sender/group name
  • Message preview
  • Character limits
    Important for layout stability—depends on font and size.

Notification Window
Enables a dedicated window to read full messages.

  • Has a separate allowlist
  • Some limitations apply based on app permissions

⚙️ Advanced

Hidden Apps
Hide apps from the App Drawer (e.g., system apps).

Lock Home Apps
Prevents app changes on the home screen via long press.

Long Press for App Info
Opens the system dialog to uninstall or force stop apps.
Especially useful for phones with no recents menu.

Lock Settings
Lock the Settings menu with fingerprint or PIN to avoid accidental changes.

Backup / Restore

  • Backup: Save current settings for future restoration (e.g., factory reset or new device).
  • Restore: Load saved settings.
    Note: Custom fonts are not backed up.
  • Clear All Data: Reset everything to default.

🗂️ Open App Drawer

Displays a scrollable list of all installed apps.

Long Press Options:

  1. Delete: Uninstalls the app
  2. Rename: Change app name/alias (affects home too)
  3. Hide: Moves the app to the hidden apps list
  4. Lock: Requires fingerprint/PIN to open
  5. Info: Opens the system info dialog