rytilahti/python-miio

어떤 프로젝트인가요?

핵심 기능

• 01IP 주소와 토큰을 사용해 로컬 네트워크에서 miIO 및 MIoT 기기를 제어합니다.
• 02범용 MIoT 통합 기능을 통해 기기 spec 파일에 정의된 상태, 설정, 작업을 확인하고 사용할 수 있습니다.
• 03다양한 Xiaomi 로봇 청소기, 공기청정기, 선풍기, 가습기, 램프, 플러그를 전용 모듈로 지원합니다.
• 04miiocli 명령으로 기기 정보와 상태를 조회하고, 설정을 변경하거나 작업을 실행할 수 있습니다.
• 05cloud 명령으로 Xiaomi 클라우드 계정에서 기기 토큰을 가져옵니다.
• 06하드웨어 없이 테스트할 수 있는 miIO 및 MIoT 시뮬레이터를 포함합니다.

활용 사례

• Python 프로그램으로 Xiaomi 기기를 스크립팅하거나 자동화합니다.
• Xiaomi 가전제품용 맞춤형 스마트홈 통합 기능이나 대시보드를 구축합니다.
• 실제 기기를 보유하지 않고 miIO 또는 MIoT 클라이언트를 테스트합니다.
• 터미널에서 기기 상태를 조회하고 설정을 변경합니다.

빠른 시작

1. 1

   PyPI에서 라이브러리를 설치합니다

   pip install python-miio
2. 2

   기기의 IP 주소와 토큰을 가져옵니다(예: cloud 명령 사용)

   miiocli cloud
3. 3

   기기에 쿼리를 보내 모델과 제어 명령을 확인합니다

   miiocli device --ip <ip> --token <token> info

사용 전 알아둘 점

• !최신 MIoT 기기를 지원하려면 버전 0.6.0이 출시될 때까지 git 버전 또는 프리릴리스 버전이 필요합니다.
• !기기를 제어하려면 각 기기의 IP 주소와 토큰을 알아야 합니다.
• !이 프로젝트는 자발적으로 운영되는 커뮤니티 프로젝트이며 기기 제조사와 제휴 관계가 없습니다.
• !카피레프트 라이선스인 GPL-3.0에 따라 라이선스가 부여됩니다.

토픽

자주 묻는 질문

python-miio은(는) 무엇인가요?

miIO 및 MIoT 프로토콜을 통해 Xiaomi 스마트홈 기기를 제어하는 Python 라이브러리와 miiocli 명령줄 도구입니다. python-miio는 Xiaomi 스마트홈 가전제품을 제어하는 Python 라이브러리이자 함께 제공되는 명령줄 도구인 miiocli입니다. Xiaomi의 miIO 및 MIoT 프로토콜을 지원하므로, IP 주소와 토큰만 알고 있으면 로컬 네트워크에서 기기의 정보를 조회하고 제어할 수 있습니다.

python-miio은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

python-miio은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

python-miio은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. python-miio의 마지막 커밋은 2026년 7월 25일입니다.

python-miio은(는) 어디에 사용할 수 있나요?

Python 프로그램으로 Xiaomi 기기를 스크립팅하거나 자동화합니다. Xiaomi 가전제품용 맞춤형 스마트홈 통합 기능이나 대시보드를 구축합니다. 실제 기기를 보유하지 않고 miIO 또는 MIoT 클라이언트를 테스트합니다. 터미널에서 기기 상태를 조회하고 설정을 변경합니다.

python-miio는 어떻게 설치하나요?

PyPI에서 라이브러리를 설치합니다: pip install python-miio 기기의 IP 주소와 토큰을 가져옵니다(예: cloud 명령 사용): miiocli cloud 기기에 쿼리를 보내 모델과 제어 명령을 확인합니다: miiocli device --ip <ip> --token <token> info

python-miio은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/rytilahti/python-miio