#About Artyom

Artyom.js is a robust and useful wrapper of the webkitSpeechRecognition and speechSynthesis APIs written in Javascript. Besides, artyom allow you to add dinamically commands to your web app (website).

Artyom is constantly updated with new gadgets and awesome features, star and watch this repository to be aware of artyom updates.

Between the most known features of artyom are :

Speech Recognition

• Quick recognition of voice commands.
• Add commands easily.
• Smart commands (usage of wildcards).
• Create a dictation object to convert easily voice to text.
• Simulate commands without microphone.
• Execution keyword to execute a command immediately after the use of the keyword.
• Pause and resume command recognition.
• Artyom has available the soundex algorithm to increase the accuracy of the recognition of commands (disabled by default).
• Use a remote command processor service instead of local processing with Javascript.

Voice Synthesis

• Synthesize extreme huge blocks of text (+20K words according to the last test).
• onStart and onEnd callbacks will be always executed independently of the text length.

#Installation

NPM

npm install artyom.js

Bower

bower install artyom.js

Or just download a .zip package with the source code, minified file and commands examples : download .zip file

Languages

Artyom provides complete support for the following languages. Every language needs an initialization code that needs to be provided in the lang property at the initialization.

	Description	Codes for initialization
	English (USA) English (Great Britain) Great Britain United States of America	en-US en-GB en
	Español	es-CO es-ES es
	Deutsch	de-DE de
	Italiano	it-IT
	Français	fr-FR fr
	Japanese 日本人	ja-JP jp
	Russian	ru-RU ru
	Brazil	pt-PT pt
	Dutch (netherlands)	nl-NL nl
	Polski (polonia)	pl-PL pl
	Indonesian (Indonesia)	id-ID id
	Chinese (Cantonese[ 粤語（香港）] Mandarin[普通话（中国大陆）])	Cantonese zh-HK Mandarin zh-CN

All you need to know about Artyom

• Documentation
• Frequently Asked Questions
• Changelog

Do not hesitate to create a ticket on the issues area of the Github repository for any question, problem or inconvenient that you may have about artyom.

Demostrations

• Homepage
• Continuous mode J.A.R.V.I.S
• Sticky Notes

Basic usage

// Add command (Short code artisan way)
artyom.on(['Good morning','Good afternoon']).then(function(i){
    switch (i) {
        case 0:
            artyom.say("Good morning, how are you?");
        break;
        case 1:
            artyom.say("Good afternoon, how are you?");
        break;            
    }
});

// Smart command (Short code artisan way), set the second parameter of .on to true
artyom.on(['Repeat after me *'] , true).then(function(i,wildcard){
    artyom.say("You've said : " + wildcard);
});

// or add some commands in the normal way

artyom.addCommands([
    {
        indexes: ['Hello','Hi','is someone there'],
        action: function(i){
            artyom.say("Hello, it's me");
        }
    },
    {
        indexes: ['Repeat after me *'],
        smart:true,
        action: function(i,wildcard){
            artyom.say("You've said : "+ wildcard);
        }
    }
]);

// Start the commands !
artyom.initialize({
    lang:"en-GB", // GreatBritain english
    continuous:true, // Listen forever
    soundex:true,// Use the soundex algorithm to increase accuracy
    debug:true, // Show messages in the console
    executionKeyword: "and do it now",
    listen:true // Start to listen commands !
});

/**
 * To speech text
 */
artyom.say("Hello, this is a demo text.",{
  onStart: function(){
    console.log("Reading ...");
  },
  onEnd: function(){
    console.log("No more text to talk");
  }
});

Working with artyom is cool and easy, read the documentation to discover more awesome features.

Thanks for visit the repository !