Repolode
dutradotdev

dutradotdev/quokka

USB로 연결된 iPhone 또는 Android 기기의 저장 공간, 앱, 미디어, 실시간 로그를 확인하고 정리하는 Mac 터미널 CLI입니다.

스타
112
포크
2
열린 이슈
2
마지막 커밋
3개월 전

어떤 프로젝트인가요?

quokka는 케이블로 연결된 iPhone과 Android 기기를 모두 지원하는 macOS 명령줄 도구입니다. 저장 공간, 배터리, 설치된 앱, 미디어 파일, 기기 식별 정보, 실시간 시스템 로그를 확인할 수 있으며, 공간을 확보하거나 기기를 재시동하고 전원을 끌 수도 있습니다.

iPhone은 usbmuxd와 lockdown 서비스를 통해, Android 기기는 로컬 adb 서버를 통해 연결합니다. 어느 쪽도 탈옥이나 root 권한이 필요하지 않으며, quokka는 관리자 권한 없이 실행됩니다. iOS 17 이상과 Android 8 이상을 지원합니다.

이 도구는 quokka와 더 짧은 이름의 qk, 두 가지 바이너리로 제공되며, 인자 없이 실행하면 대화형 런처가 열립니다. 대부분의 조회 명령은 스크립트에서 사용할 수 있도록 --json을 지원하며, --redact 옵션을 사용하면 출력 공유 전에 일련 번호, UDID, IMEI, MAC 주소를 마스킹합니다.

핵심 기능

  • 01레벨 및 프로세스 필터, 검색, 저장 기능을 갖춘 실시간 TUI 로그 뷰어입니다.
  • 02용량이 큰 미디어 파일의 순위를 보여 주고 중복으로 추정되는 파일을 그룹화합니다.
  • 03사용자 앱을 크기순으로 나열하고 bundle id로 앱을 제거합니다.
  • 04선택적으로 민감 정보를 마스킹해 기기, 시스템, 네트워크 식별 정보를 표시합니다.
  • 05스크립트용 --json 출력을 지원하며, 특정 기기를 대상으로 지정하는 --udid 플래그도 제공합니다.

활용 사례

  • 앱을 디버깅하는 동안 테스트용 iPhone 또는 Android 기기의 시스템 로그를 실시간으로 확인합니다.
  • 용량이 큰 미디어 파일과 중복 파일을 찾아 테스트 기기의 저장 공간을 확보합니다.
  • 민감한 식별 정보를 마스킹한 상태로 스크린샷이나 버그 리포트에 필요한 기기 정보를 수집합니다.
  • CI에서 --json과 비대화형 플래그를 사용해 기기 점검을 스크립트로 실행합니다.

빠른 시작

  1. 1

    Homebrew로 quokka를 설치합니다

    brew install dutradotdev/tap/quokka-cli
  2. 2

    qk를 실행해 대화형 런처를 엽니다

    qk

사용 전 알아둘 점

  • macOS 전용이며, 휴대폰을 케이블로 연결한 Mac에서 실행됩니다.
  • iPhone은 iOS 17 이상, Android는 Android 8 이상이 필요합니다.
  • Android에서 root 권한이 없으면 앱 이름이 패키지 ID로 표시되고 배터리 상태를 확인할 수 없습니다.
  • 패킷 캡처(qk capture)는 iOS 전용입니다.

포함된 컬렉션

토픽

자주 묻는 질문

quokka은(는) 무엇인가요?
USB로 연결된 iPhone 또는 Android 기기의 저장 공간, 앱, 미디어, 실시간 로그를 확인하고 정리하는 Mac 터미널 CLI입니다. quokka는 케이블로 연결된 iPhone과 Android 기기를 모두 지원하는 macOS 명령줄 도구입니다. 저장 공간, 배터리, 설치된 앱, 미디어 파일, 기기 식별 정보, 실시간 시스템 로그를 확인할 수 있으며, 공간을 확보하거나 기기를 재시동하고 전원을 끌 수도 있습니다.
quokka은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
quokka은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
quokka은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. quokka의 마지막 커밋은 2026년 7월 27일입니다.
quokka은(는) 어디에 사용할 수 있나요?
앱을 디버깅하는 동안 테스트용 iPhone 또는 Android 기기의 시스템 로그를 실시간으로 확인합니다. 용량이 큰 미디어 파일과 중복 파일을 찾아 테스트 기기의 저장 공간을 확보합니다. 민감한 식별 정보를 마스킹한 상태로 스크린샷이나 버그 리포트에 필요한 기기 정보를 수집합니다. CI에서 --json과 비대화형 플래그를 사용해 기기 점검을 스크립트로 실행합니다.
quokka는 어떻게 설치하나요?
Homebrew로 quokka를 설치합니다: brew install dutradotdev/tap/quokka-cli qk를 실행해 대화형 런처를 엽니다: qk
quokka은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/dutradotdev/quokka

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트

USB 또는 WiFi로 iPhone, iPad, 여분의 Mac을 Mac의 진정한 확장 디스플레이로 바꿔 주는 무료 오픈소스 프로젝트입니다.

모바일·데스크톱#macos#ios#screen-extension
6.2천+169 이번 주429SwiftGPL-3.0활발히 관리됨업데이트 어제