Voice for Xiaomi Vacuum Mop 2 Lite: 3 ways to install and configure voice notifications

Xiaomi Vacuum Mop 2 Lite (STYJ02YM model) out of the box does not support Russian voice-over β€” instead of the usual voice prompts, users hear only signals and vibrations. However, this problem can be solved in three ways: through the official Mi Home application, using alternative firmware like Valetudo, or by manually recording audio files. In this article, we will analyze each method by steps, compare their pros and cons, and give recommendations for choosing voice and setting up notification triggers.

It is important to understand that voice acting capabilities depend on the firmware version of your device. For example, in the Chinese versions of Xiaomi Vacuum Mop 2 Lite (with the CN suffix in the model), Chinese voice packs are available by default, which can be replaced with Russian ones. While in global versions (with the EU suffix or RU), voice acting is often absent at all. Before setting up, check the marking on the device body or in the Settings menu β†’ Device in the Mi Home application.

Also note: some methods require unlocking a token (for Valetudo firmware) or root access to a router (for local sound replacement).If you are not ready for technical manipulation, choose the official method through Mi Home - it is the easiest, but also the most limited.

1.Official method: voiceover via the Mi Home app

The safest method is to use the built-in Mi Home tools, which are suitable for users who do not want to risk the guarantee or stability of the vacuum cleaner, but there are two significant limitations to this method:

  • πŸ”Š Only standard voice packs from Xiaomi (Chinese, English, sometimes Spanish) are available.
  • πŸ”„ Voiceover only works for basic notifications: start cleaning, low charge, errors. You can't customize phrases or add new triggers.

To activate voiceover:

  1. Open the Mi Home app and go to your vacuum cleaner page.
  2. Slip on three dots in the upper right corner β†’ Device settings.
  3. Select Voice Notifications (or Voice Pack in English).
  4. Download the available voice pack (e.g. English (US)).
  5. Activate the slider Enable voice notifications.

If this menu item is not available in your region, try changing the country in your Mi Home profile to China or the United States.

Profile β†’ Settings β†’ Region β†’ Select β€œChina”

⚠️ Warning: Changing your region may cause you to lose communication with other Xiaomi devices in your account.

πŸ“Š What voice language would you prefer for Xiaomi Vacuum Mop 2 Lite?
Russian
English
Chinese
Other (specify in the comments)
I don't need a voiceover.

2. Valetudo's alternative firmware: full voice customization

Valetudo firmware is an open source software for Xiaomi robot vacuum cleaners that allows you to fully control the device, including replacing audio files.

  • 🎀 Ability to download any voice packets, including Russian-language ones from the community (e.g., from users with 4PDA).
  • πŸ”§ Customization of individual triggers: voice acting at start of cleaning, completion, errors, low water level, etc.
  • πŸ›‘οΈ Work without the Xiaomi cloud (all data stays local).

There are, however, downsides:

  • πŸ”“ Token unlocking is required (the procedure takes up to 14 days and requires confirmation from Xiaomi).
  • πŸ’» You need basic skills with SSH and Docker (to install Valetudo on a Raspberry Pi or other server).
  • ⚠️ The risk of loss of warranty (although Xiaomi can’t actually track firmware unless it’s accessed by the service).

If you are ready for experiments, follow the instructions:

Get a device token through Mi Home API|Install Docker on your home server or Raspberry Pi|Download the image of Valetudo with GitHub|Connect the vacuum cleaner to the local network via Wi-Fi (not through the cloud)-->

  1. Get a device token: Use the Mi Home API tool or Home Assistant plugin. Enter a username/password from your Xiaomi account and select your vacuum cleaner from the device list. Copy the token (a 32-character line) – it will be needed to connect to Valetudo.
  2. Install Valetudo: Docker Run -d \ --name valetudo \ -p 80:80 \ -v /path/to/config:/config \ -e"VALETUDO_ENABLE_MQTT=1" \ -e"VALETUDO_MIIO_DEVICE_ID=YOUR_DEVICE_ID" \ -e"VALETUDO_MIIO_TOKEN=YOUR_TOKEN" \ ghcr.io/hypfer/valetudo:latest Replace. YOUR_DEVICE_ID and YOUR_TOKEN I'm looking at your vacuum cleaner.
  3. Download voice packet: Download the voice archive (e.g., from here). Unpack the files into /config/valetudo/sounds folder on the server. Reboot the Valetudo container: docker restart valetudo

