RAON troubleshooting guide
Find the real reason an audio file will not upload
“Upload failed” can describe several different problems. Converting everything to MP3 may hide one problem while creating another. Diagnose the stage first: selecting the file, decoding it, creating an output, or submitting that output to another service.
Fast diagnosis
- “File type not allowed”: create an MP3 compatibility copy.
- “File too large”: trim unused time, then lower MP3 bitrate.
- RAON Tools cannot read the file: the browser may not support the internal codec, or the file may be damaged.
- Conversion finishes but the result will not play: keep the original, retry with one file, and verify the source in a trusted player.
- The browser tab closes or freezes: reduce batch size and file duration; local processing uses device memory.
Error-to-action map
| What you observe | Likely category | First safe action |
|---|---|---|
| The file picker refuses the file | Extension not allowed for the selected tool | Choose the matching conversion mode; do not rename the extension |
| The file is selected but decoding fails | Unsupported internal codec, damaged file, or protected media | Open the source in its original app and export standard WAV, MP3, or M4A |
| The output is larger than expected | High bitrate, WAV export, or long duration | Confirm output format and estimate size from duration |
| A website rejects the converted result | Destination rules, size limit, duration limit, or filename issue | Read that site's accepted formats and limits before reconverting |
| Only one file in a batch fails | Problem specific to that source | Process the file alone and verify it in a media player |
| Every file fails after an update | Browser, script, or network dependency issue | Refresh once, use a current browser, and report the exact message |
Extension and codec are different
A filename such as `lesson.m4a` describes a container. The audio inside is commonly AAC, but containers can hold different codecs. OGG can hold Vorbis or OPUS. WAV is commonly PCM but not every WAV is uncompressed PCM. Renaming `file.aac` to `file.mp3` changes the label only; it does not encode MP3 audio and can make diagnosis harder.
If a specialist recorder or editing program created the file, open it in that program and use Export or Save As. A standard PCM WAV is the most predictable bridge to another editor. MP3 is the broadest everyday delivery format when an upload form does not clearly document modern formats.
Reduce size in the least damaging order
- Check the actual limit. A form may limit file size, duration, or both.
- Trim unused time. Removing silence and unrelated sections reduces data without lowering quality in the remaining audio.
- Use mono only when appropriate. Do not remove stereo information from music merely to meet a small limit.
- Lower MP3 bitrate one step. Compare 128 versus 96 kbps for speech or 256 versus 192 kbps for music.
- Verify the result. Play the download and confirm that the duration and ending are complete.
For constant-bitrate MP3, one minute at 128 kbps is approximately 0.96 MB before small overhead. Use the bitrate size table to estimate whether a setting can meet the destination limit before waiting for another conversion.
Browser and memory failures
Browser conversion holds decoded audio in memory. A compressed source that looks small on disk can expand substantially after decoding because every sample must be represented for processing. Long stereo recordings and multiple files increase the pressure. This is why RAON Tools queues up to ten selected files and handles them sequentially instead of decoding all of them at once.
When a tab becomes slow, retry with one file and close other heavy tabs. Keep the device awake, avoid private browsing modes that aggressively clear downloads, and do not switch networks expecting it to speed up local encoding. A network is still needed for external script libraries on first load, but the selected media is designed to remain in the browser.
Information that makes a bug report useful
Do not send the private source file first. Send the following information to sundaymusic@kakao.com:
- RAON tool and selected mode
- Browser name and version, device type, and operating system
- Visible filename extension, approximate size, and duration
- Whether the file plays in a normal media player
- The exact on-screen error message and the step where it appeared
If a reproducible sample is needed, use a short non-private file that you created or have permission to share.
한국어 핵심 정리
오디오 파일이 안 될 때 확장자만 바꾸지 마세요. 파일 선택이 안 되는지, 브라우저가 내부 코덱을 읽지 못하는지, 변환 결과가 너무 큰지, 다른 사이트가 결과를 거절하는지 단계를 구분해야 합니다.
용량 문제는 무음 구간 자르기, 비트레이트 한 단계 낮추기 순서로 해결하세요. 특정 파일만 실패하면 한 개만 다시 처리하고 원본 프로그램에서 표준 WAV나 MP3로 내보내 보세요. 중요한 원본은 결과 확인 전까지 삭제하지 마세요.