* In example: no longer overwrite output file without warning. * Add method to change the wavelength of an `AlternatingHann`. * Add a method to “step” the synthesis without starting new impulses. * Add a method to approximately check if there are any impulses active (on a synthesis).
|10 months ago|
|examples||10 months ago|
|src||10 months ago|
|.gitignore||10 months ago|
|COPYRIGHT||10 months ago|
|Cargo.toml||10 months ago|
|LICENSE-AGPL-3.0.md||10 months ago|
|README.md||10 months ago|
Tdpsola: an implementation of the tdpsola algorithm
TD-PSOLA (Time-Domain Pitch-Synchronous Overlap and Add) is an algorithm that allows to modify the pitch and the speed of a sound independently of each other.
The idea behind the algorithm on itself is quite simple, but hard to explain. I have found this documentation the clearest.
Advantages of TD-PSOLA:
- Preserves the formants, i.e. if you increase the pitch of a human voice, it doesn't sound like the person has been breathing from a helium balloon
- Performant algorithm for modest pitch/speed changes
Disadvantages of TD-PSOLA:
- Not robust against noise, only suitable for voiced sounds
- Requires a-priori knowledge of the fundamental frequency of the source sound
This is an implementation in the Rust programming language. Advantages of this implementation:
- separate analysis and synthesis, allowing you to re-use the analysis part
- speed and pitch can be manipulated independently at any time
- many tests
- implemented in a memory-safe programming language, without "unsafe" features
Disadvantages of this implementation:
- The algorithm is extra complicated in order to guarantee
A simple example can be found in the documentation or in the
A more worked-out example can be found in the
examples folder in the source code.
- suitable for real-time analysis and synthesis
- block-processing for extra speed (can currently only be used sample per sample)
We welcome contributions, both in the form of issues and in the form of pull requests. Before opening a pull request, please open an issue first so that you know whether a subsequent pull request would likely be approved.
If you don’t have a Codeberg account, alternatively, you can contribute via e-mail (an email address is in the Cargo.toml file). Just creating a Codeberg account is probably the easiest.
Unless explicitly stated otherwise, you agree that your contributions are licensed as described below.
This is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.