Files
readest/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/permissions/autogenerated/reference.md
T
Huang Xin 7da41a65ad feat(widget): add mobile home-screen reading widgets (#1602) (#4842)
Add a resizable home-screen widget on iOS and Android showing recent
in-progress books with cover, reading progress, and tap-to-open.

- One responsive widget: Android resizable 1x1 to 4x3 (one book per
  column, up to 3); iOS Small/Medium/Large families. Covers are cropped,
  rounded, with a percent badge and a progress bar (baked into the bitmap
  on Android, SwiftUI overlays on iOS).
- TTS controls (previous, play-pause, next) appear in 2+ row sizes when
  TTS is active, wired to the existing media session. Reading progress
  stays live during background TTS via a fraction computed from the baked
  offline locations.
- Publishes a snapshot plus downsized cover thumbnails to the iOS App
  Group and Android SharedPreferences through a new update_reading_widget
  native-bridge command; refresh is debounced and driven by library and
  progress changes, TTS, and app backgrounding.
- Tapping a cover opens readest://book/{hash}, switching the reader in
  place when one is already open.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-28 18:03:16 +02:00

15 KiB

Default Permission

Default permissions for the plugin

This default permission set includes the following:

  • allow-auth-with-safari
  • allow-auth-with-custom-tab
  • allow-copy-uri-to-path
  • allow-save-image-to-gallery
  • allow-use-background-audio
  • allow-install-package
  • allow-set-system-ui-visibility
  • allow-get-status-bar-height
  • allow-get-sys-fonts-list
  • allow-intercept-keys
  • allow-lock-screen-orientation
  • allow-iap-is-available
  • allow-iap-initialize
  • allow-iap-fetch-products
  • allow-iap-purchase-product
  • allow-iap-restore-purchases
  • allow-get-system-color-scheme
  • allow-get-safe-area-insets
  • allow-get-screen-brightness
  • allow-set-screen-brightness
  • allow-get-external-sdcard-path
  • allow-open-external-url
  • allow-show-lookup-popover
  • allow-get-lookup-dictionary
  • allow-clear-lookup-dictionary
  • allow-select-directory
  • allow-get-storefront-region-code
  • allow-request-manage-storage-permission
  • allow-register-listener
  • allow-remove-listener
  • allow-check-permissions
  • allow-request-permissions
  • allow-checkPermissions
  • allow-requestPermissions
  • allow-set-sync-passphrase
  • allow-get-sync-passphrase
  • allow-clear-sync-passphrase
  • allow-is-sync-keychain-available
  • allow-set-secure-item
  • allow-get-secure-item
  • allow-clear-secure-item
  • allow-refresh-eink-screen
  • allow-update-reading-widget

Permission Table

Identifier Description

native-bridge:allow-auth-with-custom-tab

Enables the auth_with_custom_tab command without any pre-configured scope.

native-bridge:deny-auth-with-custom-tab

Denies the auth_with_custom_tab command without any pre-configured scope.

native-bridge:allow-auth-with-safari

Enables the auth_with_safari command without any pre-configured scope.

native-bridge:deny-auth-with-safari

Denies the auth_with_safari command without any pre-configured scope.

native-bridge:allow-check-permissions

Enables the check-permissions command without any pre-configured scope.

native-bridge:deny-check-permissions

Denies the check-permissions command without any pre-configured scope.

native-bridge:allow-checkPermissions

Enables the checkPermissions command without any pre-configured scope.

native-bridge:deny-checkPermissions

Denies the checkPermissions command without any pre-configured scope.

native-bridge:allow-check-permissions

Enables the check_permissions command without any pre-configured scope.

native-bridge:deny-check-permissions

Denies the check_permissions command without any pre-configured scope.

native-bridge:allow-clear-lookup-dictionary

Enables the clear_lookup_dictionary command without any pre-configured scope.

native-bridge:deny-clear-lookup-dictionary

Denies the clear_lookup_dictionary command without any pre-configured scope.

native-bridge:allow-clear-secure-item

Enables the clear_secure_item command without any pre-configured scope.

native-bridge:deny-clear-secure-item

Denies the clear_secure_item command without any pre-configured scope.

native-bridge:allow-clear-sync-passphrase

Enables the clear_sync_passphrase command without any pre-configured scope.

native-bridge:deny-clear-sync-passphrase

Denies the clear_sync_passphrase command without any pre-configured scope.

native-bridge:allow-clip-url

Enables the clip_url command without any pre-configured scope.

native-bridge:deny-clip-url

Denies the clip_url command without any pre-configured scope.

native-bridge:allow-copy-uri-to-path

Enables the copy_uri_to_path command without any pre-configured scope.

native-bridge:deny-copy-uri-to-path

Denies the copy_uri_to_path command without any pre-configured scope.

native-bridge:allow-get-external-sdcard-path

Enables the get_external_sdcard_path command without any pre-configured scope.

native-bridge:deny-get-external-sdcard-path

Denies the get_external_sdcard_path command without any pre-configured scope.

native-bridge:allow-get-lookup-dictionary

Enables the get_lookup_dictionary command without any pre-configured scope.

native-bridge:deny-get-lookup-dictionary

Denies the get_lookup_dictionary command without any pre-configured scope.

native-bridge:allow-get-safe-area-insets

Enables the get_safe_area_insets command without any pre-configured scope.

native-bridge:deny-get-safe-area-insets

Denies the get_safe_area_insets command without any pre-configured scope.

native-bridge:allow-get-screen-brightness

Enables the get_screen_brightness command without any pre-configured scope.

native-bridge:deny-get-screen-brightness

Denies the get_screen_brightness command without any pre-configured scope.

native-bridge:allow-get-secure-item

Enables the get_secure_item command without any pre-configured scope.

native-bridge:deny-get-secure-item

Denies the get_secure_item command without any pre-configured scope.

native-bridge:allow-get-status-bar-height

Enables the get_status_bar_height command without any pre-configured scope.

native-bridge:deny-get-status-bar-height

Denies the get_status_bar_height command without any pre-configured scope.

native-bridge:allow-get-storefront-region-code

Enables the get_storefront_region_code command without any pre-configured scope.

native-bridge:deny-get-storefront-region-code

Denies the get_storefront_region_code command without any pre-configured scope.

native-bridge:allow-get-sync-passphrase

Enables the get_sync_passphrase command without any pre-configured scope.

native-bridge:deny-get-sync-passphrase

Denies the get_sync_passphrase command without any pre-configured scope.

native-bridge:allow-get-sys-fonts-list

Enables the get_sys_fonts_list command without any pre-configured scope.

native-bridge:deny-get-sys-fonts-list

Denies the get_sys_fonts_list command without any pre-configured scope.

native-bridge:allow-get-system-color-scheme

Enables the get_system_color_scheme command without any pre-configured scope.

native-bridge:deny-get-system-color-scheme

Denies the get_system_color_scheme command without any pre-configured scope.

native-bridge:allow-iap-fetch-products

Enables the iap_fetch_products command without any pre-configured scope.

native-bridge:deny-iap-fetch-products

Denies the iap_fetch_products command without any pre-configured scope.

native-bridge:allow-iap-initialize

Enables the iap_initialize command without any pre-configured scope.

native-bridge:deny-iap-initialize

Denies the iap_initialize command without any pre-configured scope.

native-bridge:allow-iap-is-available

Enables the iap_is_available command without any pre-configured scope.

native-bridge:deny-iap-is-available

Denies the iap_is_available command without any pre-configured scope.

native-bridge:allow-iap-purchase-product

Enables the iap_purchase_product command without any pre-configured scope.

native-bridge:deny-iap-purchase-product

Denies the iap_purchase_product command without any pre-configured scope.

native-bridge:allow-iap-restore-purchases

Enables the iap_restore_purchases command without any pre-configured scope.

native-bridge:deny-iap-restore-purchases

Denies the iap_restore_purchases command without any pre-configured scope.

native-bridge:allow-install-package

Enables the install_package command without any pre-configured scope.

native-bridge:deny-install-package

Denies the install_package command without any pre-configured scope.

native-bridge:allow-intercept-keys

Enables the intercept_keys command without any pre-configured scope.

native-bridge:deny-intercept-keys

Denies the intercept_keys command without any pre-configured scope.

native-bridge:allow-is-sync-keychain-available

Enables the is_sync_keychain_available command without any pre-configured scope.

native-bridge:deny-is-sync-keychain-available

Denies the is_sync_keychain_available command without any pre-configured scope.

native-bridge:allow-lock-screen-orientation

Enables the lock_screen_orientation command without any pre-configured scope.

native-bridge:deny-lock-screen-orientation

Denies the lock_screen_orientation command without any pre-configured scope.

native-bridge:allow-open-external-url

Enables the open_external_url command without any pre-configured scope.

native-bridge:deny-open-external-url

Denies the open_external_url command without any pre-configured scope.

native-bridge:allow-refresh-eink-screen

Enables the refresh_eink_screen command without any pre-configured scope.

native-bridge:deny-refresh-eink-screen

Denies the refresh_eink_screen command without any pre-configured scope.

native-bridge:allow-register-listener

Enables the register_listener command without any pre-configured scope.

native-bridge:deny-register-listener

Denies the register_listener command without any pre-configured scope.

native-bridge:allow-remove-listener

Enables the remove_listener command without any pre-configured scope.

native-bridge:deny-remove-listener

Denies the remove_listener command without any pre-configured scope.

native-bridge:allow-request-permissions

Enables the request-permissions command without any pre-configured scope.

native-bridge:deny-request-permissions

Denies the request-permissions command without any pre-configured scope.

native-bridge:allow-requestPermissions

Enables the requestPermissions command without any pre-configured scope.

native-bridge:deny-requestPermissions

Denies the requestPermissions command without any pre-configured scope.

native-bridge:allow-request-manage-storage-permission

Enables the request_manage_storage_permission command without any pre-configured scope.

native-bridge:deny-request-manage-storage-permission

Denies the request_manage_storage_permission command without any pre-configured scope.

native-bridge:allow-request-permissions

Enables the request_permissions command without any pre-configured scope.

native-bridge:deny-request-permissions

Denies the request_permissions command without any pre-configured scope.

native-bridge:allow-save-image-to-gallery

Enables the save_image_to_gallery command without any pre-configured scope.

native-bridge:deny-save-image-to-gallery

Denies the save_image_to_gallery command without any pre-configured scope.

native-bridge:allow-select-directory

Enables the select_directory command without any pre-configured scope.

native-bridge:deny-select-directory

Denies the select_directory command without any pre-configured scope.

native-bridge:allow-set-screen-brightness

Enables the set_screen_brightness command without any pre-configured scope.

native-bridge:deny-set-screen-brightness

Denies the set_screen_brightness command without any pre-configured scope.

native-bridge:allow-set-secure-item

Enables the set_secure_item command without any pre-configured scope.

native-bridge:deny-set-secure-item

Denies the set_secure_item command without any pre-configured scope.

native-bridge:allow-set-sync-passphrase

Enables the set_sync_passphrase command without any pre-configured scope.

native-bridge:deny-set-sync-passphrase

Denies the set_sync_passphrase command without any pre-configured scope.

native-bridge:allow-set-system-ui-visibility

Enables the set_system_ui_visibility command without any pre-configured scope.

native-bridge:deny-set-system-ui-visibility

Denies the set_system_ui_visibility command without any pre-configured scope.

native-bridge:allow-show-lookup-popover

Enables the show_lookup_popover command without any pre-configured scope.

native-bridge:deny-show-lookup-popover

Denies the show_lookup_popover command without any pre-configured scope.

native-bridge:allow-update-reading-widget

Enables the update_reading_widget command without any pre-configured scope.

native-bridge:deny-update-reading-widget

Denies the update_reading_widget command without any pre-configured scope.

native-bridge:allow-use-background-audio

Enables the use_background_audio command without any pre-configured scope.

native-bridge:deny-use-background-audio

Denies the use_background_audio command without any pre-configured scope.