This page aimed to help you fix common problems encountered while using spacefish.
My prompt is filling with errors
Try all of the following troubleshooting steps:
Verify that your fish installation is at the latest version
Update spacefish with
fisher add matchai/spacefish # or omf update spacefish
If errors persist, please open an issue
What's the weird symbol beside the
You need to have a powerline patched font in order to properly display
git branch symbol.
- Install any powerline compatible font like Fira Code or others.
- Configure your terminal emulator to use that font.
What's the weird character in front of a section?
This is not an issue with spacefish. Spacefish uses Unicode symbols to represent
SPACESFISH_*_SYMBOL in sections. To solve this problem:
Verify your terminal emulator supports Unicode characters with this command:
curl https://www.cl.cam.ac.uk/~mgk25/ucs/examples/UTF-8-demo.txt # or wget -O - https://www.cl.cam.ac.uk/~mgk25/ucs/examples/UTF-8-demo.txt
- Configure your terminal emulator to use UTF-8 character encoding.
In the event that Unicode characters aren't supported, you can replace them with characters that are compatible with your terminal with
SPACEFISH_*_SYMBOL options. Check out the Options page for more information.
Why is my prompt slow?
Spacefish may run more slowlyin big repositories since the status checks add up to be expensive operations.
To speed up your prompt, try to reduce the number of unused spacefish sections that are enabled. Spacefish only loads the sections mentioned in
SPACEFISH_PROMPT_ORDER. If you think some sections might not be be useful to you, you can disable them by not including their names in the prompt order.
Why do my section icons overlap each other?
This issue is due to how your terminal emulator renders Unicode 9 characters. To fix this issue:
- Make sure terminal uses Unicode Version 9 Widths.
- Let your terminal render ambiguous-width characters as double-width.
In iTerm follow these instructions:
- Go iTerm → Preferences… (⌘,) → Profiles → Text
- Check Unicode Version 9 Widths.
- Check Threat ambiguous-width characters as double-width.
- Reload your terminal's tab.
Why doesn't my prompt look like it does in the preview?
Preview shows a
spacefish setup with:
- Hyper as the terminal emulator.
- One Dark color theme from Atom editor.
- Fira Code with with ligatures as primary font (16px size).
My problem wasn't solved
If the above suggestions don't address your problem, feel free to open an issue, describe your problem and we will gladly help you.