Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

Koch method Morse code training program

Project Description

Command line Koch method Morse code audio generation and training program.


  • Morse code audio playback and file generation
  • with configurable Farnsworth timing [PDF] (defaults to a minimum of 20 WPM characters at any WPM less than 20 WPM)
  • and filters to limit the code’s audio bandwith
  • supporting a Koch method CLI training program


$ pip install koch


Tested with Python 2.7.9 on Mac OS X.

Note that to install the PyAudio dependency on Mac OS X, you’ll need to first install portaudio with Homebrew:

$ brew install portaudio


Play back strings in Morse by passing them as command line arguments:

$ koch hello world

Save the generated code to a WAV file:

$ koch -f hello.wav hello world

Change the code speed from the default 20 WPM to 30 WPM:

$ koch -c 30 hello world

And the tone frequency from the default 770 Hz to 440 Hz:

$ koch -H 440 hello world

Try a slower speed, which will default to Farnsworth timing with each character played at 20 WPM (default) but the inter-character spacings slowed to 10 WPM:

$ koch -w 10 hello world

Keep the inter-character speed at 10 WPM, but increase the Farnsworth character speed to 30 WPM:

$ koch -w 10 --cwpm 30 hello world

Start a Koch method training sequence, which begins by teaching only the letter ‘K’ (default 20 WPM, 10 characters generated per training run, random word lengths):

$ koch

Move up to learning the first two characters in the Koch method (i.e. ‘K’ and ‘M’):

$ koch -c 2

This will randomly play 10 ‘K’ or ‘M’ characters in words of random lengths, then pause and wait for the user to hit the <Enter> key before printing the actual test sequence played.

You can also try a custom Koch alphabet, e.g. to learn in a different character order:

$ koch -a ABCDE -c 3

Several options together to generate a WAV file with a 30 WPM, 440 Hz Koch training session that’s 20 characters long teaching letters ‘K,’, ‘M,’ and ‘R’:

$ koch -w 30 -H 440 -c 20 -f koch.wav

Get help with CLI options:

$ koch -h

See also


Get the source and report any bugs on Github:

Version history

  • 0.0.3 - Band pass filter bug fix. Add CLI option to override default 200 Hz band pass filter bandwidth.
  • 0.0.2 - Limit code audio bandwidth to 200 Hz using bandpass filters. Improved file output behavior for easier scripting.

Release history Release notifications

This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
koch-0.0.3.tar.gz (6.6 kB) Copy SHA256 hash SHA256 Source None May 28, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page