blob: c407873544a7df09a199372a55b667f4a616c994 [file] [log] [blame]
Bill Cox13ad3b82010-12-14 15:53:55 -05001.TH SONIC 1
Bill Coxe0b250c2010-11-03 13:23:58 -04002
3.SH NAME
4sonic \- Speech speed manipulator
5
6.SH SYNOPSIS
Bill Coxebebbe42010-12-13 13:18:44 -05007.B sonic [OPTION]... inFile outFile
Bill Coxe0b250c2010-11-03 13:23:58 -04008
9.SH DESCRIPTION
10Sonic is used to make wav files of speech faster or slower. The primary advance
11in sonic is the ability to speed speech up by much more than 2X, with minimal
12distortion. However, sonic can be used for both speeding up and slowing down
Bill Coxebebbe42010-12-13 13:18:44 -050013speech files. Additionally, sonic can change the pitch and volume.
14
15.SH OPTIONS
16.TP
Bill Coxdb3f14d2011-04-15 12:43:20 -040017.B \-c
18Modify pitch by emulating vocal chords vibrating faster or slower. This causes
19more distortion than the default pitch scaling, but sounds more like the same
20person trying to talk higher or lower. The default pitch changes makes the
21voice sound like a larger or smaller person, but introduces little distortion.
22.TP
Bill Cox975afe12010-12-17 05:18:00 -050023.B \-p pitch
Bill Coxebebbe42010-12-13 13:18:44 -050024Set pitch scaling factor. 1.3 means 30%% higher.
25.TP
Bill Cox975afe12010-12-17 05:18:00 -050026.B \-q
27Disable all speed-up heuristics, possibly improving the quality slightly. This
28is mainly used for debugging the speed-up heuristics.
29.TP
Bill Cox3276bb02011-01-11 07:39:26 -050030.B \-r rate
Bill Cox1a154182011-07-16 23:16:40 -040031Adjust the speed of playback. This scales both the pitch and speed equally.
Bill Cox3276bb02011-01-11 07:39:26 -050032.TP
Bill Cox975afe12010-12-17 05:18:00 -050033.B \-s speed
Bill Coxebebbe42010-12-13 13:18:44 -050034Set speed up factor. 1.0 means no change, 2.0 means 2X faster.
35.TP
Bill Cox975afe12010-12-17 05:18:00 -050036.B \-v scaleFactor
37Scale volume by scaleFactor. 1.5 increases by 50%. Clips if the maximum range is
38exceeded.
Bill Coxe0b250c2010-11-03 13:23:58 -040039
40.SH EXAMPLES
Bill Coxebebbe42010-12-13 13:18:44 -050041
42.B sonic -s 3.2 book.wav book_fast.wav
43
Bill Coxe0b250c2010-11-03 13:23:58 -040044The above command would increase the speed of an audio book called book.wav by a
45factor of 3.2, and write the result in book_fast.wav.
Bill Coxebebbe42010-12-13 13:18:44 -050046
47.B sonic -s 0.5 -v 1.5 spanish.wav spanish_slow.wav
48
Bill Cox975afe12010-12-17 05:18:00 -050049This would slow down the file spanish.wav by a factor of 2, make the volume 50%
50louder, and write the result to spanish_slow.wav.
Bill Coxebebbe42010-12-13 13:18:44 -050051
52.B sonic -p 2.0 low.wav high.wav
53
54This would make a low voice sound very high pitched.
55
Bill Coxe0b250c2010-11-03 13:23:58 -040056.SH AUTHOR
57Bill Cox waywardgeek@gmail.com
58.BR
Bill Cox60eeb062015-02-27 10:17:45 -080059Sonic Version 0.2, Copyright 2010, Bill Cox, Apache 2.0 license