Batteriddle 배터리들

Batteriddle 사용 가이드

아이폰 앱 하나로, 맥북 배터리를.

아이폰에 Batteriddle을 설치하고 맥의 원격 로그인을 한 번 설정하세요. 맥에 별도 앱을 설치하지 않아도 잔량과 충전 상태를 확인할 수 있습니다.

처음 연결할 때

  1. 맥에서 시스템 설정 → 일반 → 공유 → 원격 로그인을 켭니다. ‘다음 사용자만’을 선택하고 사용할 Mac 계정을 허용합니다. 전체 디스크 접근 권한은 필요하지 않습니다.
  2. 원격 로그인 안내에서 계정의 짧은 이름과 맥 주소를 확인합니다. 예를 들어 ssh minsu@MacBook.local이면 계정은 minsu, 맥 주소는 MacBook.local입니다.
  3. 아이폰과 맥을 같은 로컬 네트워크에 연결합니다. 아이폰에서 Batteriddle을 열고 +를 누릅니다. 로컬 네트워크 접근 요청이 나오면 허용합니다.
  4. 발견된 맥을 선택하거나 맥 주소를 직접 입력합니다. Mac 계정의 짧은 이름과 로그인 암호를 입력하고 ‘연결’을 누릅니다. Apple 계정이나 Touch ID 대신 Mac 로그인 암호를 사용합니다.
  5. 첫 연결의 ‘맥 확인’에서 주소와 SSH 키 지문을 확인한 뒤 ‘신뢰’를 누릅니다. 연결되면 맥북의 배터리가 목록에 표시됩니다.

Mac 설정 화면이 다르면 Apple의 원격 로그인 안내를 참고하세요. 이 연결에는 iCloud 로그인이나 단축어가 필요하지 않습니다.

위젯과 새로고침

  1. 아이폰 홈 화면을 길게 눌러 위젯 추가를 열고 Batteriddle을 선택합니다.
  2. 앱이나 위젯의 새로고침 버튼을 누르면 맥에 다시 연결해 배터리를 읽습니다. 잔량 옆의 마지막 확인 시각도 함께 확인하세요.

맥이 잠들거나 네트워크 연결이 끊기면 마지막으로 읽은 값이 남을 수 있습니다. 위젯 갱신과 백그라운드 실행 시점은 iOS가 결정하므로 즉시 갱신을 보장하지 않습니다.

iOS 17 이상을 지원합니다. 같은 앱을 iPadOS 17 이상의 아이패드에서도 사용할 수 있습니다.

자주 묻는 질문

맥을 찾지 못하거나 연결할 수 없어요.

맥이 깨어 있고 원격 로그인이 켜졌는지, 입력한 Mac 계정이 허용됐는지 확인해 주세요. 자동 검색이 안 되면 맥 주소를 직접 입력할 수 있습니다. 아이폰 설정에서 Batteriddle의 로컬 네트워크 접근도 허용돼 있어야 합니다. 공용·게스트 Wi-Fi에서는 기기 사이 연결을 차단할 수 있습니다.

계정 이름이나 암호가 맞지 않는다고 나와요.

Mac에 표시되는 전체 이름 대신 원격 로그인 안내의 짧은 계정 이름을 입력하세요. 암호는 맥 로그인 암호입니다. Touch ID로 맥을 열더라도 연결할 때는 암호가 필요합니다.

처음 표시되는 키 지문은 어떻게 확인하나요?

접속할 맥의 터미널에서 아래 명령을 실행하면 SSH 호스트 공개 키의 지문이 나옵니다. 앱에 표시된 SHA256: 값과 일치하는지 확인하세요.

for key in /etc/ssh/ssh_host_*_key.pub; do ssh-keygen -lf "$key" -E sha256; done

이 명령은 공개 키 정보를 읽으며 Mac 설정을 바꾸지 않습니다. 키가 바뀌었다는 오류가 나오면 맥과 주소를 확인한 뒤 연결을 다시 설정해 주세요.

