Troubleshooting Setup Issues

// Missing Unicode/UTF-8 Locale

If you see broken box-drawing characters on startup, your system locale is likely set to a non-UTF-8 character set. Fix this by setting the LANG environment variable:

export LANG=en_US.UTF-8
termstudio

// Permission Denied Errors

If TermStudio fails to write config files, make sure the user has write access to the config folder:

sudo chown -R $USER:$USER ~/.config/termstudio/

// Terminfo / NCurses Issues

If you get terminal mismatch issues, reset the terminfo target in your shell:

export TERM=xterm-256color

🚨 CAUTION

Do not run TermStudio as root (using sudo) unless editing system files, as it will lock configuration files to the root user.