Add instructions and better description to README
This commit is contained in:
parent
a9189ef1dc
commit
9e3da7e005
1 changed files with 31 additions and 1 deletions
30
README.md
30
README.md
|
@ -1,3 +1,33 @@
|
||||||
# AudioMorseDecoder
|
# AudioMorseDecoder
|
||||||
|
> Dot dot hash!
|
||||||
|
|
||||||
A C# program that uses NAudio to analyze an audio file and decode the detected morse signal. Currently not particularly tolerant of noise.
|
A C# program that uses NAudio to analyze an audio file and decode the detected morse signal. Currently not particularly tolerant of noise.
|
||||||
|
|
||||||
|
Features:
|
||||||
|
|
||||||
|
- A two-tiered buffer system to reduce memory usage when reading long files
|
||||||
|
- A multi-step tokeniser
|
||||||
|
- Extracts context-free tokens from the rolling buffer first
|
||||||
|
- Converts context-free tokens into contextual tokens second
|
||||||
|
- Noise gate to extract first-level tokens
|
||||||
|
- AI-like logic to identify the speed of the morse code detected
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
|
||||||
|
### Compiling
|
||||||
|
Open the solution in Visual Studio / MonoDevelop / Xamarin and hit build. Alternatively, linux users can run `nuget restore && msbuild` in the root of this repository.
|
||||||
|
|
||||||
|
### Usage
|
||||||
|
Use the program like this:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./MorseDecoder.exe "/path/to/audio/file.wav"
|
||||||
|
```
|
||||||
|
|
||||||
|
In theory, it should support multiple audio file formats as it uses an NAudio `AudioFileReader` to read the samples from the source file.
|
||||||
|
|
||||||
|
The output will show the detected morse code, and the deciphered text.
|
||||||
|
|
||||||
|
## License
|
||||||
|
This program is licensed under the [Mozilla Public License 2.0](https://git.starbeamrainbowlabs.com/sbrl/AudioMorseDecoder/src/master/LICENSE).
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue