I enjoy doing Bunpro reviews with shadowing. While Bunpro already provides a lot of high-quality audio, there are still review items without audio (especially A-category vocabulary entries, which none have audio clips associated), and there is currently no way to attach audio to Self-Study Sentences.
Because of that, I built a tool that allows you to use your own audio files during Bunpro reviews.
I built this project with extensive help from ChatGPT.
I am not a professional software developer, but I was able to design, test, and iterate on this tool with AI assistance to support my own Bunpro workflow.
As with any community project, please use it at your own discretion.
This is an unofficial community project and is not affiliated with Bunpro.
What does it do?
After answering a review correctly, you can attach your own audio file to that sentence.
Once configured:
- Pressing P will play your custom audio.
- Clicking the Bunpro audio button will play your custom audio.
- The built-in Bunpro audio player (play/pause, progress bar, seeking, speed controls, etc.) continues to work.
- Works with Reviews, Cram sessions, and Self-Study Sentences.
Possible use cases:
- VoiceVox generated audio
- Personal shadowing recordings
- Audio clips from anime, dramas, games, and other media
Available Versions
Serverless Edition (Recommended)
Features:
- No Python required
- No local server required
- Only requires Tampermonkey
- Audio files are stored locally in your browser
- Easiest installation
Limitations:
- Audio is stored per browser profile
- Clearing browser data may remove stored audio
- Audio files must be selected manually
Installation:
- Install Tampermonkey.
- Import:
bunpro_local_audio_override_serverless.user.js - Refresh Bunpro.
That’s it.
Advanced User Edition
Features:
- Audio files are stored as normal files on disk
- Easy backup and migration between computers
- Supports automated workflows
- Ideal for users who generate lots of VoiceVox audio
- Supports fixed-path workflows such as C:\temp\001.wav
- Audio files are copied into a managed local library
- Run it on Raspberry Pi and tweak the code have access to your own audio clip from anywhere.
Requirements:
- Python 3
- Local helper service
Installation:
- Install Python 3.
- Extract the ZIP file.
- Run:
start_bunpro_audio_server_silent.cmd - Import:
bunpro_local_audio_override.user.js
Optional:
Run install_silent_startup_task.bat once if you would like the helper service to start automatically with Windows.
Usage
After answering a review correctly, the Local Audio Override panel will appear. Select an audio file and save it.
For the Advanced User Edition, the original WAV file will be copied into the tool’s local library and renamed using a hash-based filename. Once imported successfully, the original file can be deleted if desired.