Ignore local Android tool cache

.gitignore

@@ -1,4 +1,5 @@
 .gradle/
+.ci/
 build/
 app/build/
 local.properties
@@ -6,4 +7,3 @@ signing.properties
 *.jks
 *.keystore
 release/
-

app/build.gradle.kts

@@ -14,6 +14,8 @@ val defaultGithubUpdateUrl = providers.gradleProperty("defaultGithubUpdateUrl")
     .orElse("https://github.com/${repoSlug.get()}/releases/latest/download/latest.json")
 val defaultGiteaUpdateUrl = providers.gradleProperty("defaultGiteaUpdateUrl")
     .orElse("https://gitea.neatcn.com/api/v1/repos/tmux/tmux-browser-android/releases/latest")
+val defaultPreviewUpdateUrl = providers.gradleProperty("defaultPreviewUpdateUrl")
+    .orElse("https://gitea.neatcn.com/tmux/tmux-browser-android/releases/download/preview/latest.json")
 val defaultApkUrl = providers.gradleProperty("defaultApkUrl")
     .orElse("https://github.com/${repoSlug.get()}/releases/latest/download/tmux-android.apk")
 val defaultReleasePageUrl = providers.gradleProperty("defaultReleasePageUrl")
@@ -40,6 +42,7 @@ android {
         buildConfigField("String", "DEFAULT_UPDATE_URL", "\"${defaultUpdateUrl.get()}\"")
         buildConfigField("String", "DEFAULT_GITHUB_UPDATE_URL", "\"${defaultGithubUpdateUrl.get()}\"")
         buildConfigField("String", "DEFAULT_GITEA_UPDATE_URL", "\"${defaultGiteaUpdateUrl.get()}\"")
+        buildConfigField("String", "DEFAULT_PREVIEW_UPDATE_URL", "\"${defaultPreviewUpdateUrl.get()}\"")
         buildConfigField("String", "DEFAULT_APK_URL", "\"${defaultApkUrl.get()}\"")
         buildConfigField("String", "DEFAULT_RELEASE_PAGE_URL", "\"${defaultReleasePageUrl.get()}\"")
     }

app/src/main/java/com/neatstudio/tmuxandroid/MainActivity.java

@@ -19,6 +19,7 @@ import android.net.Uri;
 import android.os.Build;
 import android.os.Bundle;
 import android.provider.Settings;
+import android.text.TextUtils;
 import android.text.InputType;
 import android.view.Gravity;
 import android.view.HapticFeedbackConstants;
@@ -65,6 +66,23 @@ public final class MainActivity extends Activity {
     private static final int STATUS_SUCCESS = 2;
     private static final int STATUS_ERROR = 3;
     private static final long TERMINAL_RENDER_INTERVAL_MS = 80L;
+    private static final int COLOR_APP_BG = Color.rgb(9, 11, 13);
+    private static final int COLOR_BAR = Color.rgb(15, 18, 21);
+    private static final int COLOR_PANEL = Color.rgb(22, 26, 30);
+    private static final int COLOR_CARD = Color.rgb(26, 31, 36);
+    private static final int COLOR_CARD_ALT = Color.rgb(31, 37, 43);
+    private static final int COLOR_FIELD = Color.rgb(12, 15, 18);
+    private static final int COLOR_TERMINAL_BG = Color.rgb(2, 4, 6);
+    private static final int COLOR_BORDER = Color.rgb(55, 64, 72);
+    private static final int COLOR_BORDER_SOFT = Color.rgb(39, 46, 53);
+    private static final int COLOR_TEXT = Color.rgb(238, 242, 246);
+    private static final int COLOR_TEXT_MUTED = Color.rgb(151, 163, 174);
+    private static final int COLOR_TEXT_DIM = Color.rgb(112, 124, 136);
+    private static final int COLOR_ACCENT = Color.rgb(65, 218, 199);
+    private static final int COLOR_ACCENT_DARK = Color.rgb(13, 61, 55);
+    private static final int COLOR_ACCENT_WARM = Color.rgb(243, 185, 82);
+    private static final int COLOR_SUCCESS = Color.rgb(91, 213, 139);
+    private static final int COLOR_DANGER = Color.rgb(235, 103, 111);
     private static final String OLD_LOCAL_DEFAULT_URL = "http://127.0.0.1:3000";
     private static final String OLD_GITHUB_DEFAULT_UPDATE_URL = "https://github.com/neatstudio/tmux-browser-android/releases/latest/download/latest.json";
     private static final String DEFAULT_TAILSCALE_URL = "http://100.89.0.116:3000";
@@ -96,10 +114,16 @@ public final class MainActivity extends Activity {
     private TextView sessionSummaryText;
     private LinearLayout projectList;
     private TextView terminalText;
+    private TextView terminalMetaText;
     private ScrollView terminalScroll;
     private EditText inputField;
+    private Button terminalKeyPageButton;
     private View terminalComposerBar;
+    private LinearLayout terminalGroupRow;
     private String activeSessionName;
+    private String terminalPathStatus = "";
+    private String terminalSocketStatus = "";
+    private String terminalEventStatus = "";
     private String activeMainPage = PAGE_SERVERS;
     private String pendingImageUploadSession;
     private TerminalScreenBuffer terminalScreen = new TerminalScreenBuffer(DEFAULT_TERMINAL_COLS, DEFAULT_TERMINAL_ROWS);
@@ -133,8 +157,8 @@ public final class MainActivity extends Activity {
         }
         migrateDefaultUpdateSourceToGitea();
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
-            getWindow().setStatusBarColor(Color.rgb(17, 20, 24));
+            getWindow().setStatusBarColor(COLOR_APP_BG);
-            getWindow().setNavigationBarColor(Color.rgb(17, 20, 24));
+            getWindow().setNavigationBarColor(COLOR_APP_BG);
         }
         getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_NOTHING);
         api = new SessionApiClient(getServerUrl());
