sebastian
/
apt-decoder
1
0
Fork 0
Code Issues Pull Requests Actions Releases 3 Wiki Activity

Updated readme
ci/woodpecker/push/woodpecker Pipeline was successful Details

This commit is contained in:
Sebastian 2022-04-10 19:08:45 +02:00
parent f44b58bb43
commit b9b971f1b0
2 changed files with 21 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
gui.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 113 KiB

30
readme.md
View File

@ -12,25 +12,37 @@ apt-decoder provides a lightweight, simple to use and easy to understand solutio
Building Building
-------- --------
1. Install the rust compiler and cargo. 1. Install the development packages for `libgtk3` and `libxcb` for your distro.
E.g. using rustup (Try installing rustup using yourpackage manager, E.g. for anything Debian based:
don't use the stupid **curl | sh** stuff.) `sudo apt install libgtk-3-dev libxcb-shape0-dev libxcb-xfixes0-dev`
2. Run `cargo build --release` 2. Install the rust compiler and cargo.
3. The `apt-decoder` binary is in `target/release` E.g. using rustup (Try installing rustup using your package manager,
4. Done don't use the stupid `curl | sh` stuff.)
3. Run `cargo build --release`
4. The `apt-decoder` binary is in `target/release`
5. Done
The default build will build a binary that contains,
both the GUI and the CLI version of the tool.
If you need something more lightweight (with no external dependencies),
it is also possible to build a pure-rust CLI-only version,
using `cargo build --release --no-default-features`.
Usage Usage
----- -----
1. Save a received and FM-demodulated satellite signal as WAV-file. 1. Save a received and FM-demodulated satellite signal as WAV-file.
The WAV file has to be **mono**, **48kHz** and **32bit float**. The WAV file has to be **mono**, **48kHz** and **32bit float**.
When in doubt you can use audacity to convert your file into this format. When in doubt you can use audacity to convert your file into this format.
2. Run `apt-decoder <your WAV file> <destination PNG file>` 2. To run `apt-decoder` in GUI mode just execute the binary.
You can also run the example contained in this repo: For CLI mode use the `-n` flag:
`apt-decoder noaa19_short.wav noaa19_short.png` `apt-decoder -n <your WAV file> <destination PNG file>`
For testing you can try the example contained in this repo:
`apt-decoder -n noaa19_short.wav noaa19_short.png`
3. Look at the generated PNG file, adjust the dynamic and contrast with your favorite tool. 3. Look at the generated PNG file, adjust the dynamic and contrast with your favorite tool.
4. Done 4. Done
![gui example](gui.png)
![long sample](example.png) ![long sample](example.png)
Theory of Operation Theory of Operation