Troubleshooting

Troubleshooting

FFmpeg is unavailable

• Windows: restart Orynivo and allow the automatic download.
• Linux: install ffmpeg through the distribution package manager.
• macOS: install with Homebrew/MacPorts or let Orynivo download matching binaries into its user cache.

Finder-launched macOS applications do not inherit the same PATH as Terminal. Orynivo therefore also checks conventional package-manager paths.

No audio device or playback failure

• Confirm that the selected output profile still points to an available device.
• On Linux direct ALSA, close PipeWire or any other process holding the device.
• Try OpenAL for system-routed Linux output.
• ASIO capability queries may fail while another application owns the driver.

Remote server is unreachable

• Verify the base URL, port, and API key.
• Open /api/health in a browser.
• Confirm firewall and local-network routing.
• Check the server service and its data-directory permissions.

Library changes are missing

Wait for watcher activity to finish, use the header refresh action, or start a manual scan. Removing a configured root intentionally removes tracks outside the remaining roots.

Logs

Orynivo stores crash, seek, and controlled web-browsing diagnostics beneath its platform-specific application-data logs directory. Reports are sanitized and must not contain credentials or authenticated URLs.

When reporting a reproducible defect, open an issue.