@@ -158,17 +182,17 @@ public final class MainActivity extends Activity {
     private View createRoot() {
         root = new LinearLayout(this);
         root.setOrientation(LinearLayout.VERTICAL);
-        root.setBackgroundColor(Color.rgb(17, 20, 24));
+        root.setBackgroundColor(COLOR_APP_BG);
 
         progressBar = new ProgressBar(this, null, android.R.attr.progressBarStyleHorizontal);
         progressBar.setIndeterminate(true);
         progressBar.setVisibility(View.GONE);
 
         statusText = new TextView(this);
-        statusText.setTextColor(Color.rgb(210, 215, 224));
+        statusText.setTextColor(COLOR_TEXT_MUTED);
-        statusText.setTextSize(12);
+        statusText.setTextSize(11);
         statusText.setGravity(Gravity.CENTER_VERTICAL);
-        statusText.setPadding(dp(10), 0, dp(10), 0);
+        statusText.setPadding(dp(12), 0, dp(12), 0);
         statusText.setSingleLine(true);
         setStatus("Ready");
         applySystemBarInsets(root);
@@ -247,12 +271,12 @@ public final class MainActivity extends Activity {
         String label = url.replace("http://", "").replace(":3000", "");
         LinearLayout card = new LinearLayout(this);
         card.setOrientation(LinearLayout.VERTICAL);
-        card.setPadding(dp(12), dp(11), dp(12), dp(11));
+        card.setPadding(dp(12), dp(10), dp(12), dp(10));
-        card.setBackground(rounded(Color.rgb(27, 33, 40), 8, Color.rgb(45, 54, 64), 1));
+        card.setBackground(cardBackground());
 
         TextView title = new TextView(this);
         title.setText(label);
-        title.setTextColor(Color.WHITE);
+        title.setTextColor(COLOR_TEXT);
         title.setTextSize(16);
         title.setTypeface(Typeface.DEFAULT_BOLD);
         TextView meta = bodyText(url);
@@ -486,6 +510,7 @@ public final class MainActivity extends Activity {
                 actionButton("Auto check", view -> updateManager.check(true)),
                 actionButton("Gitea", view -> updateManager.checkGitea(true)),
                 actionButton("GitHub", view -> updateManager.checkGithub(true)),
+                actionButton("Preview", view -> updateManager.checkPreview(true)),
                 actionButton("Selected", view -> updateManager.checkSelected(true)),
                 actionButton("Source", view -> showUpdateSourcePicker()),
                 actionButton("APK", view -> updateManager.openApkDownload())
@@ -569,7 +594,7 @@ public final class MainActivity extends Activity {
         LinearLayout toolbar = new LinearLayout(this);
         toolbar.setOrientation(LinearLayout.VERTICAL);
         toolbar.setPadding(dp(8), dp(6), dp(8), dp(6));
-        toolbar.setBackgroundColor(Color.rgb(17, 20, 24));
+        toolbar.setBackgroundColor(COLOR_BAR);
 
         LinearLayout urlRow = new LinearLayout(this);
         urlRow.setOrientation(LinearLayout.HORIZONTAL);
@@ -577,8 +602,8 @@ public final class MainActivity extends Activity {
 
         urlField = new EditText(this);
         urlField.setSingleLine(true);
-        urlField.setTextColor(Color.WHITE);
+        urlField.setTextColor(COLOR_TEXT);
-        urlField.setHintTextColor(Color.rgb(150, 158, 168));
+        urlField.setHintTextColor(COLOR_TEXT_DIM);
         urlField.setTextSize(14);
         urlField.setInputType(InputType.TYPE_TEXT_VARIATION_URI);
         urlField.setImeOptions(EditorInfo.IME_ACTION_GO);
@@ -644,7 +669,7 @@ public final class MainActivity extends Activity {
     private HorizontalScrollView createServerProfileBar() {
         HorizontalScrollView scroller = new HorizontalScrollView(this);
         scroller.setHorizontalScrollBarEnabled(false);
-        scroller.setBackgroundColor(Color.rgb(22, 27, 34));
+        scroller.setBackgroundColor(COLOR_BAR);
 
         LinearLayout row = new LinearLayout(this);
         row.setOrientation(LinearLayout.HORIZONTAL);
@@ -676,12 +701,12 @@ public final class MainActivity extends Activity {
     private HorizontalScrollView createMainTabs(String selected) {
         HorizontalScrollView scroller = new HorizontalScrollView(this);
         scroller.setHorizontalScrollBarEnabled(false);
-        scroller.setBackgroundColor(Color.rgb(17, 20, 24));
+        scroller.setBackgroundColor(COLOR_APP_BG);
 
         LinearLayout row = new LinearLayout(this);
         row.setOrientation(LinearLayout.HORIZONTAL);
         row.setGravity(Gravity.CENTER_VERTICAL);
-        row.setPadding(dp(8), dp(4), dp(8), dp(4));
+        row.setPadding(dp(8), dp(5), dp(8), dp(5));
         row.addView(navButton(PAGE_SERVERS, selected, view -> renderServerScreen()));
         row.addView(navButton(PAGE_SESSIONS, selected, view -> openSessionPage()));
         row.addView(navButton(PAGE_PROJECTS, selected, view -> renderProjectsScreen()));
@@ -699,26 +724,26 @@ public final class MainActivity extends Activity {
     private Button navButton(String label, String selected, View.OnClickListener listener) {
         Button button = toolbarButton(label, listener);
         boolean active = label.equals(selected);
-        button.setTextColor(active ? Color.rgb(8, 12, 18) : Color.rgb(235, 241, 248));
+        button.setTextColor(active ? Color.rgb(5, 18, 18) : COLOR_TEXT);
         button.setBackground(active
-                ? rounded(Color.rgb(86, 211, 219), 8, Color.rgb(86, 211, 219), 1)
+                ? rounded(COLOR_ACCENT, 8, COLOR_ACCENT, 1)
                 : buttonBackground());
-        button.setMinWidth(dp(82));
+        button.setMinWidth(dp(74));
-        button.setMinimumWidth(dp(82));
+        button.setMinimumWidth(dp(74));
         return button;
     }
 
     private LinearLayout pageContent() {
         LinearLayout content = new LinearLayout(this);
         content.setOrientation(LinearLayout.VERTICAL);
-        content.setPadding(dp(10), dp(10), dp(10), dp(14));
+        content.setPadding(dp(10), dp(9), dp(10), dp(14));
         return content;
     }
 
     private TextView sectionTitle(String text) {
         TextView title = new TextView(this);
         title.setText(text);
-        title.setTextColor(Color.rgb(139, 148, 158));
+        title.setTextColor(COLOR_ACCENT_WARM);
         title.setTextSize(12);
         title.setTypeface(Typeface.DEFAULT_BOLD);
         title.setPadding(dp(2), dp(12), dp(2), dp(6));
@@ -729,11 +754,11 @@ public final class MainActivity extends Activity {
         LinearLayout block = new LinearLayout(this);
         block.setOrientation(LinearLayout.VERTICAL);
         block.setPadding(dp(12), dp(10), dp(12), dp(10));
-        block.setBackground(rounded(Color.rgb(27, 33, 40), 8, Color.rgb(45, 54, 64), 1));
+        block.setBackground(cardBackground());
 
         TextView heading = new TextView(this);
         heading.setText(title);
-        heading.setTextColor(Color.WHITE);
+        heading.setTextColor(COLOR_TEXT);
         heading.setTextSize(16);
         heading.setTypeface(Typeface.DEFAULT_BOLD);
 
@@ -765,8 +790,8 @@ public final class MainActivity extends Activity {
     private LinearLayout actionPanel(Button... buttons) {
         LinearLayout panel = new LinearLayout(this);
         panel.setOrientation(LinearLayout.VERTICAL);
-        panel.setPadding(dp(7), dp(7), dp(7), dp(2));
+        panel.setPadding(dp(6), dp(6), dp(6), dp(1));
-        panel.setBackground(rounded(Color.rgb(24, 30, 37), 8, Color.rgb(42, 51, 61), 1));
+        panel.setBackground(panelBackground());
         LinearLayout row = null;
         for (int index = 0; index < buttons.length; index++) {
             if (index % 2 == 0) {
@@ -774,7 +799,7 @@ public final class MainActivity extends Activity {
                 row.setOrientation(LinearLayout.HORIZONTAL);
                 panel.addView(row, matchWrap());
             }
-            LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(0, dp(42), 1);
+            LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(0, dp(38), 1);
             params.leftMargin = dp(3);
             params.rightMargin = dp(3);
             params.bottomMargin = dp(6);
@@ -894,7 +919,7 @@ public final class MainActivity extends Activity {
         view.setTypeface(Typeface.MONOSPACE);
         view.setTextIsSelectable(true);
         view.setPadding(dp(12), dp(10), dp(12), dp(10));
-        view.setBackground(rounded(Color.rgb(12, 17, 23), 8, Color.rgb(42, 51, 61), 1));
+        view.setBackground(rounded(COLOR_FIELD, 8, COLOR_BORDER_SOFT, 1));
         return view;
     }
 
@@ -907,12 +932,12 @@ public final class MainActivity extends Activity {
 
         LinearLayout card = new LinearLayout(this);
         card.setOrientation(LinearLayout.VERTICAL);
-        card.setPadding(dp(12), dp(11), dp(12), dp(11));
+        card.setPadding(dp(12), dp(10), dp(12), dp(10));
-        card.setBackground(rounded(Color.rgb(27, 33, 40), 8, Color.rgb(45, 54, 64), 1));
+        card.setBackground(cardBackground());
 
         TextView title = new TextView(this);
         title.setText(name);
-        title.setTextColor(Color.WHITE);
+        title.setTextColor(COLOR_TEXT);
         title.setTextSize(17);
         title.setTypeface(Typeface.DEFAULT_BOLD);
 
@@ -934,7 +959,7 @@ public final class MainActivity extends Activity {
 
         if (agents != null && agents.length() > 0) {
             TextView agentsTitle = bodyText("Agents");
-            agentsTitle.setTextColor(Color.rgb(139, 148, 158));
+            agentsTitle.setTextColor(COLOR_TEXT_DIM);
             agentsTitle.setTypeface(Typeface.DEFAULT_BOLD);
             agentsTitle.setPadding(0, dp(10), 0, dp(4));
             card.addView(agentsTitle);
@@ -999,15 +1024,15 @@ public final class MainActivity extends Activity {
     private View sessionRow(SessionSummary session) {
         LinearLayout row = new LinearLayout(this);
         row.setOrientation(LinearLayout.VERTICAL);
-        row.setPadding(dp(12), dp(11), dp(12), dp(11));
+        row.setPadding(dp(12), dp(10), dp(12), dp(10));
-        row.setBackground(rounded(Color.rgb(27, 33, 40), 8, Color.rgb(45, 54, 64), 1));
+        row.setBackground(cardBackground());
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
             row.setElevation(dp(1));
         }
 
         TextView title = new TextView(this);
         title.setText(session.name);
-        title.setTextColor(Color.WHITE);
+        title.setTextColor(COLOR_TEXT);
         title.setTextSize(17);
         title.setTypeface(Typeface.DEFAULT_BOLD);
 
@@ -1087,6 +1112,7 @@ public final class MainActivity extends Activity {
     }
 
     private void openTerminal(String sessionName) {
+        closeTerminalSocket();
         activeSessionName = sessionName;
         projectList = null;
         terminalScreen = new TerminalScreenBuffer(DEFAULT_TERMINAL_COLS, DEFAULT_TERMINAL_ROWS);
@@ -1096,17 +1122,24 @@ public final class MainActivity extends Activity {
         terminalSelectionEnabled = false;
         terminalFollowOutput = true;
         terminalKeyPage = 0;
+        terminalPathStatus = "path loading";
+        terminalSocketStatus = "terminal idle";
+        terminalEventStatus = "events listening";
         lastTerminalRenderMs = 0L;
         terminalCols = DEFAULT_TERMINAL_COLS;
         terminalRows = DEFAULT_TERMINAL_ROWS;
         root.removeAllViews();
         root.addView(createTerminalTopBar(sessionName), matchWrap());
+        root.addView(createTerminalGroupBar(), new LinearLayout.LayoutParams(
+                ViewGroup.LayoutParams.MATCH_PARENT,
+                dp(38)
+        ));
 
         terminalScroll = new ScrollView(this);
         terminalScroll.setFillViewport(true);
-        terminalScroll.setBackgroundColor(Color.rgb(4, 7, 10));
+        terminalScroll.setBackgroundColor(COLOR_TERMINAL_BG);
         terminalText = new TextView(this);
-        terminalText.setTextColor(Color.rgb(230, 235, 242));
+        terminalText.setTextColor(COLOR_TEXT);
         terminalText.setTextSize(13);
         terminalText.setTypeface(Typeface.MONOSPACE);
         terminalText.setIncludeFontPadding(false);
@@ -1114,7 +1147,7 @@ public final class MainActivity extends Activity {
         terminalText.setGravity(Gravity.BOTTOM | Gravity.START);
         terminalText.setTextIsSelectable(terminalSelectionEnabled);
         terminalText.setPadding(dp(10), dp(10), dp(10), dp(10));
-        terminalText.setBackgroundColor(Color.rgb(4, 7, 10));
+        terminalText.setBackgroundColor(COLOR_TERMINAL_BG);
         terminalScroll.addView(terminalText, new ScrollView.LayoutParams(
                 ViewGroup.LayoutParams.MATCH_PARENT,
                 ViewGroup.LayoutParams.WRAP_CONTENT
@@ -1141,6 +1174,8 @@ public final class MainActivity extends Activity {
         terminalScroll.post(() -> {
             resizeTerminalToViewport(false);
             connectTerminal(sessionName);
+            refreshTerminalGroupSessions(sessionName);
+            refreshTerminalSessionMeta(sessionName);
         });
         inputField.post(() -> {
             inputField.requestFocus();
@@ -1152,21 +1187,210 @@ public final class MainActivity extends Activity {
         LinearLayout bar = new LinearLayout(this);
         bar.setOrientation(LinearLayout.HORIZONTAL);
         bar.setGravity(Gravity.CENTER_VERTICAL);
-        bar.setPadding(dp(8), dp(6), dp(8), dp(6));
+        bar.setPadding(dp(5), dp(3), dp(5), dp(3));
-        bar.setBackgroundColor(Color.rgb(17, 20, 24));
+        bar.setBackgroundColor(COLOR_BAR);
-        bar.addView(toolbarButton("Back", view -> openSessionPage()));
+        bar.addView(terminalToolButton("‹", view -> openSessionPage()));
+
+        LinearLayout titleBlock = new LinearLayout(this);
+        titleBlock.setOrientation(LinearLayout.VERTICAL);
+        titleBlock.setGravity(Gravity.CENTER_VERTICAL);
+        titleBlock.setPadding(dp(8), 0, dp(8), 0);
+
         TextView title = new TextView(this);
         title.setText(sessionName);
-        title.setTextColor(Color.WHITE);
+        title.setTextColor(COLOR_TEXT);
-        title.setTextSize(16);
+        title.setTextSize(14);
         title.setTypeface(Typeface.DEFAULT_BOLD);
-        title.setPadding(dp(10), 0, dp(10), 0);
+        title.setSingleLine(true);
-        bar.addView(title, new LinearLayout.LayoutParams(0, dp(42), 1));
+        title.setEllipsize(TextUtils.TruncateAt.END);
-        bar.addView(toolbarButton("Reconnect", view -> connectTerminal(sessionName)));
+        title.setIncludeFontPadding(false);
-        bar.addView(toolbarButton("More", view -> showTerminalActions(sessionName)));
+
+        terminalMetaText = new TextView(this);
+        terminalMetaText.setTextColor(COLOR_TEXT_DIM);
+        terminalMetaText.setTextSize(10);
+        terminalMetaText.setSingleLine(true);
+        terminalMetaText.setEllipsize(TextUtils.TruncateAt.MIDDLE);
+        terminalMetaText.setIncludeFontPadding(false);
+        updateTerminalMeta();
+
+        titleBlock.addView(title, new LinearLayout.LayoutParams(
+                ViewGroup.LayoutParams.MATCH_PARENT,
+                dp(18)
+        ));
+        titleBlock.addView(terminalMetaText, new LinearLayout.LayoutParams(
+                ViewGroup.LayoutParams.MATCH_PARENT,
+                dp(14)
+        ));
+        bar.addView(titleBlock, new LinearLayout.LayoutParams(0, dp(34), 1));
+        bar.addView(terminalToolButton("↻", view -> connectTerminal(sessionName)));
+        bar.addView(terminalToolButton("⋯", view -> showTerminalActions(sessionName)));
         return bar;
     }
 
+    private HorizontalScrollView createTerminalGroupBar() {
+        HorizontalScrollView scroller = new HorizontalScrollView(this);
+        scroller.setHorizontalScrollBarEnabled(false);
+        scroller.setBackgroundColor(COLOR_PANEL);
+
+        terminalGroupRow = new LinearLayout(this);
+        terminalGroupRow.setOrientation(LinearLayout.HORIZONTAL);
+        terminalGroupRow.setGravity(Gravity.CENTER_VERTICAL);
+        terminalGroupRow.setPadding(dp(5), dp(3), dp(5), dp(3));
+        terminalGroupRow.addView(groupLabel("group..."));
+
+        scroller.addView(terminalGroupRow, new HorizontalScrollView.LayoutParams(
+                ViewGroup.LayoutParams.WRAP_CONTENT,
+                ViewGroup.LayoutParams.MATCH_PARENT
+        ));
+        return scroller;
+    }
+
+    private void refreshTerminalGroupSessions(String sessionName) {
+        executor.execute(() -> {
+            try {
+                String text = api.kanbanProjects();
+                runOnUiThread(() -> renderTerminalGroupSessions(sessionName, text));
+            } catch (Exception error) {
+                runOnUiThread(() -> {
+                    if (sessionName.equals(activeSessionName) && terminalGroupRow != null) {
+                        terminalGroupRow.removeAllViews();
+                        terminalGroupRow.addView(groupLabel("group failed"));
+                    }
+                });
+            }
+        });
+    }
+
+    private void refreshTerminalSessionMeta(String sessionName) {
+        executor.execute(() -> {
+            try {
+                List<SessionSummary> sessions = api.getSessions();
+                String path = "";
+                String command = "";
+                for (SessionSummary session : sessions) {
+                    if (sessionName.equals(session.name)) {
+                        path = defaultValue(session.currentPath, "");
+                        command = defaultValue(session.currentCommand, "");
+                        break;
+                    }
+                }
+                String meta = path.isEmpty() ? "path unavailable" : path;
+                if (!command.isEmpty()) {
+                    meta = meta + "  ·  " + command;
+                }
+                String finalMeta = meta;
+                runOnUiThread(() -> {
+                    if (sessionName.equals(activeSessionName)) {
+                        terminalPathStatus = finalMeta;
+                        updateTerminalMeta();
+                    }
+                });
+            } catch (Exception error) {
+                runOnUiThread(() -> {
+                    if (sessionName.equals(activeSessionName)) {
+                        terminalPathStatus = "path unavailable";
+                        updateTerminalMeta();
+                    }
+                });
+            }
+        });
+    }
+
+    private void updateTerminalMeta() {
+        if (terminalMetaText == null) {
+            return;
+        }
+        StringBuilder meta = new StringBuilder();
+        meta.append(defaultValue(terminalPathStatus, "path loading"));
+        if (!terminalSocketStatus.isEmpty()) {
+            meta.append("  ·  ").append(terminalSocketStatus);
+        }
+        if (!terminalEventStatus.isEmpty()) {
+            meta.append("  ·  ").append(terminalEventStatus);
+        }
+        terminalMetaText.setText(meta.toString());
+    }
+
+    private void renderTerminalGroupSessions(String sessionName, String text) {
+        if (!sessionName.equals(activeSessionName) || terminalGroupRow == null) {
+            return;
+        }
+        terminalGroupRow.removeAllViews();
+        try {
+            JSONObject rootObject = new JSONObject(text == null || text.isEmpty() ? "{}" : text);
+            JSONArray projects = rootObject.optJSONArray("projects");
+            if (projects == null) {
+                terminalGroupRow.addView(groupLabel("no group"));
+                return;
+            }
+            for (int projectIndex = 0; projectIndex < projects.length(); projectIndex++) {
+                JSONObject project = projects.optJSONObject(projectIndex);
+                if (project == null) {
+                    continue;
+                }
+                JSONArray agents = project.optJSONArray("agents");
+                if (!projectContainsSession(agents, sessionName)) {
+                    continue;
+                }
+                terminalGroupRow.addView(groupLabel(compactLabel(project.optString("name", "group"), 14)));
+                for (int agentIndex = 0; agents != null && agentIndex < agents.length(); agentIndex++) {
+                    JSONObject agent = agents.optJSONObject(agentIndex);
+                    String agentSession = agentSessionName(agent);
+                    if (!agentSession.isEmpty()) {
+                        terminalGroupRow.addView(groupSessionButton(agentSession, agentSession.equals(sessionName)));
+                    }
+                }
+                return;
+            }
+            terminalGroupRow.addView(groupLabel("no group"));
+        } catch (Exception error) {
+            terminalGroupRow.addView(groupLabel("group parse"));
+        }
+    }
+
+    private boolean projectContainsSession(JSONArray agents, String sessionName) {
+        if (agents == null) {
+            return false;
+        }
+        for (int index = 0; index < agents.length(); index++) {
+            if (sessionName.equals(agentSessionName(agents.optJSONObject(index)))) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    private String agentSessionName(JSONObject agent) {
+        if (agent == null) {
+            return "";
+        }
+        return defaultValue(agent.optString("sessionName", ""), agent.optString("name", ""));
+    }
+
+    private TextView groupLabel(String text) {
+        TextView label = new TextView(this);
+        label.setText(text);
+        label.setTextColor(COLOR_TEXT_DIM);
+        label.setTextSize(11);
+        label.setTypeface(Typeface.DEFAULT_BOLD);
+        label.setGravity(Gravity.CENTER_VERTICAL);
+        label.setPadding(dp(5), 0, dp(6), 0);
+        return label;
+    }
+
+    private Button groupSessionButton(String sessionName, boolean active) {
+        Button button = terminalToolButton(compactLabel(sessionName, 12), view -> {
+            if (!sessionName.equals(activeSessionName)) {
+                openTerminal(sessionName);
+            }
+        });
+        if (active) {
+            button.setTextColor(Color.rgb(5, 18, 18));
+            button.setBackground(rounded(COLOR_ACCENT, 7, COLOR_ACCENT, 1));
+        }
+        return button;
+    }
+
     private void showSessionActions(String sessionName) {
         String[] items = {
                 "Status",
@@ -1311,15 +1535,23 @@ public final class MainActivity extends Activity {
         LinearLayout bar = new LinearLayout(this);
         bar.setOrientation(LinearLayout.VERTICAL);
         bar.setPadding(dp(8), dp(5), dp(8), dp(6));
-        bar.setBackgroundColor(Color.rgb(17, 20, 24));
+        bar.setBackgroundColor(COLOR_BAR);
 
         LinearLayout row = new LinearLayout(this);
         row.setOrientation(LinearLayout.HORIZONTAL);
         row.setGravity(Gravity.BOTTOM);
 
+        terminalKeyPageButton = terminalPageButton();
+        LinearLayout.LayoutParams pageParams = new LinearLayout.LayoutParams(
+                dp(70),
+                dp(48)
+        );
+        pageParams.rightMargin = dp(6);
+        row.addView(terminalKeyPageButton, pageParams);
+
         inputField = new EditText(this);
-        inputField.setTextColor(Color.WHITE);
+        inputField.setTextColor(COLOR_TEXT);
-        inputField.setHintTextColor(Color.rgb(150, 158, 168));
+        inputField.setHintTextColor(COLOR_TEXT_DIM);
         inputField.setHint("type, edit, paste");
         inputField.setSingleLine(false);
         inputField.setMinLines(1);
@@ -1349,6 +1581,10 @@ public final class MainActivity extends Activity {
             return false;
         });
         row.addView(inputField, new LinearLayout.LayoutParams(0, ViewGroup.LayoutParams.WRAP_CONTENT, 1));
+        row.addView(toolbarButton("Type", view -> sendTypedText()), new LinearLayout.LayoutParams(
+                ViewGroup.LayoutParams.WRAP_CONTENT,
+                dp(48)
+        ));
         row.addView(toolbarButton("Send", view -> sendLine()), new LinearLayout.LayoutParams(
                 ViewGroup.LayoutParams.WRAP_CONTENT,
                 dp(48)
@@ -1601,7 +1837,7 @@ public final class MainActivity extends Activity {
         text.append("Tap Release on the About page. The app resolves the page from the selected update source.\n");
         text.append('\n');
         text.append("In-app update:\n");
-        text.append("Tap Auto check on the Update page to try Gitea first and GitHub only if Gitea cannot be reached. Use Gitea, GitHub, or Selected to force one source. Each source retries transient network failures before failing. The app downloads one APK per version, verifies SHA-256, then opens Android's installer.\n");
+        text.append("Tap Auto check on the Update page to try Gitea first and GitHub only if Gitea cannot be reached. Use Gitea, GitHub, Preview, or Selected to force one source. Preview resolves the mutable Gitea preview attachment for fast UI testing. Each source retries transient network failures before failing. The app downloads one APK per version, verifies SHA-256, then opens Android's installer.\n");
         text.append("Selected manifest: ")
                 .append(updateSourceHost())
                 .append('\n')
@@ -1610,6 +1846,7 @@ public final class MainActivity extends Activity {
         text.append("Available sources:\n");
         text.append("Gitea default: ").append(BuildConfig.DEFAULT_GITEA_UPDATE_URL).append('\n');
         text.append("GitHub optional: ").append(BuildConfig.DEFAULT_GITHUB_UPDATE_URL).append('\n');
+        text.append("Preview manual: ").append(BuildConfig.DEFAULT_PREVIEW_UPDATE_URL).append('\n');
         text.append('\n');
         text.append(permissionSummary());
 
@@ -1648,6 +1885,7 @@ public final class MainActivity extends Activity {
         String[] items = {
                 "Gitea default: " + BuildConfig.DEFAULT_GITEA_UPDATE_URL,
                 "GitHub optional: " + BuildConfig.DEFAULT_GITHUB_UPDATE_URL,
+                "Preview manual: " + BuildConfig.DEFAULT_PREVIEW_UPDATE_URL,
                 "Custom URL"
         };
         new AlertDialog.Builder(this)
@@ -1657,6 +1895,8 @@ public final class MainActivity extends Activity {
                         setUpdateUrl(BuildConfig.DEFAULT_GITEA_UPDATE_URL);
                     } else if (which == 1) {
                         setUpdateUrl(BuildConfig.DEFAULT_GITHUB_UPDATE_URL);
+                    } else if (which == 2) {
+                        setUpdateUrl(BuildConfig.DEFAULT_PREVIEW_UPDATE_URL);
                     } else {
                         promptText("Custom update manifest", "https://.../latest.json", prefs.getString("update_url", BuildConfig.DEFAULT_UPDATE_URL), this::setUpdateUrl);
                     }
@@ -1909,7 +2149,7 @@ public final class MainActivity extends Activity {
     private HorizontalScrollView createAccessoryBar() {
         HorizontalScrollView scroller = new HorizontalScrollView(this);
         scroller.setHorizontalScrollBarEnabled(false);
-        scroller.setBackgroundColor(Color.rgb(22, 27, 34));
+        scroller.setBackgroundColor(COLOR_PANEL);
 
         LinearLayout pad = new LinearLayout(this);
         pad.setOrientation(LinearLayout.VERTICAL);
@@ -1917,10 +2157,7 @@ public final class MainActivity extends Activity {
 
         LinearLayout firstRow = terminalKeyRow();
         LinearLayout secondRow = terminalKeyRow();
-        addAccessoryButton(firstRow, "<", view -> setTerminalKeyPage(terminalKeyPage - 1));
-        addPageLabel(firstRow);
         addAccessoryPageKeys(firstRow, secondRow);
-        addAccessoryButton(firstRow, ">", view -> setTerminalKeyPage(terminalKeyPage + 1));
         pad.addView(firstRow, new LinearLayout.LayoutParams(
                 ViewGroup.LayoutParams.WRAP_CONTENT,
                 0,
@@ -1946,16 +2183,6 @@ public final class MainActivity extends Activity {
         return row;
     }
 
-    private void addPageLabel(LinearLayout row) {
-        TextView label = new TextView(this);
-        label.setText(accessoryPageName());
-        label.setTextColor(Color.rgb(139, 148, 158));
-        label.setTextSize(11);
-        label.setGravity(Gravity.CENTER);
-        label.setTypeface(Typeface.DEFAULT_BOLD);
-        row.addView(label, new LinearLayout.LayoutParams(dp(44), ViewGroup.LayoutParams.MATCH_PARENT));
-    }
-
     private void addAccessoryPageKeys(LinearLayout topRow, LinearLayout bottomRow) {
         switch (terminalKeyPage) {
             case 1:
@@ -1975,12 +2202,12 @@ public final class MainActivity extends Activity {
                 addSoftKey(topRow, "→", "\u001b[C");
                 addSoftKey(topRow, "↑", "\u001b[A");
                 addSoftKey(topRow, "↓", "\u001b[B");
-                addSoftKey(topRow, "Home", "\u001b[H");
+                addSoftKey(topRow, "Hm", "\u001b[H");
                 addSoftKey(bottomRow, "End", "\u001b[F");
-                addSoftKey(bottomRow, "PgUp", "\u001b[5~");
+                addSoftKey(bottomRow, "Pg↑", "\u001b[5~");
-                addSoftKey(bottomRow, "PgDn", "\u001b[6~");
+                addSoftKey(bottomRow, "Pg↓", "\u001b[6~");
-                addSoftKey(bottomRow, "Tmux", "\u0002");
+                addSoftKey(bottomRow, "^B", "\u0002");
-                addSoftKey(bottomRow, "Detach", "\u0002d");
+                addSoftKey(bottomRow, "Dch", "\u0002d");
                 addSoftKey(bottomRow, "New", "\u0002c");
                 addSoftKey(bottomRow, "Prev", "\u0002p");
                 addSoftKey(bottomRow, "Next", "\u0002n");
@@ -2004,13 +2231,14 @@ public final class MainActivity extends Activity {
                 addSoftKey(topRow, "↑", "\u001b[A");
                 addSoftKey(topRow, "↓", "\u001b[B");
                 addSoftKey(topRow, "Enter", TERMINAL_ENTER);
+                addSoftKey(topRow, "Tab", "\t");
                 addAccessoryButton(topRow, "NL", view -> insertComposerText("\n"));
-                addSoftButton(bottomRow, "Paste", view -> pasteClipboard());
+                addSoftButton(bottomRow, "Pst", view -> pasteClipboard());
-                addAccessoryButton(bottomRow, "Back", view -> backspaceComposerText());
+                addAccessoryButton(bottomRow, "⌫", view -> backspaceComposerText());
-                addAccessoryButton(bottomRow, "Kbd", view -> showKeyboard());
+                addAccessoryButton(bottomRow, "⌨", view -> showKeyboard());
-                addAccessoryButton(bottomRow, "Hide", view -> hideKeyboard());
+                addAccessoryButton(bottomRow, "⌄", view -> hideKeyboard());
-                addAccessoryButton(bottomRow, "Bottom", view -> scrollTerminalBottom());
+                addAccessoryButton(bottomRow, "⇣", view -> scrollTerminalBottom());
-                addAccessoryButton(bottomRow, "Select", view -> toggleTerminalSelection());
+                addAccessoryButton(bottomRow, "Sel", view -> toggleTerminalSelection());
                 break;
         }
     }
@@ -2033,6 +2261,8 @@ public final class MainActivity extends Activity {
         closeTerminalSocket();
         queuedTerminalInput.setLength(0);
         terminalConnected = false;
+        terminalSocketStatus = "terminal connecting";
+        updateTerminalMeta();
         setStatus("Connecting " + sessionName);
         resizeTerminalToViewport(false);
         appendTerminal("[connecting]\r\n");
@@ -2041,6 +2271,8 @@ public final class MainActivity extends Activity {
             public void onConnected() {
                 runOnUiThread(() -> {
                     terminalConnected = true;
+                    terminalSocketStatus = "terminal connected";
+                    updateTerminalMeta();
                     setStatus("Connected " + sessionName);
                     resizeTerminalToViewport(true);
                     flushQueuedTerminalInput();
@@ -2056,6 +2288,8 @@ public final class MainActivity extends Activity {
             public void onError(String message) {
                 runOnUiThread(() -> {
                     appendTerminal("\r\n[error] " + message + "\r\n");
+                    terminalSocketStatus = "terminal error";
+                    updateTerminalMeta();
                     setStatus("Terminal error: " + message);
                 });
             }
@@ -2064,6 +2298,8 @@ public final class MainActivity extends Activity {
             public void onClosed() {
                 runOnUiThread(() -> {
                     terminalConnected = false;
+                    terminalSocketStatus = "terminal disconnected";
+                    updateTerminalMeta();
                     setStatus("Disconnected " + sessionName);
                 });
             }
@@ -2124,6 +2360,21 @@ public final class MainActivity extends Activity {
         setStatus("Sent " + text.length() + " chars");
     }
 
+    private void sendTypedText() {
+        if (inputField == null) {
+            return;
+        }
+        String text = inputField.getText().toString();
+        if (text.isEmpty()) {
+            return;
+        }
+        String normalized = text.replace("\r\n", "\n").replace('\r', '\n');
+        terminalFollowOutput = true;
+        sendTerminalInput(normalized);
+        inputField.setText("");
+        setStatus("Typed " + text.length() + " chars");
+    }
+
     private void sendTerminalInput(String data) {
         if (activeSessionName == null) {
             return;
@@ -2254,6 +2505,7 @@ public final class MainActivity extends Activity {
 
     private void setTerminalKeyPage(int page) {
         terminalKeyPage = (page + 4) % 4;
+        updateTerminalPageButton();
         if (activeSessionName != null) {
             renderTerminalControlsOnly();
         }
@@ -2365,16 +2617,21 @@ public final class MainActivity extends Activity {
     private Button toolbarButton(String label, View.OnClickListener listener) {
         Button button = new Button(this);
         button.setText(label);
-        button.setTextColor(Color.rgb(235, 241, 248));
+        button.setTextColor(COLOR_TEXT);
-        button.setTextSize(12);
+        button.setTextSize(11);
         button.setAllCaps(false);
         button.setTypeface(Typeface.DEFAULT_BOLD);
+        button.setIncludeFontPadding(false);
         button.setMinWidth(0);
         button.setMinimumWidth(0);
-        button.setPadding(dp(10), 0, dp(10), 0);
+        button.setPadding(dp(9), 0, dp(9), 0);
         button.setBackground(buttonBackground());
         button.setGravity(Gravity.CENTER);
         button.setHapticFeedbackEnabled(true);
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            button.setStateListAnimator(null);
+            button.setElevation(0);
+        }
         button.setOnClickListener(view -> {
             view.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY);
             view.animate().cancel();
@@ -2390,28 +2647,69 @@ public final class MainActivity extends Activity {
         });
         LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(
                 ViewGroup.LayoutParams.WRAP_CONTENT,
-                dp(42)
+                dp(38)
         );
-        params.leftMargin = dp(5);
+        params.leftMargin = dp(4);
         button.setLayoutParams(params);
         return button;
     }
 
+    private Button terminalToolButton(String label, View.OnClickListener listener) {
+        Button button = toolbarButton(label, listener);
+        button.setTextSize(label.length() <= 2 ? 16 : 10);
+        button.setPadding(dp(5), 0, dp(5), 0);
+        button.setMinWidth(dp(label.length() <= 2 ? 36 : 48));
+        button.setMinimumWidth(dp(label.length() <= 2 ? 36 : 48));
+        LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(
+                ViewGroup.LayoutParams.WRAP_CONTENT,
+                dp(30)
+        );
+        params.leftMargin = dp(2);
+        params.rightMargin = dp(2);
+        button.setLayoutParams(params);
+        return button;
+    }
+
+    private Button terminalPageButton() {
+        Button button = toolbarButton("", view -> setTerminalKeyPage(terminalKeyPage + 1));
+        button.setTextSize(10);
+        button.setPadding(dp(5), 0, dp(5), 0);
+        button.setMinWidth(dp(70));
+        button.setMinimumWidth(dp(70));
+        button.setOnLongClickListener(view -> {
+            view.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS);
+            setTerminalKeyPage(terminalKeyPage - 1);
+            return true;
+        });
+        updateTerminalPageButton(button);
+        return button;
+    }
+
+    private void updateTerminalPageButton() {
+        updateTerminalPageButton(terminalKeyPageButton);
+    }
+
+    private void updateTerminalPageButton(Button button) {
+        if (button != null) {
+            button.setText("‹ " + accessoryPageName() + " ›");
+        }
+    }
+
     private void styleInput(EditText input) {
-        input.setTextColor(Color.rgb(240, 246, 252));
+        input.setTextColor(COLOR_TEXT);
-        input.setHintTextColor(Color.rgb(139, 148, 158));
+        input.setHintTextColor(COLOR_TEXT_DIM);
         input.setTextSize(14);
         input.setSingleLine(true);
         input.setPadding(dp(10), 0, dp(10), 0);
-        input.setBackground(rounded(Color.rgb(12, 17, 23), 8, Color.rgb(48, 58, 70), 1));
+        input.setBackground(inputBackground());
     }
 
     private void styleComposerInput(EditText input) {
-        input.setTextColor(Color.rgb(240, 246, 252));
+        input.setTextColor(COLOR_TEXT);
-        input.setHintTextColor(Color.rgb(139, 148, 158));
+        input.setHintTextColor(COLOR_TEXT_DIM);
         input.setTextSize(14);
         input.setPadding(dp(10), dp(8), dp(10), dp(8));
-        input.setBackground(rounded(Color.rgb(12, 17, 23), 8, Color.rgb(48, 58, 70), 1));
+        input.setBackground(inputBackground());
     }
 
     private Button compactButton(String label, View.OnClickListener listener) {
@@ -2425,13 +2723,25 @@ public final class MainActivity extends Activity {
 
     private StateListDrawable buttonBackground() {
         StateListDrawable states = new StateListDrawable();
-        states.addState(new int[]{-android.R.attr.state_enabled}, rounded(Color.rgb(24, 30, 37), 8, Color.rgb(35, 42, 50), 1));
+        states.addState(new int[]{-android.R.attr.state_enabled}, rounded(Color.rgb(20, 23, 27), 8, COLOR_BORDER_SOFT, 1));
-        states.addState(new int[]{android.R.attr.state_pressed}, rounded(Color.rgb(64, 78, 94), 8, Color.rgb(91, 108, 128), 1));
+        states.addState(new int[]{android.R.attr.state_pressed}, rounded(COLOR_ACCENT_DARK, 8, COLOR_ACCENT, 1));
-        states.addState(new int[]{android.R.attr.state_focused}, rounded(Color.rgb(48, 61, 76), 8, Color.rgb(98, 128, 164), 1));
+        states.addState(new int[]{android.R.attr.state_focused}, rounded(Color.rgb(35, 48, 53), 8, COLOR_ACCENT, 1));
-        states.addState(new int[]{}, rounded(Color.rgb(34, 43, 53), 8, Color.rgb(55, 66, 80), 1));
+        states.addState(new int[]{}, rounded(COLOR_CARD_ALT, 8, COLOR_BORDER, 1));
         return states;
     }
 
+    private GradientDrawable cardBackground() {
+        return rounded(COLOR_CARD, 8, COLOR_BORDER_SOFT, 1);
+    }
+
+    private GradientDrawable panelBackground() {
+        return rounded(COLOR_PANEL, 8, COLOR_BORDER_SOFT, 1);
+    }
+
+    private GradientDrawable inputBackground() {
+        return rounded(COLOR_FIELD, 8, COLOR_BORDER, 1);
+    }
+
     private GradientDrawable rounded(int color, int radiusDp, int strokeColor, int strokeDp) {
         GradientDrawable drawable = new GradientDrawable();
         drawable.setColor(color);
@@ -2483,7 +2793,7 @@ public final class MainActivity extends Activity {
     private TextView bodyText(String text) {
         TextView view = new TextView(this);
         view.setText(text);
-        view.setTextColor(Color.rgb(205, 213, 224));
+        view.setTextColor(COLOR_TEXT_MUTED);
         view.setTextSize(13);
         return view;
     }
@@ -2496,6 +2806,17 @@ public final class MainActivity extends Activity {
         return value == null || value.isEmpty() ? fallback : value;
     }
 
+    private String compactLabel(String value, int maxChars) {
+        if (value == null) {
+            return "";
+        }
+        String trimmed = value.trim();
+        if (trimmed.length() <= maxChars) {
+            return trimmed;
+        }
+        return trimmed.substring(0, Math.max(1, maxChars - 1)) + "…";
+    }
+
     private LinearLayout.LayoutParams matchWrap() {
         return new LinearLayout.LayoutParams(
                 ViewGroup.LayoutParams.MATCH_PARENT,
@@ -2519,20 +2840,20 @@ public final class MainActivity extends Activity {
         if (statusText != null) {
             String value = message == null || message.trim().isEmpty() ? "Ready" : message.trim();
             statusText.setText(value);
-            int bg = Color.rgb(22, 27, 34);
+            int bg = COLOR_PANEL;
             int stroke = Color.TRANSPARENT;
-            int text = Color.rgb(210, 215, 224);
+            int text = COLOR_TEXT_MUTED;
             if (tone == STATUS_BUSY) {
-                bg = Color.rgb(20, 44, 68);
+                bg = Color.rgb(20, 42, 58);
-                stroke = Color.rgb(44, 96, 142);
+                stroke = COLOR_ACCENT;
                 text = Color.rgb(220, 238, 255);
             } else if (tone == STATUS_SUCCESS) {
-                bg = Color.rgb(20, 56, 40);
+                bg = Color.rgb(19, 55, 36);
-                stroke = Color.rgb(42, 118, 78);
+                stroke = COLOR_SUCCESS;
                 text = Color.rgb(218, 245, 228);
             } else if (tone == STATUS_ERROR) {
-                bg = Color.rgb(72, 28, 31);
+                bg = Color.rgb(72, 27, 33);
-                stroke = Color.rgb(154, 66, 72);
+                stroke = COLOR_DANGER;
                 text = Color.rgb(255, 226, 226);
             }
             statusText.setTextColor(text);
@@ -2615,7 +2936,11 @@ public final class MainActivity extends Activity {
 
             @Override
             public void onClosed() {
-                runOnUiThread(() -> setStatus("Event stream disconnected"));
+                runOnUiThread(() -> {
+                    terminalEventStatus = "events disconnected";
+                    updateTerminalMeta();
+                    setStatus("Event stream disconnected");
+                });
             }
         });
         eventSocket.connect(api.getBaseUrl());
@@ -2626,10 +2951,17 @@ public final class MainActivity extends Activity {
             JSONObject event = new JSONObject(text);
             String type = event.optString("type", "");
             if ("hello".equals(type)) {
+                terminalEventStatus = "events connected";
+                updateTerminalMeta();
                 setStatus("Event stream connected");
                 return;
             }
             if ("sessions-invalidated".equals(type)) {
+                terminalEventStatus = "sessions changed";
+                updateTerminalMeta();
+                if (activeSessionName != null) {
+                    refreshTerminalSessionMeta(activeSessionName);
+                }
                 setStatus("Sessions changed: " + event.optString("reason", "update"));
                 if (activeSessionName == null) {
                     refreshSessions();
@@ -2637,11 +2969,17 @@ public final class MainActivity extends Activity {
                 return;
             }
             if ("hook-event".equals(type)) {
+                terminalEventStatus = "hook event";
+                updateTerminalMeta();
                 showMessage(event.optString("title", "Hook event"));
                 return;
             }
+            terminalEventStatus = type.isEmpty() ? "event received" : type;
+            updateTerminalMeta();
             setStatus(type.isEmpty() ? "Event received" : type);
         } catch (Exception error) {
+            terminalEventStatus = "event received";
+            updateTerminalMeta();
             setStatus("Event received");
         }
     }

app/src/main/java/com/neatstudio/tmuxandroid/UpdateManager.java

@@ -80,6 +80,14 @@ final class UpdateManager {
         );
     }
 
+    void checkPreview(boolean userInitiated) {
+        startUpdateCheck(
+                userInitiated,
+                "Preview",
+                new String[]{BuildConfig.DEFAULT_PREVIEW_UPDATE_URL}
+        );
+    }
+
     void checkWithFallback(boolean userInitiated) {
         startUpdateCheck(
                 userInitiated,

app/src/main/res/values/styles.xml

@@ -1,11 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <resources>
-    <style name="AppTheme" parent="android:style/Theme.Material.Light.NoActionBar">
+    <style name="AppTheme" parent="android:style/Theme.Material.NoActionBar">
         <item name="android:fontFamily">sans</item>
         <item name="android:windowLightStatusBar">false</item>
-        <item name="android:statusBarColor">#111418</item>
+        <item name="android:windowLightNavigationBar">false</item>
-        <item name="android:navigationBarColor">#111418</item>
+        <item name="android:statusBarColor">#090B0D</item>
+        <item name="android:navigationBarColor">#090B0D</item>
+        <item name="android:windowBackground">#090B0D</item>
         <item name="android:windowActionModeOverlay">true</item>
     </style>
 </resources>
-

docs/preview-build.md

@@ -0,0 +1,41 @@
+# Preview APK workflow
+
+Use this path for fast UI testing before a formal tag/release.
+
+The preview build is a debug APK with package id `com.neatstudio.tmuxandroid.debug`.
+It can be installed next to the formal release app, so preview version codes do not
+block future formal releases.
+
+## Build locally
+
+```bash
+scripts/setup-android-local.sh
+scripts/build-preview-apk.sh
+```
+
+Output:
+
+- `release/preview/tmux-android-preview.apk`
+- `release/preview/latest.json`
+
+## Upload to Gitea preview release
+
+```bash
+scripts/upload-gitea-preview.sh
+```
+
+The script reads `TMUX_GITEA_TOKEN` or prompts for a hidden token.
+Before uploading, it deletes existing assets with the same names, so the preview
+release keeps only one current APK and one current manifest.
+
+Fixed preview URLs:
+
+- Manifest: `https://gitea.neatcn.com/tmux/tmux-browser-android/releases/download/preview/latest.json`
+- APK: `https://gitea.neatcn.com/tmux/tmux-browser-android/releases/download/preview/tmux-android-preview.apk`
+
+## Notes
+
+- Preview APKs are not formal releases and should not be tagged as `v*`.
+- Preview uses debug signing unless a separate debug signing setup is added.
+- The installed preview app is separate from the release app because Gradle applies
+  `applicationIdSuffix = ".debug"` for debug builds.

scripts/build-preview-apk.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+CI_DIR="${ROOT_DIR}/.ci"
+GRADLE_VERSION="${GRADLE_VERSION:-8.10.2}"
+GRADLE_HOME="${CI_DIR}/gradle-${GRADLE_VERSION}"
+ANDROID_HOME="${ANDROID_HOME:-${CI_DIR}/android-sdk}"
+CMDLINE_TOOLS="${ANDROID_HOME}/cmdline-tools/latest"
+BUILD_NUMBER="${BUILD_NUMBER:-$(date -u +%m%d%H%M)}"
+VERSION_CODE="${VERSION_CODE:-$((900000000 + 10#${BUILD_NUMBER}))}"
+VERSION_NAME="${VERSION_NAME:-preview-${BUILD_NUMBER}}"
+
+if [ ! -x "${GRADLE_HOME}/bin/gradle" ] || [ ! -x "${CMDLINE_TOOLS}/bin/sdkmanager" ]; then
+  "${ROOT_DIR}/scripts/setup-android-local.sh"
+fi
+
+export ANDROID_HOME
+export ANDROID_SDK_ROOT="${ANDROID_HOME}"
+export PATH="${GRADLE_HOME}/bin:${CMDLINE_TOOLS}/bin:${ANDROID_HOME}/platform-tools:${PATH}"
+
+cd "${ROOT_DIR}"
+gradle :app:assembleDebug \
+  -PversionCode="${VERSION_CODE}" \
+  -PversionName="${VERSION_NAME}" \
+  -PrepoSlug="neatstudio/tmux-browser-android"
+
+OUT_DIR="${ROOT_DIR}/release/preview"
+mkdir -p "${OUT_DIR}"
+APK_PATH="$(find app/build/outputs/apk/debug -name '*.apk' | sort | tail -n 1)"
+cp "${APK_PATH}" "${OUT_DIR}/tmux-android-preview.apk"
+SHA256="$(sha256sum "${OUT_DIR}/tmux-android-preview.apk" | cut -d " " -f 1)"
+
+cat > "${OUT_DIR}/latest.json" <<JSON
+{
+  "versionCode": ${VERSION_CODE},
+  "versionName": "${VERSION_NAME}",
+  "apkUrl": "https://gitea.neatcn.com/tmux/tmux-browser-android/releases/download/preview/tmux-android-preview.apk",
+  "sha256": "${SHA256}",
+  "releasePageUrl": "https://gitea.neatcn.com/tmux/tmux-browser-android/releases/tag/preview",
+  "minSdk": 26
+}
+JSON
+
+ls -lh "${OUT_DIR}/tmux-android-preview.apk" "${OUT_DIR}/latest.json"
+sha256sum "${OUT_DIR}/tmux-android-preview.apk"

scripts/setup-android-local.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+CI_DIR="${ROOT_DIR}/.ci"
+GRADLE_VERSION="${GRADLE_VERSION:-8.10.2}"
+ANDROID_TOOLS_ZIP="${ANDROID_TOOLS_ZIP:-commandlinetools-linux-11076708_latest.zip}"
+GRADLE_HOME="${CI_DIR}/gradle-${GRADLE_VERSION}"
+ANDROID_HOME="${ANDROID_HOME:-${CI_DIR}/android-sdk}"
+CMDLINE_TOOLS="${ANDROID_HOME}/cmdline-tools/latest"
+
+mkdir -p "${CI_DIR}"
+
+if [ ! -x "${GRADLE_HOME}/bin/gradle" ]; then
+  curl -fSL --connect-timeout 20 --retry 3 --retry-delay 2 --max-time 600 \
+    -o "${CI_DIR}/gradle.zip" \
+    "https://services.gradle.org/distributions/gradle-${GRADLE_VERSION}-bin.zip"
+  unzip -q "${CI_DIR}/gradle.zip" -d "${CI_DIR}"
+fi
+
+if [ ! -x "${CMDLINE_TOOLS}/bin/sdkmanager" ]; then
+  mkdir -p "${ANDROID_HOME}/cmdline-tools"
+  curl -fSL --connect-timeout 20 --retry 3 --retry-delay 2 --max-time 600 \
+    -o "${CI_DIR}/android-tools.zip" \
+    "https://dl.google.com/android/repository/${ANDROID_TOOLS_ZIP}"
+  unzip -q "${CI_DIR}/android-tools.zip" -d "${ANDROID_HOME}/cmdline-tools"
+  rm -rf "${CMDLINE_TOOLS}"
+  mv "${ANDROID_HOME}/cmdline-tools/cmdline-tools" "${CMDLINE_TOOLS}"
+fi
+
+export ANDROID_HOME
+export ANDROID_SDK_ROOT="${ANDROID_HOME}"
+export PATH="${GRADLE_HOME}/bin:${CMDLINE_TOOLS}/bin:${ANDROID_HOME}/platform-tools:${PATH}"
+
+yes | sdkmanager --licenses >/dev/null || true
+sdkmanager "platforms;android-35" "build-tools;35.0.0" "platform-tools"
+
+echo "ANDROID_HOME=${ANDROID_HOME}"
+echo "GRADLE_HOME=${GRADLE_HOME}"

scripts/upload-gitea-preview.sh

@@ -0,0 +1,93 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+APK_PATH="${1:-${ROOT_DIR}/release/preview/tmux-android-preview.apk}"
+LATEST_JSON="${2:-${ROOT_DIR}/release/preview/latest.json}"
+TAG="preview"
+API_ROOT="https://gitea.neatcn.com/api/v1/repos/tmux/tmux-browser-android"
+
+if [ ! -f "${APK_PATH}" ]; then
+  echo "APK not found: ${APK_PATH}" >&2
+  exit 1
+fi
+if [ ! -f "${LATEST_JSON}" ]; then
+  echo "latest.json not found: ${LATEST_JSON}" >&2
+  exit 1
+fi
+
+TOKEN="${TMUX_GITEA_TOKEN:-}"
+if [ -z "${TOKEN}" ]; then
+  printf "Gitea token: " >&2
+  IFS= read -rs TOKEN
+  printf "\n" >&2
+fi
+if [ -z "${TOKEN}" ]; then
+  echo "Missing Gitea token." >&2
+  exit 1
+fi
+
+WORK_DIR="$(mktemp -d)"
+trap 'rm -rf "${WORK_DIR}"' EXIT
+
+RELEASE_JSON="${WORK_DIR}/release.json"
+BODY='{"tag_name":"preview","target_commitish":"main","name":"tmux Android Preview","body":"Mutable preview APK for fast UI testing. This is not a formal release.","draft":false,"prerelease":true}'
+
+if ! curl -fsSL \
+  -X POST \
+  -H "Authorization: token ${TOKEN}" \
+  -H "Content-Type: application/json" \
+  -d "${BODY}" \
+  "${API_ROOT}/releases" \
+  -o "${RELEASE_JSON}"; then
+  curl -fsSL \
+    -H "Authorization: token ${TOKEN}" \
+    "${API_ROOT}/releases/tags/${TAG}" \
+    -o "${RELEASE_JSON}"
+fi
+
+RELEASE_ID="$(sed -n 's/^{"id":\([0-9][0-9]*\),.*/\1/p' "${RELEASE_JSON}" | head -1)"
+if [ -z "${RELEASE_ID}" ]; then
+  echo "Cannot resolve Gitea release id for preview." >&2
+  exit 1
+fi
+
+upload_asset() {
+  local file="$1"
+  local name="$2"
+  local type="$3"
+  local assets_json old_ids old_id
+  assets_json="${WORK_DIR}/assets-${name}.json"
+  curl -fsSL -H "Authorization: token ${TOKEN}" \
+    "${API_ROOT}/releases/${RELEASE_ID}/assets" \
+    -o "${assets_json}"
+  old_ids="$(python3 - "${assets_json}" "${name}" <<'PY'
+import json
+import sys
+
+with open(sys.argv[1], "r", encoding="utf-8") as handle:
+    assets = json.load(handle)
+for asset in assets:
+    if asset.get("name") == sys.argv[2]:
+        print(asset.get("id"))
+PY
+)"
+  for old_id in ${old_ids}; do
+    curl -fsSL -X DELETE -H "Authorization: token ${TOKEN}" \
+      "${API_ROOT}/releases/${RELEASE_ID}/assets/${old_id}" \
+      -o /dev/null
+  done
+  curl -fsSL \
+    -X POST \
+    -H "Authorization: token ${TOKEN}" \
+    -F "attachment=@${file};type=${type}" \
+    "${API_ROOT}/releases/${RELEASE_ID}/assets?name=${name}" \
+    -o "${WORK_DIR}/${name}.asset.json"
+}
+
+upload_asset "${APK_PATH}" "tmux-android-preview.apk" "application/vnd.android.package-archive"
+upload_asset "${LATEST_JSON}" "latest.json" "application/json"
+
+echo "Uploaded preview release ${RELEASE_ID}"
+echo "Manifest: https://gitea.neatcn.com/tmux/tmux-browser-android/releases/download/preview/latest.json"
+echo "APK: https://gitea.neatcn.com/tmux/tmux-browser-android/releases/download/preview/tmux-android-preview.apk"