Set up triggers.

  • Open the Valetudo web interface at http://[IP_ of your server.
  • Go to Settings β†’ Sound Events.
  • Link audio files to events (e.g. startup.mp3 β†’ Start cleaning).
What to do if Valetudo can’t see the vacuum cleaner?
Make sure: 1. The vacuum cleaner and the server with Valetudo are on the same local network. 2. The device token is correct (check through the Mi Home API). 3. Port 80 is not blocked by a firewall or router. 4. The router settings turn off "AP Isolation" (Isolation of Wi-Fi clients). If the problem persists, try restarting the vacuum cleaner by holding the power button for 10 seconds.

3. Manual replacement of audio files (for advanced users)

This is a method that works for those who want to use their own voice recordings without installing alternative firmware, and the idea is to swap the standard vacuum cleaner sounds through a local server.

  • πŸ–₯️ A router with DNS-spoofing support (e.g., Keenetic, Asus RT with Merlin firmware).
  • πŸŽ™οΈ A set of sound files in.mp3 format (mono, 16 kHz, 64 kbps bitrate).
  • 🌐 Local Web server (you can use nginx or even the Python script http.server).

Critical nuance: Xiaomi Vacuum Mop 2 Lite accesses audio files on hard-defined URL- addresses of the miot-spec.com domain. To redirect requests to your server, you need to replace DNS- records in the router.

Step-by-step:

  1. Prepare sound files: Download the archive template with sounds (e.g., from here). Replace files with your records, saving the original names (e.g., start_cleaning.mp3, low_battery.mp3). Place files in a folder on your server (e.g., /var/www/vacuum/sounds/).
  2. Set up local DNS: In the router control panel, find the DNS-spoofing or Hosts section. Add a entry: 192.168.1.100 miot-spec.com (where 192.168.1.100 is IP of your server).
  3. Run a web server: For nginx add to config: server { listen 80; server_name miot-spec.com; root /var/www/vacuum; autoindex on; } Reboot the server: sudo systemctl restart nginx

Reset the vacuum cleaner

  • Turn off and turn on the vacuum cleaner again, holding the power button for 5 seconds.
  • After connecting to Wi-Fi, it should start downloading sounds from your server.
EventFile nameExample of phrase
Starting cleaningstart_cleaning.mp3"I'm starting cleaning. Please remove small objects from the floor."
Low charge.low_battery.mp3"Battery charge less than 20%. Returning to base."
Mistake.error.mp3"Obstacle detected. Check the area in front of the vacuum cleaner."
Completion of cleaningclean_complete.mp3"The cleanup is complete. The area of the cleaned area is 45 square meters."

