Skip to content

Commit 62fedc5

Browse files
committed
Readme updates
1 parent 640ea77 commit 62fedc5

1 file changed

Lines changed: 11 additions & 10 deletions

File tree

README.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,19 +2,18 @@
22
[![License](https://img.shields.io/badge/license-GPLv2-blue.svg)](https://github.com/Indiscipline/zrtstr/blob/master/LICENSE)
33
> [Third Hemisphere Studio](https://thirdhemisphere.studio) tooling
44
5-
Command line application for checking WAV-files for identical channels, detecting faux-stereo files generated by some audio-editing software and DAWs (such as old versions of Cubase). Outputs a true-mono WAV file on detection of faux-stereo. Takes left channel of the input file, writes in the same location with -MONO suffix in file name.
5+
Command line application for checking WAV-files for identical channels, detecting faux-stereo files generated by some audio-editing software and DAWs (such as old versions of Cubase). Outputs a true-mono WAV file on detection of faux-stereo. Takes the left channel of the input file, writes the converted file in the same location with the `-MONO` suffix in the name.
66

7-
Developed using these wonderful crates:
8-
9-
**[Hound](https://github.com/ruuda/hound)**, **[Clap](https://github.com/kbknapp/clap-rs)**, **[pbr](https://github.com/a8m/pb)**
107

118
## Usage
129
Provide zrtstr with an input file as an argument, or run it from a directory full of target WAV files.
1310

1411
Full help available on `--help` switch.
1512

1613
## How does it work?
17-
Zrtstr reads interleaved channel samples from a target stereo file one by one and compares left and right samples. If the difference is present (and higher than the threshold given in `--dither` mode) than file considered true-stereo and program tries to write a mono copy. **Defaults include a reasonable dither threshold value, for strict checking set it to zero with `-d 0`!**.
14+
Zrtstr reads interleaved channel samples from a target stereo file one by one and compares left and right samples. If the difference is present (and higher than the threshold given in `--dither` mode) than file considered true-stereo and program tries to write a mono copy.
15+
16+
**Defaults include a reasonable dither threshold value, for strict checking set it to zero with `-d 0`!**
1817

1918
## Installation
2019
Rearchiver is tested to work under Windows and GNU/Linux. Probably works on OSX with no changes.
@@ -25,7 +24,9 @@ Rearchiver is tested to work under Windows and GNU/Linux. Probably works on OSX
2524
### How to build
2625
Developed on nightly Rust, as stable makes getting samples for multiple channels a bit more problematic for `hound`.
2726

28-
To build the code, run:
27+
Built using these wonderful crates: **[Hound](https://github.com/ruuda/hound)**, **[Clap](https://github.com/kbknapp/clap-rs)**, **[pbr](https://github.com/a8m/pb)**.
28+
29+
To build the program, download the source code and run:
2930

3031
```
3132
$ cargo build --release
@@ -36,12 +37,12 @@ and the executable will be in `target/release/zrtstr`.
3637
## TODO
3738
Here are the current problems and planned features:
3839

39-
- [ ] **Dither thresholding in dB**
40-
- [ ] **Variable default dither threshold based on bitdepth**
41-
- [ ] **Add automatic tests**
40+
- [ ] Dither thresholding in dB
41+
- [ ] Variable default dither threshold based on bitdepth
42+
- [ ] Add automatic tests
4243

4344
## Contributing
44-
The project is open for contributions. Any help and/or critique is appreciated. Take a stab at the TODO above.
45+
The project is open for contributions. Any help and/or critique is appreciated. Take a stab at the TODO list above.
4546

4647
Feel free to file a bug report or feature request via [Issues](https://github.com/Indiscipline/zrtstr/issues).
4748

0 commit comments

Comments
 (0)