GUIDE · 10
Troubleshooting
Fix common terminal, build, configuration, and opener problems.
The interface looks garbled
Confirm that the locale is UTF-8 and TERM identifies the terminal correctly. Zari uses ncursesw for wide-character rendering.
CMake cannot find curses
# Debian / Ubuntu
sudo apt install libncursesw5-dev
# Arch Linux
sudo pacman -S ncursesA configuration warning appears
Read the line number in the status message, correct that file, and press R. Unknown or invalid values fall back safely rather than crashing.
A file will not open
Zari invokes xdg-open as an argument vector. Ensure it is installed and that your desktop has a default application registered for the file type.