Peephole Montage — User Guide
Place listening points directly on a Sound in the Demo window, see the source windows and predicted montage timeline, adjust all montage settings interactively, preview the complete result, and commit only when the edit is ready.
What this does
Peephole Montage turns listening into the edit decision. A click on the waveform places a temporal anchor. Each anchor opens a window around that moment, and the resulting windows are assembled in the chronological order of the marks.
The entire session takes place in one interactive Demo window: marking, deleting, zooming, selecting montage style, changing joins and fades, previewing individual windows, previewing the full montage, and committing the final result.
Quick start
- Select one Sound. You may optionally also select one PointProcess to preload existing marks.
- Run
Peephole_montage.praat. - Click the source waveform wherever you want a peephole.
- Adjust the montage controls directly in the Demo window.
- Press P to build and play a complete preview.
- Continue editing if needed. The preview is invalidated whenever the edit changes.
- Press Enter to commit exactly the current edit.
Demo-window workflow
The main form is deliberately small. It contains only the output name, the PSOLA pitch-analysis range, Picture-window edit-map option, and playback option. All ordinary montage parameters are controlled interactively inside the Demo window.
The window combines:
- a full-file overview strip,
- a zoomable source waveform,
- visible peephole windows and marks,
- a montage timeline showing the expected output sequence,
- clickable style / fade / join / gain controls,
- and a status / keyboard-help area.
Marks & navigation
| Action | Function |
|---|---|
| Click waveform | Add a peephole. Clicking on an existing mark removes it. |
| Shift-click a mark | Audition that source window alone. |
| Click overview strip | Centre the zoomed source view on that location. |
| U | Undo the most recent mark edit. |
| C | Clear all marks; Undo can restore them. |
| + / − | Zoom the waveform view. |
| 0 | Return to the full source duration. |
| , / . | Scroll the current view backward / forward. |
| S | Play the visible source range. |
| P | Build and play the complete montage preview. |
| N | Generate a new session seed. |
| Enter | Commit the montage. |
| Esc | Cancel without committing the montage. |
Peephole windows
Symmetric
Asymmetric
Every window is clamped to the Sound domain. Windows cut by the file boundaries are therefore shorter than requested and are marked as clipped in the visualization.
Adaptive context
Adaptive Context begins with the current pre/post lengths and changes them using the local intensity of the recording and a preceding-pause test. Intensity is normalized relative to the current file's 10th and 90th intensity percentiles whenever those values are available.
A detected pause therefore lengthens the pre-context; stronger local intensity shortens the post-context. The adaptation changes source-window duration, not amplitude.
Four montage styles
| Style | Behavior |
|---|---|
| Pure peephole | Uses the selected source windows without style transformation, then applies the chosen edges and joins. |
| Adaptive context | Changes each source-window length from local intensity and preceding context before extraction. |
| Unreliable narrator | Uses a reproducible seed to introduce progressive pitch bias and, for stereo segments, optional L/R channel swaps. |
| Microscope | Expands or contracts each peephole. Pitch-preserving mode uses Praat Manipulation / PSOLA; preserve-pitch Off uses true varispeed so pitch and duration move together. |
Unreliable narrator
The permitted pitch-bias range grows through the marked sequence:
All channels of a segment use the same pitch ratio, so pitch mutation does not intentionally disturb the stereo image. Stereo channel flipping, when enabled, is a separate 50% decision per segment.
Microscope
A factor of 1 bypasses time transformation. With preserve pitch enabled, each channel is processed through pitch-based overlap-add using the Pitch floor / ceiling values from the form. With preserve pitch disabled, the segment is rendered by varispeed.
Edges & joins
Fade types
| Fade | Implementation |
|---|---|
| None | No explicit segment-edge envelope. |
| Linear | Linear sample-amplitude ramps. |
| Raised cosine | Half-cycle raised-cosine fade in / fade out. |
Per-segment fade duration is limited to 45% of the processed segment duration so opposite edge fades do not cross.
Join modes
| Mode | Behavior |
|---|---|
| Butt + edge fades | Segments are concatenated directly. The selected segment fades create the seam behavior. |
| Raised-cos overlap | Praat's overlap concatenation supplies the internal raised-cosine crossfades. The requested overlap is capped at 40% of the shortest processed segment. |
| Gap | Explicit digital silence is inserted between consecutive peepholes. |
Preview & session seed
Press P to render and play the current montage without committing it. The same session seed is used for preview and commit, so stochastic decisions remain stable.
Press N to request a new seed. This is particularly useful with Unreliable Narrator when you want another stochastic take while keeping the same marks and parameters.
The timeline initially predicts processed lengths. After a preview is built, the display can use measured segment lengths until the edit changes again.
Output gain handling
| Mode | Behavior |
|---|---|
| Attenuate only | If the final peak exceeds Peak target, scale down to the target; otherwise preserve the level. |
| Peak to target | Scale any non-silent montage up or down so its measured sample peak reaches the target. |
| None | No final gain change. |
Controls & defaults
Main form
| Control | Default | Role |
|---|---|---|
| Output name | peephole_montage | Name of the committed Sound. |
| Pitch floor | 75 Hz | Lower analysis bound for pitch-based style processing. |
| Pitch ceiling | 600 Hz | Upper analysis bound for pitch-based style processing. |
| Draw edit map in Picture window | On | Creates the final edit-map visualization after commit. |
| Play result | On | Automatically plays the committed montage. |
Interactive defaults
| Control | Default |
|---|---|
| Window length | 0.5 s |
| Asymmetric windows | Off |
| Pre / Post | 0.3 s / 0.2 s |
| Fade | Raised cosine, 10 ms |
| Join | Butt + edge fades |
| Transition amount | 20 ms |
| Montage style | Pure peephole |
| Unreliable Narrator stereo flip | On |
| Unreliable Narrator pitch-bias range | 0.5 semitone |
| Microscope time factor | 2.0 |
| Microscope preserve pitch | On |
| Microscope downmix stereo | Off |
| Gain handling | Attenuate only |
| Peak target | 0.99 |
Visualization
The live Demo window shows the relation between source time and montage time while you work. It includes the source waveform, highlighted windows, mark numbers, overview navigation, and a montage timeline.
Adaptive Context windows are shown with their current calculated extent. Clipped source windows are visibly distinguished. Microscope mode uses predicted output lengths until a preview supplies measured durations.
When the Picture-window edit map is enabled, commit also produces a static visualization summarizing the final edit.
Outputs
- Montage Sound — named from the Output name field.
- PointProcess
peephole_marks— retains the final marks for reuse. - Info report — lists source windows, clipping, style behavior, join/fade details, stochastic decisions, measured durations, and gain handling.
- Picture edit map — optional final visualization.
Notes & limitations
- Marks use clicks, not drag. Move a mark by removing and re-adding it.
- Preview rendering is blocking. Praat scripting cannot keep the interface responsive while complex previews are being rendered or played.
- Undo covers marks only. Settings are directly clickable and can simply be changed back.
- PSOLA depends on the source. Polyphonic, noisy, or weakly periodic material can produce artifacts in pitch-preserving Microscope mode.
- Very short windows may be skipped. A final usable source window must exceed approximately 2 ms.
Citation
Cohen, S. (2026). Praat AudioTools — Peephole Montage.