Berth — SFTP · Terminal · Serial Console for macOS
Berth runs in the macOS sandbox, so it can only read folders you have explicitly granted it — including your home directory. The local panel remembers the last folder you chose and reuses it for every session, so you may be seeing an earlier pick.
To change it, click the folder button in the local panel header (“Open local folder…”) and choose the folder you want as the root — for example your home directory. Berth remembers it and applies it to all open sessions at once.
To the macOS Trash. Nothing is permanently erased by Berth. You can restore a file yourself from the Finder Trash.
macOS and Linux store Korean, Japanese, Vietnamese, and accented file names with different byte sequences (NFD vs NFC). Berth matches names correctly across this difference, so this is rare — but if a name was created by an unusual tool it can still happen. The files are the same; only their stored form differs.
This almost always means nothing is answering on that host and port. Check that SSH (sshd) is actually running on the server and listening on the port you configured, and that a firewall or the address/port isn’t blocking it. Berth now shows a plain-language reason (refused / unreachable / timed out) to help you tell these apart.
The first connection to a server verifies its host key in the terminal — this is a security step, not a bug. Accept it there and Berth remembers it. If you re-image a board often and the key keeps changing, you can turn off the host-key check for that one site in its settings (never for production-grade servers).
Right-click the session dot in the session rail and choose “Reconnect”. You can also click the reconnect button shown in the terminal of a disconnected session.
When two or more sessions share the same server, Berth labels the dots A, B, C… so you can tell them apart. A single session stays unlabeled.
If your keystrokes echo back cleanly, the link itself is working (Berth does not echo locally — what you see comes from the device). The usual cause is the device side: it may be hung, or that serial line may not have an interactive shell.
Try pressing Enter alone, or Ctrl+C then Enter. Power-cycle (unplug/replug) the board and watch for a boot log. If characters come back garbled instead of clean, the baud rate is wrong — fix it in the site settings.
Fixed in a recent version — Berth now matches shortcuts by the physical key, so they work with Korean or any other input source active, without affecting your ability to type that language into the terminal. Please update to the latest version.
A brief confirmation flashes at the top of the terminal — Copied for ⌘C, Kept in record for ⌘⇧P. It disappears in a fraction of a second so it never gets in your way.
No. There is no analytics, tracking, or telemetry of any kind in the app — a promise to our users. See the Privacy Policy.
Yes. When you choose to save a password it is kept in the macOS Keychain only — never in plain text and never transmitted to us.
The version from our website updates itself: open Berth ▸ Check for Updates… (it also checks about once a day). The Mac App Store version updates through the App Store.
Berth — macOS용 SFTP · 터미널 · 직렬 콘솔
Berth는 macOS 샌드박스에서 돌기 때문에, 홈 디렉터리를 포함해 사용자가 직접 허용한 폴더만 읽을 수 있습니다. 로컬 패널은 마지막에 고른 폴더를 기억해 모든 세션에 다시 쓰므로, 예전에 고른 폴더가 보이는 것입니다.
바꾸려면 로컬 패널 머리글의 폴더 버튼(“로컬 폴더 열기…”)을 눌러 원하는 폴더(예: 홈 디렉터리)를 고르면 됩니다. 그 선택이 기억되고 열려 있는 모든 세션에 한 번에 적용됩니다.
맥 휴지통으로 갑니다. Berth는 어떤 파일도 완전 삭제하지 않습니다. Finder 휴지통에서 직접 되돌릴 수 있습니다.
macOS와 리눅스는 한글·일본어·베트남어·악센트가 든 파일 이름을 서로 다른 바이트로 저장합니다(NFD·NFC). Berth는 이 차이를 넘어 이름을 올바르게 짝지으므로 드문 일이지만, 특이한 도구로 만든 이름에서는 여전히 생길 수 있습니다. 파일은 같은 것이고 저장된 형태만 다릅니다.
대개 그 호스트·포트에서 아무것도 응답하지 않는다는 뜻입니다. 서버에서 SSH(sshd)가 실제로 실행 중이고 설정한 포트에서 듣고 있는지, 방화벽이나 주소·포트가 막고 있지 않은지 확인하십시오. Berth는 거부·닿지 못함·시간 초과를 구분해 쉬운 말로 알려 줍니다.
서버에 처음 접속할 때는 터미널에서 호스트 키를 확인합니다 — 버그가 아니라 보안 절차입니다. 거기서 확인하면 Berth가 기억합니다. 개발 보드를 자주 다시 구워 키가 계속 바뀐다면, 그 사이트 설정에서 그 한 대에 한해 호스트 키 확인을 끌 수 있습니다(운영 등급 서버에서는 쓰지 마십시오).
세션 기둥의 색 동그라미를 오른쪽 클릭해 “재연결하기”를 고르십시오. 끊긴 세션의 터미널 화면에 뜨는 재연결 버튼을 눌러도 됩니다.
같은 서버로 두 세션 이상 열리면 Berth가 동그라미에 A·B·C…를 붙여 구분해 줍니다. 하나뿐일 때는 표시가 없습니다.
친 글자가 깨끗하게 되울려 온다면 통신 자체는 되는 것입니다(Berth는 로컬 에코를 하지 않아, 보이는 글자는 장치가 돌려준 것입니다). 대개 원인은 장치 쪽 입니다 — 먹통이거나, 그 직렬 선에 대화형 셸이 없을 수 있습니다.
Enter만 눌러 보거나, Ctrl+C 후 Enter를 쳐 보십시오. 보드의 전원을 뽑았다 꽂고 부팅 로그가 흐르는지 보십시오. 글자가 깨끗한 대신 깨져 온다면 보드율이 틀린 것이니 사이트 설정에서 고치십시오.
최근 버전에서 해결됐습니다 — 이제 물리 키를 기준으로 단축키를 인식하므로, 한글 등 어떤 입력기가 켜져 있어도 동작하며 터미널에 그 언어를 입력하는 데는 지장이 없습니다. 최신 버전으로 업데이트하십시오.
터미널 위쪽에 짧게 표시가 스칩니다 — ⌘C는 복사됨, ⌘⇧P는 기록판에 담김. 눈 깜짝할 새에 사라져 작업을 방해하지 않습니다.
아니요. 앱 안에는 어떤 계측·추적·통계도 없습니다 — 사용자와의 약속입니다. 개인정보 처리방침을 보십시오.
네. 비밀번호를 저장하기로 선택하면 맥 키체인에만 보관되며, 평문으로 저장하거나 저희에게 전송하지 않습니다.
웹사이트에서 받은 판은 스스로 갱신합니다 — Berth ▸ 업데이트 확인… 을 열면 됩니다(하루 한 번쯤 자동으로도 확인합니다). Mac App Store 판은 App Store를 통해 업데이트됩니다.