⚠️ Warning: If the vacuum cleaner has stopped responding to commands after setting up, check: Correctness of DNS- recordings (make sure the miot-spec.com domain is not blocked by the router). Server availability (try opening http://[IP_ server]/sounds/start_cleaning.mp3 in the browser). Audio file format (must be MP3 with a bitrate no higher than 128 kbps). In extreme cases, reset the vacuum cleaner settings to the factory power button 15

πŸ’‘

If you don't want to mess with the server, you can use a ready-made community audio assembly. For example, on 4PDA there are themes with Russian voice packs for Xiaomi that you can download and replace in the /sounds/ folder.

4. Comparison of methods: which way to choose?

To determine the method, evaluate your technical skills and functional requirements:

CriteriaMi Home (official)ValetudoHand-substituted
Difficulty setting up⭐ (2 minutes)⭐⭐⭐⭐ (1-2 hours)⭐⭐⭐ (30-60 minutes)
Support for the Russian language❌ No.βœ… Yes (castomizable)βœ… Yes (any phrases)
Unlocking of the token is required❌ No.βœ… Yes.❌ No.
Working without the Internet❌ No (needs cloud)βœ… Yes (locally)βœ… Yes (locally)
Risk of loss of guarantee❌ No.⚠️ Theoretically yes❌ No.

The choice of method depends on your goals:

  • 🏠 For basic voice acting in English, the official Mi Home method is sufficient.
  • πŸ› οΈ For full customization and Russian, Valetudo is optimal, but it will take time to set up.
  • πŸ”§ For experiments with your own voices, manually swapping sounds through a local server.

πŸ’‘

If your main goal is to provide Russian voiceovers without unnecessary manipulation, look for ready-made firmware with Russification on forums (for example, 4PDA). Often users post modified versions of Valetudo with already integrated voice packets.

5. Where to download Russian voice packets?

Ready-made sound sets for Xiaomi Vacuum Mop 2 Lite can be found on the following resources:

  • πŸ“Œ 4PDA is a voiceover theme for Xiaomi (there are Russian packages from AlexGyver and Kostyan users).
  • πŸ“Œ GitHub is a repository with sound patterns and instructions for replacement.
  • πŸ“Œ Telegram chat "Xiaomi Vacuum" - users share their recordings and help with setting up.

When choosing a package, pay attention to:

  • πŸ”Š Record quality: Avoid files with noise or distortion.
  • πŸ“ Phrase length: optimally, 1-3 seconds (too long sounds can be interrupted).
  • πŸ“ Archive structure: Files must be named according to the Valetudo standard (e.g. startup.mp3, error_10.mp3).

If you want to create your own voice pack, use the following tools:

  • 🎀 Audacity - for recording and editing sound (export to MP3 with a bitrate of 64 kbps).
  • πŸ“‚ FFmpeg – for batch renaming and file conversion:

Frequent problems and their solutions

When you set up voiceovers, users encounter common errors, and here's how to fix them:

⚠️ Warning: If after Valetudo installation, the vacuum cleaner has stopped responding to commands from Mi Home, that's OK! Alternative firmware disables cloud management. Use Valetudo's web interface or integrate the device into Home Assistant.

Problem.Reason.Decision
No sounds are being played.Incorrect file names or formatCheck the Valetudo filenames match. Convert to MP3 at 64 kbps bitrate.
Vacuum cleaner not connected to ValetudoIncorrect token or device IDCheck the token through the Mi Home API. Make sure the vacuum cleaner and server are on the same network.
Voiceover is working with a delaySlow local server or routerCheck the file rate with the server. Replace the router if the problem is DNS- spoofing.
Mi Home missing "Voice Notifications" itemChange of region or firmware versionReturn the region to China or upgrade the vacuum cleaner firmware to the latest version.

If none of these methods worked, try:

  1. Reset the vacuum cleaner settings to factory (hold the power button for 15 seconds).
  2. Update the firmware through Mi Home (path: Device settings β†’ Firmware update).
  3. Contact the support Telegram chat with error logs (in Valetudo they are available in Settings β†’ Logs).
Can I install voiceover on Xiaomi Vacuum Mop 2 Lite without unlocking the token?
The official way through Mi Home does not require a token, but only English or Chinese voices. Token is not needed to manually replace sounds through a local server, but you will need to configure DNS- spoofing on the router.
Why does the vacuum cleaner not return to base after Valetudo installation?
This problem is related to the incorrect map configuration in Valetudo. Try: Delete the saved map in the web interface (Map β†’ Clear Map); Reset the vacuum cleaner and let it scan the room again; check the settings of zones and virtual walls - they could reset. If the problem persists, update Valetudo to the latest version.
Where to get a token for Xiaomi Vacuum Mop 2 Lite?
You can get the token in several ways: through the Mi Home API (you need a username / password from your Xiaomi account); with the Xiaomi Miio Integration plugin in Home Assistant; through the package sniffer (for Android).
How to return the standard voiceover after experiments?
To roll back changes: For Valetudo: remove the Docker container and reflash the vacuum cleaner through Mi Home (path: Settings β†’ Firmware Update). For manual sound replacement: delete the miot-spec.com entry in the router's DNS settings and restart the vacuum cleaner. For the official method: turn off the slider Voice notifications in Mi Home. In extreme cases, reset to factory settings (hold the power button for 15 seconds).
Can I use a voice assistant (Alice, Google Assistant) to control a vacuum cleaner with voiceover?
Yes, but with reservations: Alice (Yandex): works only through Mi Home with official firmware. Voice will be in English/Chinese. Google Assistant: supports commands via Mi Home or Home Assistant (if you integrate Valetudo); Siri (via HomeKit): requires a bridge like Home Assistant or HOOBS. For full Russian voiceover through the assistant, you need to configure Valetudo + Home Assistant with the Text-to-Speech plugin.