Linux Voice Activated Macro
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Aidan Gustard a229683c57
Merge pull request #3 from smirgol/master
3 years ago
.idea added the initial version for voice command spotting 5 years ago
.img other cleanup 4 years ago
keyboard other cleanup 4 years ago
model/en-us added the initial version for voice command spotting 5 years ago
pynput other cleanup 4 years ago
.gitignore Fixes & implementation of playing audio files. See changes.md for details. 3 years ago
LICENSE.txt Added GPLv3 licence 4 years ago
README.md fixed semicolons in main, and type in readme, centered volume slider 3 years ago
changes.md Small fix in finding correct ED game window, added pressed key output to shell 3 years ago
command.list Readme tweaks 4 years ago
commandeditwnd.py Fixes & implementation of playing audio files. See changes.md for details. 3 years ago
commandeditwnd.ui added the initial version for voice command spotting 5 years ago
keyactioneditwnd.py remove modules not used 4 years ago
keyactioneditwnd.ui initial commit 5 years ago
main.py Merge branch 'master' of https://github.com/smirgol/LinVAM 3 years ago
mainwnd.ui Fixes & implementation of playing audio files. See changes.md for details. 3 years ago
mouseactioneditwnd.py remove modules not used 4 years ago
mouseactioneditwnd.ui initial commit 5 years ago
pauseactioneditwnd.py remove modules not used 4 years ago
pauseactioneditwnd.ui initial commit 5 years ago
profileeditwnd.py Fixes & implementation of playing audio files. See changes.md for details. 3 years ago
profileeditwnd.ui initial commit 5 years ago
profileexecutor.py Small fix in finding correct ED game window, added pressed key output to shell 3 years ago
profiles.dat Readme tweaks 4 years ago
set_kws_threshold.py added the initial version for voice command spotting 5 years ago
soundactioneditwnd.py Fixes & implementation of playing audio files. See changes.md for details. 3 years ago
soundactioneditwnd.ui Fixes & implementation of playing audio files. See changes.md for details. 3 years ago
soundfiles.py Fixes & implementation of playing audio files. See changes.md for details. 3 years ago
ui_commandeditwnd.py added the initial version for voice command spotting 5 years ago
ui_keyactioneditwnd.py initial commit 5 years ago
ui_mainwnd.py fixed semicolons in main, and type in readme, centered volume slider 3 years ago
ui_mouseactioneditwnd.py initial commit 5 years ago
ui_pauseactioneditwnd.py initial commit 5 years ago
ui_profileeditwnd.py initial commit 5 years ago
ui_soundactioneditwnd.py Fixes & implementation of playing audio files. See changes.md for details. 3 years ago

README.md

LinVAM

Linux Voice Activated Macro

Status

This project is currently a work-in-progress and is minimally functional only for english.

Utilising Pocketsphinx, a lightweight voice to text engine you can specify voice commands for the tool to recognise and actions to perform.

Known bugs and planned additions

  • To save and use changes click Ok on the main GUI then reload.
  • Remember last loaded profile and load on start
  • Log window showing spoken words the V2T recognises with ability to right click and assign voice command and actions to current profile
  • Support for joysticks and gaming devices

Requirements

  • python3
  • PyQt5
  • python3-xlib
  • pyaudio
  • pocketsphinx
  • swig3.0

Optional requirements

  • xdotool
  • ffplay (part of ffmpeg, usually already installed)
  • HCS voicepacks

Install

  • $ pip3 install PyQt5
  • $ pip3 install python3-xlib
  • $ pip3 install pyaudio
  • $ pip3 install pocketsphinx
  • $ sudo apt-get install swig3.0
  • $ (optional) sudo apt install xdotool
  • $ (optional) sudo apt install ffmpeg
  • $ sudo ln -s /usr/bin/swig3.0 /usr/bin/swig
  • $ git clone https://github.com/aidygus/LinVAM.git

Usage

This script must be run with root privilege because it must hook and simulate input devices such as keyboard, mouse etc.

  • $ cd LinVAM
  • $ xhost +
  • $ sudo ./main.py

As an alternative, if you use the X window manager and have xdotool installed, you can run the script like this:

  • $ cd LinVAM
  • $ ./main.py -noroot

Profiles

Multiple profiles are supported. To create a new profile for a specific task/game click new and the main profile editor window will be displayed

Main GUI

Key combinations

To assign key combinations first decide which functional key to press by clicking on Ctrl, Alt, Shift or Win to denote left or right key then press the actual command key

Main GUI

Complex commands

It is possible to add multiple actions to a voice command for complex macros with the ability to add a pause between each action. You can also assign mouse movements and system commands if you require (eg opening applications such as calculator, browser etc)

Main GUI

Threshold

As a rough guide use a value of 10 for each syllable of a word then tweak it down for better accuracy.

Output audio

In the Command Edit Dialog, chose 'Other' and then 'Play sound'. Pick the sound you would like to play. For this to work you need to copy any audio file you would like to use to the folder 'voicepacks'. You are required to create a subfolder to hold all your audio files (voicepack folder), then within that subfolder, create as many folders as you like to group your audio files (category folders). Place the audio file into these category folders or in any subfolder within a category folder. In theory any audio file should work, but tested only with MP3 files.

Example: /voicepacks/my voicepack/custom commands/hello.mp3 /voicepacks/my voicepack/other/thank you.mp3

If you own a HCS voicepack, copy the whole voicepack folder (like 'hcspack', 'hcspack-eden', ...) to the 'voicepacks' folder, so it reads like this: /voicepacks/hcspack/...

Improve voice recognition accuracy

Please see this resource on how to train the acoustic model of pocketsphinx to match your voice: https://cmusphinx.github.io/wiki/tutorialadapt/