Python program to render wave files into oscilloscope views, featuring advanced correlation-based triggering algorithm
Corrscope renders oscilloscope views of WAV files recorded from chiptune (game music from retro sound chips).
Corrscope uses "waveform correlation" to track complex waves (including SNES and Sega Genesis/FM synthesis) which jump around on other oscilloscope programs.
Sample results can be found on my Youtube channel at https://www.youtube.com/nyanpasu64/videos.
Documentation is available at https://corrscope.github.io/corrscope/.
Corrscope is currently in maintenance mode until further notice. The program basically works, but I may not respond to issues. For technical support, contact me at Discord (https://discord.gg/CCJZCjc), or alternatively in the issue tracker (using the "Support/feedback" template). Pull requests may be accepted if they're clean.
- Releases (recommended): https://github.com/corrscope/corrscope/releases
- Dev Builds: https://ci.appveyor.com/project/nyanpasu64/corrscope/history
- Download Windows binary releases (zip files), then double-click
corrscope (args)via CLI.
- Download cross-platform Python packages (whl), then install Python 3.6+ and run
pip install *.whl.
Installing from PyPI via Pip (cross-platform, releases)
Install Python 3.6 or above (3.5 will not work).
# Installs into per-user Python environment. pip3 install --user corrscope corr (args)
Running from Source Code (cross-platform, dev master)
Install Python 3.6 or above (3.5 will not work), and Poetry.
# Installs into an isolated environment. # Install Poetry (only do this once) curl -sSL https://raw.githubusercontent.com/sdispater/poetry/master/get-poetry.py | python cd path/to/corrscope poetry install corrscope # --develop is implied poetry run corr (args)
- Open GUI:
corrscope.exeto create new project
corrscope.exe file.yamlto open existing project
- Add audio to play back
- On the right side of the window, click "Browse" to pick a master audio file.
- Add oscilloscope channels
- On the right side of the window, click "Add" to add WAV files to be viewed.
- Edit settings
- Global settings on the left side of the window
- Per-channel on the right side
- Play or render to MP4/etc. video (requires ffmpeg)
- Via toolbar or menu
corrscope split*.wav --audio master.wav -w
- Specify all channels on the command line.
--audiospecifies master audio track.
- Creates file
master.yamlto change settings.
Play (requires ffmpeg):
corrscope master.yaml -p/--play
Render and encode MP4 video (requires ffmpeg)
corrscope master.yaml -r/--render
Issues, feature requests, and pull requests are accepted.
This project uses Black code formatting. Either pull request authors can reformat code before creating a PR, or maintainers can reformat code before merging.
You can install a Git pre-commit hook to apply Black formatting before each commit. Open a terminal/cmd in this repository and run:
pip install --user pre-commit pre-commit install
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size corrscope-0.7.0-py3-none-any.whl (98.9 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size corrscope-0.7.0.tar.gz (86.8 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for corrscope-0.7.0-py3-none-any.whl