Morse Code Audio Generator

This Python program generates an audio file from morse code text input based on specified configurations.

Features

• Custom Sound Files: Specify your own sound files for dots and dashes.
• Configurable Output: Easily configure the output file name and path.
• Multiple File Formats: Select from multiple output formats including MP3, OGG, WAV, and FLAC.
• Adjustable Bitrate: Control the quality and size of the generated audio file with customizable bitrate settings.
• Flexible Timing Levels: Choose from beginner, intermediate, advanced or arbitrary for custom timing delays.
• Word Separator: Define a custom separator to distinguish between words in your Morse code input.
• Dynamic File Naming: Optionally use the current date and time as part of the output file name.
• User-Friendly Input: Enter Morse code input directly and get instant audio output.
• Easy Configuration: Modify the config.cfg file to set preferences and customization options.

Installation

1. Clone the repository:

   git clone https://github.com/LautaroColella/morse-practice-audio-generator.git
   cd morse-practice-audio-generator

2. Install dependencies:

   pip install pydub

   IMPORTANT: pydub requires ffmpeg to work, you have to install it from the oficial website and add it to your PATH.

3. Prepare configuration:

   Create or modify config.cfg file according to your preferences. See Configuration Details below for more information.

Usage

1. Run the program:

   python audio_generator.py

2. Enter text input:

   Enter the Morse code text you wish to convert to audio, separated by the specified word separator (default is "/").

3. Output:

   The program will generate an audio file (default is morse.mp3) in the same directory.

Configuration Details

The config.cfg file allows customization for Morse code audio generation

• dot_sound_file: Path to the sound file for a dot.
• dash_sound_file: Path to the sound file for a dash.
• file_name: Name of the generated audio file.
• file_format: Format of the generated audio file.
• bitrate: Sound quality for determining file size.
• use_current_time: Adds the current time in the file name.
• word_separator: Separator used to split words in the input.
• level: Specifies the Morse code timing level.

Level Settings:

• beginner: Suitable for beginners, with longer pauses.
• intermediate: Uses Farnsworth Timing.
• advanced: Standard Morse code timing.
• arbitrary: Define custom delays

For "arbitrary" level:

• arbitrary_delay_between_sounds: Custom delay between sounds (--. is - %DELAY% -.)
• arbitrary_delay_between_characters: Custom delay between characters (- -. is - %DELAY% -.)
• arbitrary_delay_between_words: Custom delay between words. (--. - / -. is --. - %DELAY% -.)

Example Configuration

[settings]
dot_sound_file = sounds/dot.mp3
dash_sound_file = sounds/dash.mp3
file_name = morse
use_current_time = 1
file_format = mp3
bitrate = 32k
word_separator = /
level = beginner
arbitrary_delay_between_sounds = 3
arbitrary_delay_between_characters = 9
arbitrary_delay_between_words = 13

LICENSE

MIT License

Copyright (c) 2024 Lautaro Colella

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.