Skip to content

Commit 0033620

Browse files
authored
Update README.md
1 parent 4c6201c commit 0033620

File tree

1 file changed

+12
-3
lines changed

1 file changed

+12
-3
lines changed

README.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,20 @@
11
# Python 3 Blue Box DTMF Tone Generator
2-
===================
32

4-
Modernized python bluebox
3+
Modernized python bluebox DTMF tone generator / dialer.
4+
5+
![image](https://user-images.githubusercontent.com/75656/223700347-4d9d1f94-854a-4245-b336-8122c2cbdcf6.png)
6+
57

68
## How it works
79

8-
You can run this in interactive mode, or from a file, pipe, stdin, etc.
10+
In essence, this is a simple utility that creates dual tone multi-frequency sine waves (50/50 mixed, but that can easily be adjusted). What does this mean? Well you know the sounds that you hear if you have the touchpad tones turned on when you dial a number in your phone? That's what this is. It's able to generate the tones that correspond to the number and output it to an audio device or a python `list` (for example).
11+
12+
This tool has a CLI interface which allows you to send a sequence of codes via `stdin`, pipes, files, as an argument, or in an interactive mode.
13+
14+
### Why?
15+
16+
Well, initially this was a fun little python 3 project from 2015, but I thought it would be nice to make it modern and extensible, essentially showcasing it as a framework, but this doesn't have to be limited to DTMF / MF, in theory with ease you could turn this into something that reads in code sequences (`str`) and outputs waves. Also due to issue #3 https://github.com/zeyus/Python3BlueBox/issues/3 it was clear that there were some bugs, so what better way to deal with it than adding tests and a way to decouple things!
17+
918

1019
## Installation
1120

0 commit comments

Comments
 (0)