Preferences
Application configuration. Full preference reads require Developer Mode; scoped reads and writes follow the registered key policies below.
Registered preference keys (63)
Access follows the registered key policy. Full raw reads require Developer Mode.
| Key | Purpose | Access |
|---|---|---|
| dlna | Enable the DLNA service. | Local and remote read/write |
| device_name | Device display name. | Local and remote read/write |
| feed_auto_refresh | Enable automatic feed refresh. | Local and remote read/write |
| feed_auto_refresh_interval | Automatic feed refresh interval in seconds. | Local and remote read/write |
| feed_auto_refresh_only_wifi | Restrict automatic feed refresh to Wi-Fi. | Local and remote read/write |
| ai_image_search_enabled | Enable semantic image search. | Local and remote read/write |
| ai_image_search_model | Selected image-search model. | Local and remote read/write |
| dlna_allowed_senders | Allowed DLNA sender identities. | Local and remote read/write |
| dlna_denied_senders | Denied DLNA sender identities. | Local and remote read/write |
| dark_theme | Theme selection: USE_DEVICE_THEME, ON or OFF. | Local and remote read/write |
| amoled_dark_theme | Use the AMOLED dark-theme option. | Local and remote read/write |
| pdf_follow_dark_theme | Apply the current dark theme to PDF viewing. | Local and remote read/write |
| locale | Interface language. | Local and remote read/write |
| show_hidden_files | Show hidden files in file browsing. | Local and remote read/write |
| feed_font_scale | Feed-reader font scale. | Local and remote read/write |
| editor_wrap_content | Wrap long editor lines. | Local and remote read/write |
| editor_font_size | Editor font size. | Local and remote read/write |
| editor_status_bar | Show the editor status bar. | Local and remote read/write |
| desktop_home_features | Features displayed on the desktop home page. | Local and remote read/write |
| desktop_rail_features | Features displayed in the desktop navigation rail. | Local and remote read/write |
| media_excluded_dirs | Directories hidden from media pages; file indexing and file search remain available. | Local and remote read/write |
| desktop_upload_dirs | Upload directory paths saved for each desktop media category. | Local and remote read/write |
| audio_sort_by | Audio-library sort order. | Local and remote read/write |
| video_sort_by | Video-library sort order. | Local and remote read/write |
| image_sort_by | Image-library sort order. | Local and remote read/write |
| doc_sort_by | Document-library sort order. | Local and remote read/write |
| file_sort_by | File-browser sort order. | Local and remote read/write |
| pkg_sort_by | Installed-package sort order. | Local and remote read/write |
| audio_play_mode | Audio playback repeat or shuffle mode. | Local and remote read/write |
| audio_playback_speed | Audio playback speed multiplier. | Local and remote read/write |
| pomodoro_settings | Pomodoro work, break and round configuration. | Local and remote read/write |
| screen_mirror_quality | Screen-mirror quality preset. | Local and remote read/write |
| clipboard_directions | Clipboard synchronization direction for each peer. | Local read/write only |
| http_port | HTTP listener port. | Local read/write only |
| https_port | HTTPS listener port. | Local read/write only |
| background_service_enabled | Enable the background service. | Local read/write only |
| remote_access | Enable remote access. | Local read/write only |
| developer_mode | Enable developer tools and full preference or database access. | Local read/write only |
| allow_any_host | Allow requests with arbitrary HTTP host names. | Local read/write only |
| nearby_discoverable | Allow nearby devices to discover this device. | Local read/write only |
| notification_filter | Notification synchronization filter configuration. | Local read/write only |
| launcher_shortcuts | Configured launcher shortcuts. | Local read/write only |
| image_grid_cells_per_row | Image-grid column count. | Local read/write only |
| video_grid_cells_per_row | Video-grid column count. | Local read/write only |
| https | Enable HTTPS. | Local read/write only |
| web_address_bar_expanded | Expand the remote-access address bar. | Local read/write only |
| password | Local password configuration. | Local read/write only |
| password_type | Selected password mode. | Local read/write only |
| login_require_approval | Require local approval for remote login. | Local read/write only |
| api_permissions | Features authorized for remote API clients. | Local read/write only |
| dev_token | Development access token configuration. | Local read/write only |
| log_level | Application logging level. | Local read/write only |
| auto_check_update | Automatically check for application updates. | Local read/write only |
| skip_version | Application update version to skip. | Local read/write only |
| mdns_hostname | mDNS hostname used for local discovery. Local callers may read and write it; authenticated remote callers may do so only when the server declares HTTP_SERVER support. | Local or authenticated remote with HTTP_SERVER |
| recent_selected_dirs | Up to eight confirmed absolute directory paths on this device, newest first. Windows paths use forward slashes; a drive root is D:/, not D:. ["D:/Projects/Photos", "E:/Backup/Photos"] | Local or signed-in remote with Files access |
| app_home_features | Features displayed by the native Tools page and its remote projection. | Local read/write; remote read only |
| opaque_server_setup | Internal OPAQUE password-authentication server setup. | Rust internal only |
| opaque_password_record | Internal OPAQUE password registration record. | Rust internal only |
| client_id | Internal persistent device identity. | Rust internal only |
| adb_token | Internal authorization token for local command access. | Rust internal only |
| master_secret | Internal master secret. | Rust internal only |
| signature_key_pair | Internal device signing key pair. | Rust internal only |
Type Definitions
type Subscription {
prefsChanged: Boolean!
}
type Mutation {
removePref(key: String!): Boolean!
setPref(key: String!, value: JSON!): Boolean!
}
type Query {
prefs(keys: [String!]): JSON!
}
scalar JSONOperations
prefsChanged
Receive a change signal when preferences change; refetch the configuration fields you use.
subscription prefsChanged {
prefsChanged
}removePref
Remove a writable preference override; auto_check_update and skip_version reset to their defaults. See the key whitelist.
mutation removePref($key: String!) {
removePref(key: $key)
}setPref
Set a registered writable preference, validate its value and apply its side effects. See the key whitelist for permissions.
mutation setPref($key: String!, $value: JSON!) {
setPref(key: $key, value: $value)
}prefs
Omit keys or pass null to read every raw stored preference, including internal keys; Developer Mode is required. Named keys use the key whitelist; an empty list returns an empty object.
query prefs($keys: [String!]) {
prefs(keys: $keys)
}