Skip to content

h3nock/remux

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

155 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Remux

Remux is a native iOS client for remote tmux workspaces.

Remux brings tmux's session, window, and pane model into a native iPhone interface. Connect to a server, open or create a tmux session, then switch sessions, browse windows, split panes, close panes, and send input through native iOS controls.

What Works Today

  • Save SSH servers and multiple tmux sessions per server
  • Open existing tmux sessions or create new ones over SSH
  • Keep multiple terminal sessions running and switch between them
  • Render tmux windows and panes as native iOS-managed terminal surfaces
  • Browse tmux windows and panes from native iOS controls
  • Focus panes and route keyboard, paste, mouse, and scroll input to the focused pane
  • Create and close tmux windows from the app
  • Split and close tmux panes from the app
  • Copy terminal selections and paste through the focused pane
  • Store server passwords in Keychain
  • Remember trusted SSH hosts
  • Save terminal font and theme settings

Current Limits

  • This is early development work, not a daily-driver terminal yet.
  • SSH is the only transport available today. Mosh support is planned.
  • Source builds currently require a local terminal-renderer XCFramework at the path configured in project.yml. The framework is not distributed in this repository, so it must be available at that path before generating or building the project.

Build from Source

Requirements:

  • Xcode with iOS 18 SDK support
  • XcodeGen
  • the terminal-renderer XCFramework configured in project.yml

Generate the Xcode project:

xcodegen generate

Build:

xcodebuild build \
  -project Remux.xcodeproj \
  -scheme Remux \
  -destination 'generic/platform=iOS Simulator'

Test:

xcodebuild test \
  -project Remux.xcodeproj \
  -scheme Remux \
  -destination 'platform=iOS Simulator,name=iPhone 17,OS=latest'

Repository Layout

Documentation

About

Native iOS tmux client with a mobile-first UI for persistent terminal sessions.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages