MeshRemote

KO | EN

gitlite — search

#macos #android #web #nextjs #data-science #codex #monitoring #python #rust #self-hosted

(★ 9)

Manage your MeshCentral server agents from your iOS device!

파일 탐색기

ZIP 다운로드

- app-store-badge-black.svg
- app-store-badge-white.svg
- protocol-control.md
- protocol-desktop.md
- protocol-ssh-files.md
- - Contents.json
- - BackgroundGrace.swift
  - BinaryData.swift
  - ConnectionAdvice.swift
  - DeviceListPreferences.swift
  - HTTPSDownloader.swift
  - KeychainStore.swift
  - MeshModels.swift
  - MeshServerConnection.swift
  - MeshWebSocket.swift
  - OrderedSender.swift
  - ServerAddress.swift
  - ServerProfile.swift
- - DesktopCanvasView.swift
  - DesktopSession.swift
  - DesktopView.swift
  - KVMFramebuffer.swift
- - FilesSession.swift
  - FilesView.swift
- - SSHSession.swift
  - SSHView.swift
  - TerminalSession.swift
  - TerminalView.swift
- - AboutView.swift
  - DeviceDetailView.swift
  - DeviceGlyph.swift
  - DeviceListView.swift
  - OnboardingView.swift
  - ServersView.swift
  - SSOLoginView.swift
- Info.plist
- MeshRemoteApp.swift
- project.pbxproj
- ControlChannelTests.swift
- KVMProtocolTests.swift
- RealServerTests.swift
.gitignore
PRIVACY.md
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A native iOS management app for [MeshCentral](https://meshcentral.com). Browse your
devices, control them with remote desktop, open SSH terminals, transfer files, and
send power commands.

Built with SwiftUI. The MeshCentral wire protocols are implemented natively in Swift; the SSH
terminal uses [SwiftTerm](https://github.com/migueldeicaza/SwiftTerm).

## Features

- **Servers** — Multiple Server Profiles. Have multiple mesh central servers?
  Great! You can add all of them.
- **Devices** — View all of your devices and their online/offline status.
- **Remote Desktop** — Native decoding of MeshCentral's tile protocol
  with trackpad-style controls.
- **SSH** — Full terminal emulation via the server's SSH relay, with optional
  server side credential storage
- **Files** — Browse drives/folders, download files, upload from the
  Files app, rename/delete/new folder, transfer progress
- **Power** — Wake-on-LAN, restart, sleep, power off

## Build Requirements

- Xcode 16 or newer (SwiftTerm's Metal renderer also needs the Metal toolchain:
  `xcodebuild -downloadComponent MetalToolchain` if Xcode asks for it)
- A MeshCentral server. SSH sessions additionally require `"ssh": true` in the
  domain section of the server's `config.json`.

## Installation

- **From the App Store** — [MeshRemote on the App Store](https://apps.apple.com/us/app/meshremote/id6794005665).
  This is the easiest way to install and keeps the app updated automatically.
- **Build it yourself** — see Build Requirements above.

## First launch:

- tap **+**, enter your server (e.g. `server.example.com` or
`host:port`), username and password. Toggle *Allow self-signed certificate* if your
server doesn't have a public TLS certificate.

## Tests

`MeshRemoteTests` contains protocol unit tests (KVM tile/jumbo/fragment parsing) and
integration tests that run against a local MeshCentral instance:

```bash
# one-time local server setup (in a scratch directory)
npm install meshcentral
node node_modules/meshcentral --createaccount admin --pass test1234 --email a@b.c
node node_modules/meshcentral --adminaccount admin
node node_modules/meshcentral   # config: port 8443, cert localhost

xcodebuild -project MeshRemote.xcodeproj -scheme MeshRemote \
  -destination 'platform=iOS Simulator,name=iPhone 17' test
```

Integration tests skip automatically when no local server is running.

## Protocol documentation

The MeshCentral wire formats this app implements are documented in [docs/](docs/):

- [protocol-control.md](docs/protocol-control.md) — auth, device list, events, power
- [protocol-desktop.md](docs/protocol-desktop.md) — KVM remote desktop byte format
- [protocol-ssh-files.md](docs/protocol-ssh-files.md) — SSH relay and file transfer

## Notes & limitations

- 2FA: a code can be entered at connect time; TOTP enrollment/push approval flows
  are not implemented.
- Intel AMT-only devices (no agent) can be woken/powered but not remote-controlled.
- App Transport Security is relaxed (`NSAllowsArbitraryLoads`) because MeshCentral
  servers frequently use self-signed certificates; certificate trust is still
  enforced per-server unless you enable the override.

## Privacy

MeshRemote collects no data and has no backend — it talks only to the MeshCentral
server(s) you configure, and credentials stay in the iOS Keychain on your device.
See [PRIVACY.md](PRIVACY.md) for the full policy.

## AI Disclosure
 
A majority of the code in this project was written using Claude AI with a human review. 
Icons and descriptions were human made. I used this project to help me learn the Swift 
language while making something genuinely useful. I personally use this app a lot and 
have found it to be a great tool to manage my homelab. Hope you enjoy!

MeshRemote

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README