MiWifispeaker

中文文档

🪄 Function

Control Xiaomi wifispeaker to play local musics🎵.

📁 Managing local musics

🪟 Windows

Ensure your computer and wifispeaker are under the same LAN, input \\<ip> on the address bar of explorer, where <ip> ip refers to the ip address of your wifispeaker, and press enter to access. If you encounter an error, you can try to enable SMBv1 client, although it's not recommend to do so.

🤔 Other systems

Ensure your computer and wifispeaker are under the same LAN, and use a SMB client to connect to your wifispeaker. If a username is required, use GUEST, and leave the password blank. You may also need to enable SMB(v)1 somewhere.

🚩 Login

🔑 Using userid and password

wifi_speaker = WifiSpeakerV3('<Mi id>', '<password>', '<serial number>')
# serial number is required if you have multiple wifispeakers and want to specify one you'd like to control.
# You may find the serial nummber on the bottom of your wifispeaker.

🍪 Using cookies

1. Ensure you can capture https traffic on your phone/emulator, even when apps don't trust user certificates.(Emulator of Android 6 and below, together with Fiddler is recommended)
2. Install "小爱音箱" APP (com.xiaomi.mico).
3. Open your packet capture software, ensure it works and then login in your Mi account on the APP.
4. Among the packets you captured, copy any cookie of a request that has the domain api*.mina.mi.com, and ensure the cookie contains userId, deviceSNProfile, sn, deviceId and serviceToken field. An example is shown below.

   userId=2574549865
   deviceSNProfile=eyJzaWduIjoiNzMzMDA4NzFmNDRjMTY4ZTdjOTQ5ZGUyYzc1MGU2MGMyYzliYjhmZjUzMDAxN2M1YTI2NzIzNGU5Y2I0ZGI4ZSIsInNuIjoiMTUwODcvNTYwMDE1NjQ4In0=
   sn=15087/560015648
   deviceId=6e8h7506-8d34-65df-c0d7-e19480s7d3b4
   serviceToken=tJYUMjSdn6MHAaEJzdchU8XZVqkGnbmrT3n4hhQaIqrrAl9OwgyWGwEZohfPDUENSaQ/aPJF1JVaX32nwCaHAvOACyJ7aJW5g7hw+GYJ5SrKBqVN8XG0wjvPaFYpyQ3Ha8Oelx6IH8OxydiqNop98RTUnOxHLW9G7AkfowucoGiYRls8XbhqBL22q3lBVntfZ7EnEpXY6x9FaNGE0DQWVQ==
   

5. Convert it to Python dict, and start coding!

   my_cookie = {
       'userId': '2574549865',
       'deviceSNProfile': 'eyJzaWduIjoiNzMzMDA4NzFmNDRjMTY4ZTdjOTQ5ZGUyYzc1MGU2MGMyYzliYjhmZjUzMDAxN2M1YTI2NzIzNGU5Y2I0ZGI4ZSIsInNuIjoiMTUwODcvNTYwMDE1NjQ4In0=',
       'sn': '15087/560015648',
       'deviceId': '6e8h7506-8d34-65df-c0d7-e19480s7d3b4',
       'serviceToken': 'tJYUMjSdn6MHAaEJzdchU8XZVqkGnbmrT3n4hhQaIqrrAl9OwgyWGwEZohfPDUENSaQ/aPJF1JVaX32nwCaHAvOACyJ7aJW5g7hw+GYJ5SrKBqVN8XG0wjvPaFYpyQ3Ha8Oelx6IH8OxydiqNop98RTUnOxHLW9G7AkfowucoGiYRls8XbhqBL22q3lBVntfZ7EnEpXY6x9FaNGE0DQWVQ=='
   }
   wifi_speaker = WifiSpeakerV3(cookie=my_cookie)

💡 Combine the above 2 methods

When logined, save the cookie to a file for future use. Next time you start the script, you can use the saved cookie. If the cookie is expired, relogin and refresh the cookie. Cookie can be fetched via WifiSpeakerV3.cookie. Example:

from json import load, dump
try:
    with open('cookie') as f:
        wifi_speaker = WifiSpeakerV3(cookie=load(f))
        status = wifi_speaker.status
except:
    print('Refreshing cookie...')
    wifi_speaker = WifiSpeakerV3('<Mi id>', '<password>')
    status = wifi_speaker.status
    with open('cookie', 'w') as f:
        dump(wifi_speaker.cookie.get_dict(), f)

📖 Usage

No documentations yet. Please refer to demo.py.

✅ Supported models

You can use token extractor or miiocli device --ip <ip_address> --token <token> info to determine the model of your wifispeaker.

• xiaomi.wifispeaker.v3

⚠️ Attention

Noting here yet.

🗒️ Todo

• Add set_loop_type.
• Add playlist.