-
Notifications
You must be signed in to change notification settings - Fork 259
Customize T_UI
Francesco edited this page Dec 22, 2017
·
129 revisions
t-ui customization files are located in the t-ui folder (check T_UI Folder to get further information).
That folder contains many files that tell t-ui how to work and decorate itself.
- behavior.xml -> define the behavior of t-ui in many situations
- cmd.xml -> behavior of some commands
- suggestions.xml -> color of text and background of suggestions
- theme.xml -> color of ui elements (input, bg, output, ...)
- toolbar.xml -> options for toolbar
- ui.xml -> enable/disable ui elements, define some behaviors
- notifications.xml
- apps.xml
- rss.xml
Note that colors are defined in the configuration files in hexadecimal format. Refer to Defining Colors if you are not familiar with this format.
There are two ways:
- using the t-ui command-line
- editing the file
IMPORTANT:
When you change a value you need to restart t-ui in order to get your value applied. To do so use the command
restart.
Use the command
config -set optionName value
The autocompletion will give you a list of available options to change.
For example, this:
config -set input_color #123456
will set input_color to #123456.
Don’t forget to use the command restart in order to apply your changes.
Use the command
config -open file.xml
The autocompletion will give you a list of available files to open.
Then, look for the line that starts with <optionName (where "optionName" is the option that you want to change) and replace the value of the attribute "value".
For example, let's say that you want to set your output color to green.
Use the command
config -open theme.xml
Then look for the line that begins with <output_color.
When you find it, it should look like that:
<output_color value="#123456"/>
We want output_color to be green (#00ff00).
So, change what's after "value=", and it will look like that:
<output_color value="#00ff00">
Then save, go back to t-ui and use the command restart.
| Name | Type | Default | Description |
|---|---|---|---|
| double_tap_lock | boolean | true | If true, t-ui will lock the screen on double tap |
| double_tap_cmd | String | "" | The command that will run when you touch two times the screen quickly |
| random_play | boolean | true | If true, music player will play your tracks in random order |
| songs_folder | String | "" | The folder that contains your music files |
| songs_from_mediastore | boolean | true | If true, t-ui will get tracks from the system Mediastore |
| tui_notification | boolean | false | If true, there will always be a notification in your status bar, telling you that t-ui is running |
| auto_show_keyboard | boolean | true | If true, your keyboard will be shown everytime you go back to t-ui |
| auto_scroll | boolean | true | If true, the terminal will be automatically scrolled down when the keyboard is open |
| show_hints | boolean | true | If true, t-ui will tell you some useful hints sometime |
| show_alias_content | boolean | true | If true, when you use an alias you'll also be able to know what command has been executed |
| show_launch_history | boolean | true | If false, t-ui won't show the apps that you launch |
| clear_after_cmds | int | 20 | Auto-clear after n commands (if -1, this feature will be disabled) |
| clear_after_seconds | int | -1 | Auto-clear after n seconds (if -1, this feature will be disabled) |
| max_lines | int | 100 | Set maximum lines that will be shown in the terminal (if -1, this feature is be disabled) |
| time_format | Time Format | "%m/%d/%y %H.%M" | Define the time format (see also Time Format) |
| time_format_separator | String | "@" | This is the separator between your different time formats (see also Multiple time formats) |
| ram_format | RAM format | "Available RAM: %avgb Gb of %totgb (%av%%)" | Define the RAM format (see also RAM format) |
| device_format | Device format | "%d: %u" | Define the device format (see also Device format) |
| battery_format | Battery format | "%v %" | Define the battery format (see also Battery format) |
| storage_format | Storage format | "Internal Storage: %iavmb Mb of %itotmb Mb (%iav%%)" | Define the storage format (see also Storage format) |
| input_format | Input format | "[%t] %p %i" | Define the input format (check input format) |
| output_format | Output format | "%o" | Define the output format (check output format) |
| session_info_format | Session info format | "%u@%d:%p" | Define the session info format (check session info format) |
| enable_app_launch | boolean | true | If false, you won't be able to launch apps from t-ui, unless you use "apps -frc" |
| network_info_format | Network info format | "%(WiFi - %wn/%[Mobile Data: %d3/No Internet access])" | Define the network format |
| app_launch_format | App-Launch Format | "--> %a" | Define app launch format (check app-launch format) |
| time_format_separator | String | "@" | Define the separator between multiple time formats (check multiple time formats) |
| alias_param_marker | String | "%" | Define the marker that will be replaced with a provided param (check Parameterized aliases) |
| alias_param_separator | String | "," | Define the separator between a group of params (check Parameterized aliases) |
| alias_content_format | Alias content format | "%a --> [%v]" | Define the format used to show your alias contents (check Alias content format) |
| multiple_cmd_separator | String | ";" | The separator between two or more commands in a single input |
| home_path | String | May change | The path to your home directory |
| external_storage_path | String | May change | The path to your external storage (used to evaluate free/total space) |
| app_installed_format | App installed format | "App installed: %p" | The format of the "app installed" message (check this) |
| app_uninstalled_format | App uninstalled format | "App uninstalled: %p" | The format of the "app uninstalled" message (check this) |
| enable_music | boolean | true | If false, t-ui won't try to load music from your device on startup |
| max_optional_depth | int | 2 | A value which is used to tell how deep t-ui can go in a nested optional value |
| network_info_update_ms | int | 3500 | The time between two network info updates |
| tui_notification_title | String | "T-UI" | The title of the T-UI notification |
| tui_notification_subtitle | String | "T-UI os running" | The subtitle of the T-UI notification |
| tui_notification_click_cmd | String | "" | The command ran when the T-UI notification is clicked |
| tui_notification_click_showhome | boolean | true | If false, the click on the T-UI notification won't bring you to your phone home |
| tui_notification_lastcmds_size | int | 5 | The number of used commands that will appear inside the T-UI notification (<0 will disable the feature) |
| tui_notification_lastcmds_updown | boolean | true | If true, the last used command will appear on top |
| tui_notification_priority | int | 0 | The priority of the T-UI notification (-2 maximum priority, 2 minimum) |
| long_click_vibration_duration | int | 100 | The duration (in milliseconds) of the vibration when you long click a notification or an RSS item (<0 will disable the feature) |
| long_click_duration | int | 700 | The minimum duration of the long click on a notification or an RSS item |
| click_commands | boolean | true | If true, you will be able to use a command again clicking on it |
| long_click_commands | boolean | true | If true, you will be able to put a used command in the input field long-clicking it |
| Name | Type | Default | Description |
|---|---|---|---|
| default_search | Param | "-gg" | The param that will be used if you type search apples instead of search -param apples
|
| Name | Type | Default | Description |
|---|---|---|---|
| show_suggestions | boolean | true | If false, suggestions won't be shown |
| transparent_suggestions | boolean | false | If true, the background will be transparent |
| default_text_color | color | #000000 | The default text color |
| default_bg_color | color | #ffffff | The default background color |
| apps_text_color | color | "" | Apps suggestions text color |
| apps_bg_color | color | #00897B | Apps suggestions background color |
| alias_text_color | color | "" | Aliases suggestions text color |
| alias_bg_color | color | #FF5722 | Aliases suggestions background color |
| cmd_text_color | color | "" | Commands suggestions text color |
| cmd_bg_color | color | #76FF03 | Commands suggestions background color |
| song_text_color | color | "" | Songs suggestions text color |
| song_bg_color | color | #EEFF41 | Songs suggestions background color |
| contact_text_color | color | "" | Contacts suggestions text color |
| contact_bg_color | color | #64FFDA | Contacts suggestions background color |
| file_text_color | color | "" | Files suggestions text color |
| file_bg_color | color | #03A9F4 | Files suggestions background color |
| suggest_alias_default | boolean | true | If true, your alias will be shown when the input field is empty |
| suggest_appgp_default | boolean | true | If true, your app groups will be shown when the input field is empty |
| click_to_launch | boolean | true | If true, some suggestions will be executed as soon as you click them |
| suggestions_size | int | 12 | The text size of the suggestions |
| Name | Type | Default | Description |
|---|---|---|---|
| input_color | color | #ff00ff00 | Input color |
| output_color | color | #ffffffff | Output color |
| bg_color | color | #ff000000 | Background color |
| device_color | color | #ffff9800 | Device label color |
| ram_color | color | #fff44336 | RAM label color |
| toolbar_color | color | #ffff0000 | Toolbar icons color |
| toolbar_bg | color | #00000000 | Toolbar background color |
| enter_color | color | #ffffffff | Enter icon color |
| overlay_color | color | #80000000 | The overlay that overlaps to the background (only when system_wallpaper is true) |
| battery_color_high | color | #4CAF50 | Battery label color when the battery level is high |
| battery_color_high | color | #FFEB3B | Battery label color when the battery level is medium |
| battery_color_high | color | #FF5722 | Battery label color when the battery level is low |
| time_color | color | #03A9F4 | Time label color |
| storage_color | color | #9C27B0 | Storage label color |
| alias_content_color | color | #1DE9B6 | Alias content color |
| statusbar_color | color | #000000 | Status Bar color (5.0+) |
| navigationbar_color | color | #000000 | Navigation Bar color (5.0+) |
| app_installed_color | color | #FF7043 | App installed message color |
| app_uninstalled_color | color | #FF7043 | App uninstalled message color |
| hint_color | color | #4CAF50 | Hint color |
| mark_color | color | #CDDC39 | The background color that will be used as marker |
| Name | Type | Default | Description |
|---|---|---|---|
| show_toolbar | boolean | true | If false, the toolbar is hidden |
| Name | Type | Default | Description |
|---|---|---|---|
| show_username_ssninfo | boolean | true | If true, your username will be shown in the session info |
| show_ssninfo | boolean | true | If true, when your input field is empty there will be a short line containing some information about the current session |
| show_path_ssninfo | boolean | true | If true, session info will contain path |
| show_devicename_ssninfo | boolean | true | If true, your device name will be shown in session info |
| show_enter_button | boolean | true | Hide/show the enter button |
| system_font | boolean | false | If false, t-ui font will be used for all texts (Lucida Console) |
| font_size | int | 15 | An integer that will be used to scale ui |
| input_bottom | boolean | true | If false, input field will be placed on top of the screen |
| show_ram | boolean | true | If true, there will be a label on top of the screen containing your current free RAM (see also ram_format) |
| show_device_name | boolean | true | If true, your device name will be shown in a small label on top of the screen |
| show_battery | boolean | true | If true, there will be a small label containing the current battery percentage on top of the screen (see also battery_format) |
| enable_battery_status | boolean | true | If true, battery color will change when your battery level reach different percentages battery_color high, battery_color_medium, battery_color_low. If false, only battery_color_high is used |
| show_time | boolean | true | If true, there will be a small label containing the current time on top of the screen (see also time_format) |
| show_storage | boolean | true | If true, there will be a small label containing informations about your internal/external storage (see also storage_format) |
| username | String | user | Your username |
| deviceName | String | "" | Your device name |
| system_wallpaper | boolean | false | If true, your system wallpaper will be used as background |
| fullscreen | boolean | false | If true, t-ui will run in fullscreen mode |
| device_index | int | 0 | This is used to order the labels on top of the screen |
| ram_index | int | 1 | This is used to order the labels on top of the screen |
| battery_index | int | 2 | This is used to order the labels on top of the screen |
| time_index | int | 3 | This is used to order the labels on top of the screen |
| storage_index | int | 4 | This is used to order the labels on top of the screen |
| input_prefix | String | "$ " | The prefix placed before every input |
| input_root_prefix | String | "#" | The prefix placed before a root command ("su ...") |
| right_margin_mm | int | 0 | Right margin (in millimeters) |
| left_margin_mm | int | 0 | Left margin (in millimeters) |
| top_margin_mm | int | 0 | Top margin (in millimeters) |
| bottom_margin_mm | int | 0 | Bottom margin (in millimeters) |
| ignore_bar_color | boolean | false | If true, statusbar_color and navigationbar_color (theme.xml) will be ignored |
| show_app_installed | boolean | true | If true, you will receive a message when you install an app |
| show_app_uninstalled | boolean | true | If true, you will receive a message when you uninstall an app |
| Name | Type | Default | Description |
|---|---|---|---|
| show_notifications | boolean | false | If true, t-ui will show notifications that appears in status bar |
| app_notification_enabled_default | boolean | true | If true, t-ui will show notifications from all apps, unless they are explicitly excluded. If false, t-ui won't show a notification from a specific app unless it was explicitly included |
| default_notification_color | Color | "#00FF00" | The default color of notifications |
| notification_format | Notification format | "[%t] %pkg: %ttl --- %txt" | See Notification format for more details |
| click_notification | boolean | true | If true, T-UI will perform the operation associated with the original notification |
| long_click_notification | boolean | true | If true, you will be able to perform some quick operations long-clicking a notification |
| Name | Type | Default | Description |
|---|---|---|---|
| default_app_n1 | app | "most_used" | The first default-suggested app |
| default_app_n2 | app | "most_used" | The second default-suggested app |
| default_app_n3 | app | "com.android.vending" | The third default-suggested app |
| default_app_n4 | app | "null" | The fourth default-suggested app |
| default_app_n5 | app | "null" | The fifth default-suggested app |
Check also Set default-apps.
| Name | Type | Default | Description |
|---|---|---|---|
| rss_default_color | Color | #f44336 | The default color |
| rss_default_format | RSS format | "%[50][green]title ### %[100][teal]description (%pubDate)" | The default format |
| include_rss_default | boolean | true | If true, a filter will exclude an item if it matches. If false, a filter will include an item if it matches |
| rss_hidden_tags | String | "img" | A list of excluded tags (separated by comma) |
| rss_time_format | String | "%t0" | The time format used by RSS items |
| show_rss_download | boolean | true | If true, you will see a message when T-UI downloads a feed |
| rss_download_format | Download message format | "RSS: %id --- Downloaded %sb bytes" | The message shown when an RSS feed is downloaded |
| rss_download_message_color | Color | aqua | The color of the download message |
| click_rss | boolean | true | If true, you will be able to click on an RSS item to open the corresponding webpage |
Francesco Andreuzzi, Italy, [email protected]