집 밖에서도 볼 수 있나요?

아이폰에서 맥까지 네트워크로 연결할 수 있어야 합니다. 기본 사용 환경은 같은 로컬 네트워크입니다. 외부에서 접속하려면 별도로 설정한 VPN 같은 연결 경로가 필요하며, Batteriddle이 그 경로를 만들지는 않습니다. 잠든 맥의 응답도 보장하지 않습니다.

연결 정보와 암호는 어디에 저장되나요?

설정과 배터리 캐시는 아이폰에, 암호는 앱과 위젯이 공유하는 해당 기기의 키체인에 저장합니다. 개발자 서버를 거치지 않고 맥에 직접 연결합니다. 자세한 정보 처리와 삭제 방법은 개인정보처리방침에서 확인할 수 있습니다.

문의하기

기기 종류, 운영체제와 앱 버전, 발생한 상황을 적어 보내 주세요. 로그인 암호나 인증 코드는 보내지 마세요.

pyospect@gmail.com

Batteriddle Guide

Your MacBook battery. Just the iPhone app.

Install Batteriddle on your iPhone and set up Remote Login on your Mac once. Check battery level and charging status without installing another app on the Mac.

First connection

  1. On the Mac, open System Settings → General → Sharing → Remote Login. Turn it on, choose “Only these users,” and allow the Mac account you will use. Full disk access is not required.
  2. Find the account's short name and Mac address in the Remote Login instructions. For example, in ssh minsu@MacBook.local, the account is minsu and the address is MacBook.local.
  3. Connect the iPhone and Mac to the same local network. Open Batteriddle on iPhone, tap +, and allow the local network permission request.
  4. Select a discovered Mac or enter its address. Enter the Mac account's short name and login password, then tap Connect. Use the Mac login password, rather than your Apple Account or Touch ID.
  5. Check the address and SSH host-key fingerprint in the first Mac confirmation, then tap Trust. The MacBook battery appears in the list when connected.

If your Mac settings look different, see Apple's Remote Login guide. No iCloud login or shortcut is needed for this connection.

Widgets and refresh

  1. Touch and hold the iPhone Home Screen, open Add Widget, and choose Batteriddle.
  2. Tap refresh in the app or widget to reconnect and read the Mac battery. Check the last-updated time alongside the reading.

A sleeping or disconnected Mac may leave the last saved reading on screen. iOS controls background execution and widget refresh timing, so immediate updates are not guaranteed.

Requires iOS 17 or later. The same app also supports iPadOS 17 or later.

Common questions

Why can't I find or connect to the Mac?

Check that the Mac is awake, Remote Login is on, and the Mac account you entered is allowed access. Enter the address manually if discovery does not find it. Allow Batteriddle's local network access in iPhone settings. Public or guest Wi-Fi may block connections between devices.

Why are my username or password rejected?

Enter the short account name shown in Remote Login settings, rather than the Mac user's full display name. Use the Mac login password. Even if you normally unlock the Mac with Touch ID, this connection needs the password.

How can I check the first host-key fingerprint?

Run the command below in Terminal on the Mac you want to connect. Compare the SSH host public-key fingerprints with the SHA256: value shown in the app.

for key in /etc/ssh/ssh_host_*_key.pub; do ssh-keygen -lf "$key" -E sha256; done

This reads public-key information without changing Mac settings. If the app reports a changed key, verify the Mac and address before setting up the connection again.

Can I use it away from home?

Your iPhone must have a network route to the Mac. The usual setup uses the same local network. Remote access needs a separately configured route such as a VPN; Batteriddle does not create one. A sleeping Mac is not guaranteed to respond.

Where are my connection details and password stored?

Settings and cached readings are stored on iPhone. Passwords use that device's Keychain shared by the app and widget. Connections go directly to your Mac without a developer server. See the Privacy Policy for storage and deletion details.

Contact support

Include your device type, operating-system and app versions, and what happened. Please do not send login passwords or verification codes.

pyospect@gmail.com