metadata

title: Morse Tunes
emoji: 🐨
colorFrom: pink
colorTo: purple
sdk: gradio
sdk_version: 5.8.0
app_file: app.py
pinned: false
license: apache-2.0
short_description: Converts text to morse code and tunes

morse-tunes

MorseTunes is a Python library and Gradio-based app that lets you convert text to Morse code and optionally play the Morse code as audio. Use it as a Python library, command-line tool, or through a web-based Gradio interface.

Features

Text to Morse Code Conversion: Converts any text into the equivalent Morse code.
Audio Playback: Plays Morse code as audio tunes (dot and dash sounds).
Interactive Web App: Use a Gradio interface for a user-friendly experience.
Simple to Use: Works as a standalone Python library or through a Gradio app.

Installation

Clone the repository:

git clone https://github.com/wisalkhanmv/morsetunes.git
cd morsetunes

Install the dependencies:
```
pip install -r requirements.txt
```

Usage

Gradio Web App

Run the Gradio app to interact with MorseTunes in your browser:

python main.py

Open the provided link in your browser (default is http://127.0.0.1:7860) to use the app. Enter text to convert it into Morse code and optionally play the audio.

Python Code Integration

Use MorseTunes as a Python library in your projects.

Example: Convert Text to Morse Code

from morse_tunes.morse import text_to_morse

text = "Hello World"
morse_code = text_to_morse(text)
print(f"Morse Code: {morse_code}")

Example: Play Morse Code as Audio

from morse_tunes.audio import play_morse

morse_code = "... --- ..."
play_morse(morse_code)

Command Line Tool

If you want a command-line interface, you can use the main.py file as a simple script:

python main.py

How It Works

Text Conversion: The library converts each letter in your text to its Morse code equivalent using a predefined dictionary.
Audio Playback: The library generates sounds using winsound (Windows). Each dot (.) is a short beep, and each dash (-) is a longer beep.
Gradio App: The interactive interface uses the Gradio library to make it easy to use in a web browser.

Development

Feel free to contribute! Clone the repository and make your changes.

git clone https://github.com/yourusername/morsetunes.git
cd morsetunes

License

This project is licensed under the MIT License. See the LICENSE file for details.

Enjoy coding and learning with MorseTunes!