Voce Browser Save

Voice Controlled Chromium Web Browser

Project README

Voce Browser

GPL License Platforms Python v3.7 Build passing Speech Recognition gTTS PyQt5

Voce Browser is a chromium based voice controlled browser using PyQtWebEngine. It has all the basic browser features like Chrome or Firefox and in addition it can be controlled with voice commands.

Voce Browser

Voce Browser

Table of contents


This project uses the Qt GUI library Python binding as user interface. Voce Browser can be given voice commands which are translated and then exceuted using google speech recognition API. Its web engine is PyQtWebEngine, a chromium based engine.


Voce has all standard browser features, and plus voice commands capabilities.

Supported Voice Commands

  • Open tab: Open a new tab.
  • Close tab: close current tab
  • Open window: Open a new window.
  • Close window: close current window
  • Search: Search for a keyword. This command should be followed by a keyword.
  • Go back: go back to the previous page if any
  • Go forward: go to the next page if any
  • Go home: go to the default homepage
  • Reload page: Reload the current page
  • Exit, bye and quit: Close all windows and exit the browser


This project is created with:

  • PyQt5 5.12.3
  • PyQtWebEngine 5.12.1
  • SpeechRecognition: 3.8.1
  • gTTS 2.1.1
  • pydub


To run the browser, first download or git clone this project and then install it locally in your Python environment as described below.

Supposing that you have already Python3 and pip3 installed on your system, from the terminal change the current directory to the project root directory. Proceed then as follows:

python3 setup.py build
python3 setup.py install

or install a wheel distribution

python3 setup.py bdist_wheel
pip3 ./dist/*.whl install


Running Commands System-wide

If you want the commands in the project bin directory to be system wide, just create a bin directory (if does not exist) in your home directory. And copy the scripts in your home bin dir. Finally add it to the path env variable and you're done.

Pydub Module

The pydub module depends on FFmpeg package to render audio files so make sure it is installed on your system. For example, on Ubuntu you can install it with the following command: sudo apt install ffmpeg. For more information go to: https://ffmpeg.org/

PyAudio Module

If having troubles on installing PyAudio with Python higher than 3.7, then you should first try to the install the following packages as follows:

For Linux (Ubuntu)

sudo apt-get install libasound-dev portaudio19-dev libportaudio2 libportaudiocpp0
pip install pyaudio

For Wındows

pip install pipwin
pipwin install pyaudio


GPL License

This is an open-source project under the GPL-3.0 License

Open Source Agenda is not affiliated with "Voce Browser" Project. README Source: trabdlkarim/voce-browser

Open Source Agenda Badge

Open Source Agenda Rating