This section provides quick, clear, and to-the-point answers to the most common and important questions from our users.
Whether you need guidance on setup, customization, troubleshooting, or advanced features, you’ll find short explanations and practical tips here—so you can get back to using voNavPilot immediately.
Follow these simple steps to install voNavPilot quickly and easily:
voNavPilot.zip file from your account or the official download link.voNavPilot.zip file, click Install Now, then Activate.From this point, your voice command journey begins! ;)
Simply click the microphone button to turn voNavPilot on or off, when the microphone button is colored green, voNavPilot is active and listening, and when it turns gray, voNavPilot is temporarily disabled. To completely remove voNavPilot from your website, deactivate the plugin from your WordPress admin dashboard.
Go to Plugins > Installed Plugins, find voNavPilot, and click Deactivate.
Audio playback failed. Please click or tap anywhere on the page first, then try the command again.
Why?VoNavPilot’s voice features only activate after user interaction due to browser security policies around audio playback. If this permission is lost—such as by not interacting with the page or if the page loads with an active VoNavPilot session—beep sounds may not play, even though voice commands still function.
To fix this, simply click anywhere on the page or tap your device again. Then try your voice commands—you should hear the beep tone now!
This is a known issue, especially on Chrome for mobile devices when opening new tabs using voice commands.
This limitation can also affect features like Read Page, where audio feedback is important, as well as any functionality that relies on detecting when audio playback ends to trigger further actions.
Behind the scenes, voNavPilot is powered by a cutting-edge matching engine that combines two advanced technologies:
fuzzysort and Levenshtein distance.
Fuzzysort enables fast and flexible fuzzy searching to find close matches even if words aren’t exact, while Levenshtein distance measures how similar two strings are by counting the minimal edits needed to transform one into the other.
This combination ensures high accuracy in matching user intent to commands—even when spoken imprecisely or with small errors.
Additionally, all commands are generated and managed using DeepL Write, an AI writing assistant. This helps us achieve optimal matching results. Our focus on voice recognition and phonetic spellings ensures integrated commands are understood as accurately as possible, though results may vary. You can also add and customize your own commands in the Admin Dashboard and experiment to improve accuracy for your specific needs.
voNavPilot uses voice recognition to convert your speech into text and phonetic spellings to match it to the correct command. Commands with at least 2 clear syllables are easier to recognize, reducing misinterpretation. Speaking too fast can lower accuracy, as the system may not clearly separate sounds.
For example, the command "go up" is recognized reliably when spoken clearly at a normal pace. However, very short commands like "up" may not be detected at all, especially if spoken quickly or without clear pronunciation. Clear pronunciation, multiple syllables, and moderate speed help voNavPilot respond reliably.
VoNavPilot uses the browser’s built-in Web Speech API for voice recognition. This API's exact behavior can vary depending on the device, because browser vendors choose which engine to use.
• Desktop (Chrome/Edge on Windows):
The speech input is sent to Google’s cloud-based recognition service, which powers the Web Speech API in desktop browsers. This fully cloud-based backend typically offers higher accuracy and more consistent results when recognizing short, predefined commands.
• Android (Chrome/Edge):
On Android, the Web Speech API often relies on a third-party system built into the device—typically Google Play Services or the manufacturer's speech engine—that also connects to the cloud for transcription. This hybrid setup is optimized for mobile needs like battery and bandwidth, but may yield less consistent results with short, fixed commands.
Why results differ: Even when you speak the same command, the recognition backend differs. Desktop always uses Google’s complete cloud model (maximized for accuracy), while Android uses a device-supported implementation that may introduce variance in command recognition. This behavior stems from the Web Speech API implementation and is not a bug in VoNavPilot.
Tip: On Android, speaking your commands clearly and slowly can help improve recognition consistency.
voNavPilot’s Page Reading starts from the visible area of the page (usually the viewport) and reads aloud all visible content, including text and image alt or title attributes. It continues reading sequentially down the page until it reaches the end.
This feature is built with voNavPilot’s own self-programmed module and does not rely on any external services.
While reading, voNavPilot adds a highlight effect to the text or images being read, helping users focus better. The page also auto-scrolls smoothly to follow the reading progress.
Related voice commands: You can say start reading to begin and stop reading to stop reading at any time.
voNavPilot automatically analyzes each page as users navigate your site. It detects key elements like forms, internal links, and page sections in real time. For navigation, it creates voice commands by combining page names with phrases from the Admin Dashboard’s Open Link Commands (such as "open", "go to", "navigate to", etc.).
No manual setup is required — commands are generated and updated dynamically to ensure smooth and accurate voice control across your site.
All commands in voNavPilot are dynamic and can be customized or improved in the Admin Dashboard. Think of voNavPilot as a self-hosted voice bot you can train with more words to improve accuracy.The most important point is to avoid overlapping commands, which lowers recognition accuracy when unrelated or common words appear in multiple commands.
For example, you can add "Color Correction On/Off" instead of "Grayscale On/Off," or add "Invert Colors On/Off" instead of "High Contrast On/Off."
This flexibility helps keep voice commands distinct and your system more reliable.
This module helps users fill out contact forms using voice commands. It has been tested mostly with WP-Forms and Contact Form 7 and is designed for standard form types.
During form filling, a spelling mode lets you enter your input letter by letter to ensure 100% accuracy. You can navigate between fields, clear a field, or correct your last entry.
voNavPilot can automatically fill certain form elements such as select boxes (e.g., choosing the first option) and checkboxes.
You can open or close the spelling table anytime to assist your input.
Once you finish, you can submit the form after completing the verification. voNavPilot provides a 2-minute window for you to complete it manually.
After that, the form will be submitted automatically, and a confirmation message will be read aloud.
Before you begin, ensure voNavPilot is active (the microphone icon is green). Then say open try commands to go to the command page, and once there, say fill out the form to start your voice-controlled form-filling journey!
The Form Spelling Table is designed to help you achieve 100% accuracy when filling out complex fields using voice commands. With a pronunciation map for alphabets, numbers, and common characters (like the email sign, period, and dash), you can easily enter precise data into any form.
The table provides a simple yet effective layout, with only the most essential items to ensure quick and accurate form filling. This allows you to focus on what matters while keeping the process streamlined.
You can also customize and update the table to improve pronunciation accuracy or experiment with different settings.
If you need assistance at any point, you can easily access the table by saying show spelling table or hide spelling table. It will guide you through the process and ensure your data is entered correctly.
Google Invisible reCAPTCHA uses various signals to verify if a user is human, including mouse movements, keyboard input, browsing behavior, and device data.
With voNavPilot, the initial keypress or click to activate the voice assistant serves as the main physical interaction that helps Google recognize a human user.
After activation, most actions may be performed via voice commands without further keyboard or mouse input. Google then relies on browser signals and session data to continue verifying user authenticity.
If Google’s system is confident you are human, no additional CAPTCHA challenge appears. However, if there is uncertainty—especially due to limited physical input—you may be prompted to complete a CAPTCHA. In that case, voNavPilot provides a 2-minute window where you can request live assistance to complete the verification.
In the Admin Dashboard, go to Visual Design & TTS. There you can:
Yes, all texts and labels can be customized under Admin Dashboard → Labels Translations.
Please pay attention to the important notes in each section to prevent any errors after saving.
To add a new language—e.g., Portuguese—to VoNavPilot, please follow these steps:
lanMap.json file and add translations for all existing languages to your new language. Example for Portuguese:
"portuguese": "pt""portugiesisch": "pt""portugais": "pt""portugués": "pt""portoghese": "pt""português": "pt"controlCommandMaps in vonavPilot.js. Add your language code (e.g., "pt") with all relevant voice commands, for example:
switch to Portuguese,
change language Portuguese,
set language Portuguese,
wechsel zu Portugiesisch,
ändere Portugiesisch,
setze Portugiesisch,
passer en portugais,
changer portugais,
définir portugais,
cambiar a portugués,
cambiar idioma portugués,
establecer idioma portugués,
passa a portoghese,
cambia lingua portoghese,
imposta lingua portoghese".en[...], de[...], fr[...], es[...], it[...], pt[...]
stopWords.json. Stop words are ignored by VoNavPilot and will not appear in recognized commands.
www.yourdomain/pt/yourpage.
The Export & Import feature in the Admin Dashboard lets you easily back up and move your custom voNavPilot setup between sites.
Export: Save all your customized settings, labels, voice commands, and translations into a single JSON file for backup or reuse.
Import: Load a previously exported configuration file to instantly restore your custom visual design, commands, translations, and other settings on another site.
VoNavPilot uses WordPress Transients to cache your JSON files for faster performance. As a result, changes you make might not appear immediately. To ensure your updates take effect, you'll need to install a Transient Manager Plugin on your dashboard. After that, clear all cached VoNavPilot JSON files to refresh the system and enable new command detection and updated labels.
voNavPilot doesn’t use a traditional database. Instead, all information is saved in separate JSON files. This approach allows faster and easier processing during live voice command handling.