Transcribing piano recordings into MIDI files has never been easier thanks to ByteDance’s innovative transcription system. This guide will walk you through using the simple GUI for ByteDance’s Piano Transcription with pedals. Whether you’re on Windows, Linux, or macOS, you’ll learn how to get started in no time!
System Requirements
- OS: Windows 7 or later (64-bit), Linux, macOS (Intel/M1)
- Memory: At least 4GB
Note: The application has been tested specifically on Windows 10, Debian Linux 10, and macOS 12.1 M1.
Getting Started on Windows
- Download the Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019 and install it.
- Download and unpack the PianoTrans-v1.0.7z file (1.5GB download; use 7zip to unpack).
- Close other applications to free up memory (at least 2GB should be free).
- Run
PianoTrans.exefrom the PianoTrans directory. - Select audio/video files by holding CTRL for multiple selections.
- Your resulting MIDI files will be located in the same directory as the input files.
If you would like to utilize a right-click menu, run RightClickMenuRegister.bat to add the functionality. This allows you to select multiple audio/video files easily.
For GPU inference, PianoTrans will automatically use it, but if you encounter any issues, you can force CPU usage by running PianoTrans-CPU.bat.
Using Nix on Linux/macOS
This section is specifically for users who have Nix installed on their Linux/macOS systems. If you do not use Nix, refer to the upstream install and usage guide for Python pip.
- Open your terminal.
- Install and set up Nix by running:
- Next, create the configuration folder:
- Configure experimental features:
- Use Nix to install pianotrans with:
- To run pianotrans and open the GUI, use:
- Select audio/video files (hold CTRL or ⌘ for macOS to select multiple files).
sh <(curl -L https://nixos.org/nix/install) --daemon
mkdir -p ~/.config/nix
echo "experimental-features = nix-command flakes" >> ~/.config/nix/nix.conf
nix profile install github:azuwis/piano_trans
pianotrans
For command line interface (CLI) usage, run pianotrans file1 file2 .... To upgrade pianotrans, use:
nix profile list
nix --option tarball-ttl 1 profile upgrade 0
Troubleshooting
If you experience any issues during installation or usage, here are some tips to help you out:
- Make sure your system meets all the requirements mentioned above.
- If you encounter problems running the GUI, try using the CPU mode as specified in the Windows section.
- For transcription accuracy concerns, remember that this project is focused on the packaging and not the transcription algorithm itself. You can report issues to the upstream project here.
For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.
Conclusion
Using ByteDance's GUI for piano transcription allows you to easily transcribe recordings into MIDI files. By following the steps outlined above, you can be up and running with the software in no time. At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.

