Skip to content

Add mobile remote desktop sessions#18

Merged
LukeGus merged 3 commits into
Termix-SSH:dev-1.4.0from
ZacharyZcR:feat/mobile-remote-desktop
May 29, 2026
Merged

Add mobile remote desktop sessions#18
LukeGus merged 3 commits into
Termix-SSH:dev-1.4.0from
ZacharyZcR:feat/mobile-remote-desktop

Conversation

@ZacharyZcR
Copy link
Copy Markdown
Member

@ZacharyZcR ZacharyZcR commented May 13, 2026

Overview

Add mobile remote desktop sessions so RDP, VNC, and Telnet hosts can be launched from the mobile Hosts tab through the existing Guacamole backend.

  • Added: mobile Remote Desktop session backed by Guacamole WebSocket connections
  • Updated: Hosts list to include non-SSH remote desktop hosts
  • Updated: session handling to support remote desktop tabs
  • Added: touch mouse scaling and basic keyboard/special-key controls
  • Added: viewport resize forwarding and scrollable control bar for small screens

Changes Made

  • Reuse /guacamole/connect-host/{hostId} to generate a host-scoped Guacamole token.
  • Connect the mobile WebView client to /guacamole/websocket/ with viewport dimensions.
  • Add a RemoteDesktop session renderer with connection, disconnect, error, and reconnect states.
  • Route RDP/VNC/Telnet hosts to remote desktop sessions from the Hosts list and context menu.
  • Add mobile input controls for text entry, Esc, Tab, Enter, Backspace, arrow keys, and Ctrl+Alt+Del.
  • Correct touch coordinates when the Guacamole display is scaled to fit the phone screen.
  • Forward viewport resize events to Guacamole so rotation can update the remote display without reconnecting.
  • Keep the remote desktop toolbar horizontally scrollable to avoid cramped small-screen layouts.

Related Issues

Screenshots / Demos

Not included; this needs a configured Termix server with guacd and an RDP/VNC/Telnet host to verify interactively on device.

Validation run locally:

  • npx eslint app/tabs/sessions/remote-desktop/RemoteDesktop.tsx passes.
  • npx prettier --check app/tabs/sessions/remote-desktop/RemoteDesktop.tsx passes.
  • git diff --check passes.
  • npx eslint app/main-axios.ts app/contexts/TerminalSessionsContext.tsx app/tabs/hosts/Hosts.tsx app/tabs/hosts/navigation/Host.tsx app/tabs/sessions/Sessions.tsx app/tabs/sessions/navigation/TabBar.tsx app/tabs/sessions/remote-desktop/RemoteDesktop.tsx passes with existing warnings only.
  • npx tsc --noEmit still fails on existing repository-wide TypeScript errors outside this change.

Checklist

  • Code follows project style guidelines
  • Supports mobile and desktop UI/app (if applicable)
  • I have read Contributing.md

@LukeGus LukeGus changed the base branch from main to dev-1.4.0 May 29, 2026 04:12
@LukeGus LukeGus merged commit 8124529 into Termix-SSH:dev-1.4.0 May 29, 2026
@ZacharyZcR ZacharyZcR deleted the feat/mobile-remote-desktop branch May 31, 2026 11:05
LukeGus added a commit that referenced this pull request Jun 3, 2026
* fix: register physical Tab key on iPadOS/iOS hardware keyboards (#14)

The native module only registered Shift+Tab but not bare Tab, so iOS
intercepted it for UI focus navigation. Register an unmodified Tab
UIKeyCommand with wantsPriorityOverSystemBehavior and handle both
Tab and Shift+Tab in the same JS branch.

Fixes Termix-SSH/Support#557

* fix: pass jumpHosts, forceKeyboardInteractive, and overrideCredentialUsername to terminal connection (#15)

These fields were defined on SSHHost but omitted from the terminal
hostConfig passthrough. Without jumpHosts the backend cannot route
through jump servers; without forceKeyboardInteractive hosts that
require keyboard-interactive auth fail silently; without
overrideCredentialUsername shared credentials use the wrong username.

Fixes Termix-SSH/Support#422
Fixes Termix-SSH/Support#638

* fix: improve mobile terminal scroll recovery (#17)

* Add mobile remote desktop sessions (#18)

* feat: add mobile remote desktop sessions

* feat: add remote desktop input controls

* feat: polish remote desktop controls

* feat: add mobile terminal font selection (#19)

* feat: add mobile shift tab hotkey (#20)

* feat: initial UI redesign

* feat: revamp server login system

* chore: update app icon/background color

* fix: remove unused fields in the settings tab

* feat: improve the user pin system and update all settings modals to use new ui

* fix: active server not updating unless app restarts

* feat: add version in settings

* feat: improve host page UI (updated host form and added credential management)

* fix: preserve composed iOS terminal input

* ci: restore mobile checks

* feat: rewrite of connection system for all types

* fix: preserve mobile jump hosts (#30)

* fix: guard android user ca trust (#29)

* fix: capture ios hardware tab key (#27)

* fix: reset terminal input after special keys (#28)

* fix: open oidc in system browser (#26)

* fix: preserve websocket auth context (#25)

* fix: keep none-auth terminal prompts alive (#23)

* fix: allow local network SSL in Android app (#21)

* feat: allow oidc passkeys

* feat: bundeled xterm into app and added docker loading screen

* feat: add 2fa, api key, and active sessions to settings and addressed multiple bug fixes and inconsistencies with termix web

* chore: update repo images and readme

* chore: update readme to split table for screenshots

* chore: rename ios to apple in build workflow

* fix: android build failure

* feat: add snippet management and fix several bugs

* fix: web login and oidc incorrect logic

* chore: run linter

---------

Co-authored-by: ZacharyZcR <zacharyzcr1984@gmail.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FEATURE] RDP support to mobile app

2 participants