morsify

morsify

Morse code encoder and decoder with no dependencies supports Latin, Cyrillic, Greek, Hebrew, Arabic, Persian, Japanese, and Korean characters with audio generation functionality using the Web Audio API.

Live demo can be found at morsify.net.

Installation

npm

$ npm install morsify --save

yarn

$ yarn add morsify

Usage

var morsify = require('morsify');
var encoded = morsify.encode('SOS'); // .../---/... 
var decoded = morsify.decode('.../---/...'); // S O S
var characters = morsify.characters(); // {'1': {'A': '.-', ...}, ..., '11': {'ㄱ': '.-..', ...}}
var audio = morsify.audio('SOS'), oscillator = audio.oscillator; // OscillatorNode
audio.play(); // play audio
audio.stop(); // stop audio

Or alternatively, you can also use the library directly with including the source file.

<script src="https://rawgit.com/ozdemirburak/morsify/master/dist/morsify.min.js"></script>
<script>
    var encoded = morsify.encode('SOS'); // .../---/... 
    var decoded = morsify.decode('.../---/...'); // S O S
    var characters = morsify.characters(); // {'1': {'A': '.-', ...}, ..., '11': {'ㄱ': '.-..', ...}}
    var audio = morsify.audio('SOS');
    var oscillator = audio.oscillator; // OscillatorNode
    var context = audio.context; // AudioContext
    audio.play(); // play audio
    audio.stop(); // stop audio
</script>

Options and Localization

You can customize the dash, dot or space characters and specify the alphabet with the priority option for an accurate encoding and decoding.

What priority option does is, gives direction to the plugin to start to searching for the given character set first.

Set the priority option according to the list below.

• 1 => ASCII (Default)
• 2 => Numbers
• 3 => Punctuation
• 4 => Latin Extended (Turkish, Polish etc.)
• 5 => Cyrillic
• 6 => Greek
• 7 => Hebrew
• 8 => Arabic
• 9 => Persian
• 10 => Japanese
• 11 => Korean
• 12 => Thai

var cyrillic = morsify.encode('Ленинград', { priority: 5 }) // .-.././-./../-./--./.-./.-/-..
var greek = morsify.decode('.../.-/--./.-/.--./.--', { priority: 6 }) // Σ Α Γ Α Π Ω
var hebrew = morsify.decode('––– –... ––– –. ––. .. .–.. –––', { dash: '–', dot: '.', space: ' ', priority: 7 }) // ה ב ה נ ג י ל ה
var characters = morsify.characters({ dash: '–', dot: '•' }); // {'1': {'A': '•–', ...}, ..., '11': {'ㄱ': '•–••', ...}}
var arabicAudio = morsify.audio('البُراق‎‎', { // generates the morse .-/.-../-.../.-./.-/--.- then generates the audio from it
  unit: 0.1, // period of one unit, in seconds, 1.2 / c where c is speed of transmission, in words per minute
  oscillator: {
    type: 'sine', // sine, square, sawtooth, triangle
    frequency: 500,  // value in hertz
    onended: function () { // event that fires when the tone has stopped playing
      console.log('ended');
    },
  }
}); 
var oscillator = arabicAudio.oscillator; // OscillatorNode 
var context = arabicAudio.context; // AudioContext; 
arabicAudio.play(); // will start playing morse audio
arabicAudio.stop(); // will stop playing morse audio

Contributing and Known Issues

Contributions are welcome.

Currently, as a major drawback, Chinese characters are missing. Someone with the knowledge of Chinese telegraph code can help to implement it. Also someone who is proficient in Thai can help to include Thai alphabet.

Generating Minified Files

Install node and npm following one of the techniques explained within this link and run the commands below.

$ npm install --global gulp-cli
$ npm install
$ gulp

License

The MIT License (MIT). Please see License File for more information.