Getting Started

Table of Contents

• Applying the theme to new terminals
• Making the colorscheme persist on reboot
• Numbers, garbage and junk is appearing in my terminal

NOTE: If you get junk or numbers printed in your terminal, add -t to all of your wal commands.

Applying the theme to new terminals

wal only applies the new colors to the currently open terminals. Any new terminal windows you open won't use the new theme unless you add a single line to your shell's start up file.

Add this line to your shell startup file. (.bashrc, .zshrc, .mkshrc etc.)

# Import colorscheme from 'wal'
# &   # Run the process in the background.
# ( ) # Hide shell job control messages.
(wal -r &)

# If the command above doesn't work,
# try this alternative.
setsid wal -r

Making the colorscheme persist on reboot

On reboot your new colorscheme won't be set or in use. To fix this you have to add a line to your .xinitrc or whatever file starts programs on your system. This wal command will set your wallpaper to the wallpaper that was set last boot and also apply the colorscheme again.

Without this you'll be themeless until you run wal again.

# Add this to your .xinitrc or whatever file starts programs on startup.
wal -i "$(< "${HOME}/.cache/wal/wal")"

Numbers, garbage and junk is appearing in my terminal

This issue occurs in all VTE based terminals (xfce4-terminal, gnome-terminal, termite etc) and is caused by these terminals not supporting one of the color changing sequences. You can easily fix the issue by adding -t to all of your wal commands.

The -t command disables the problem sequence and therefore stops the junk from being printed.