Troubleshooting
How to troubleshoot common screen recording problems
Isolate source, permission, audio, performance and export failures with short repeatable tests.
Make the failure reproducible
Save anything important before changing settings. Write down the operating system, application version, capture source and output settings. Then reduce the problem to a short recording in a plain application with dummy data. A complicated scene can hide whether the failure comes from capture, editing or playback.
Change one condition per test. Keep a note such as “window capture, microphone off, WebM, 720p.” If a test succeeds, add the next requirement. This gives a useful report even if you cannot solve the problem yourself.
No sources, black picture or missing windows
Check that you selected the intended display or window. Refresh the source list after opening the target application. Keep the target visible and test a simple text window; protected media or special rendering paths may behave differently.
On macOS, verify Screen Recording permission for the application actually running, then quit and reopen it. Development Electron and an installed CapTrik build may appear as different permission entries. Apple's permission instructions describe the system controls.
If a dialog is missing from window capture, it may be a separate window. Test a broader source only after removing private information. Do not bypass protected-content restrictions as a troubleshooting technique.
Missing sound or click effects
Test microphone alone, system audio alone, and then the desired combination. Check the OS input selection and permissions, not only the recorder toggle. Use a spoken sentence and a harmless sound so you can identify which track is missing.
CapTrik's system-audio request can fall back to video-only capture when loopback is unavailable. The microphone request can also fail independently. A moving preview does not prove audio is present; export the sample and listen.
For click effects, separate pointer movement from click detection. CapTrik polls cursor position and uses a native hook for clicks. On macOS the hook needs Accessibility permission. Read the hook status and restart after permission changes. See product-specific checks.
Stutter, soft text or slow export
Compare the source preview with the exported file. If the source is already choppy, simplify the capture scene and close unnecessary workloads. If only the export is slow or uneven, test a shorter range with fewer layers and a lower output preset.
For soft text, enlarge the application text before capturing and reduce excessive framing padding. Upscaling cannot recover detail that was not recorded. Test at the destination viewing size so you do not mistake a large local preview for readable delivery.
Keep free disk space for the output and enough memory for media processing. No fixed hardware requirement or guaranteed frame rate is inferred from the presence of a quality option.
Export will not save or play
- Try a writable local folder with a new filename and adequate free space.
- Export a short range as WebM to isolate MP4 encoder support.
- Inspect the actual file type if its extension and player behavior disagree.
- Open the result in another compatible player.
- Test the destination upload separately from local playback.
Read the format guide before renaming or converting a file. If none of the tests work, report the exact error, settings and smallest reproduction through Contact. Share sanitized examples, not a full private recording.
A useful diagnosis identifies the failing stage. Once you know whether the problem is source access, inputs, rendering, saving or destination playback, you can change the relevant part instead of repeatedly recording the whole task.
