Troubleshooting

1
2
3
4
5

# Check that D-Bus is running
systemctl --user status dbus

# If it is not running, start it
systemctl --user start dbus

1
2
3
4

# Depending on your features, these may be needed
systemctl --user status pulseaudio
systemctl --user status bluetooth
sudo systemctl status NetworkManager

1
2
3
4
5

# Run with detailed logs
RUST_LOG=debug vasak-desktop 2>&1 | tee vasak-debug.log

# Read the generated file
less vasak-debug.log

1
2
3
4
5

# Back up the configuration (just in case)
mv ~/.config/vasak ~/.config/vasak.backup

# Try starting again
vasak-desktop

1
2
3
4
5
6
7

# Depending on your package manager
sudo apt remove vasak-desktop
sudo apt install vasak-desktop

# Or if you use another distro
sudo dnf remove vasak-desktop
sudo dnf install vasak-desktop

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# Restart just the panel
pkill -f vasak-panel
# It should restart automatically in 2-3 seconds

# If it does not restart:
RUST_LOG=debug vasak-desktop --debug-panel 2>&1 | tee panel-debug.log

# Restart the whole application
pkill -f vasak-desktop
sleep 2
vasak-desktop &

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# Check monitor detection
xrandr --query  # For X11

# Or for Wayland with wlr-randr
wlr-randr

# Restart the application to detect the monitors again
pkill vasak-desktop
sleep 2
vasak-desktop

1
2
3
4
5
6
7
8

# Check your current resolution
xrandr --query | grep connected

# If it is wrong, set it
xrandr --output HDMI-1 --mode 1920x1080

# On Wayland it is normally detected automatically
# If not, check the system monitor configuration

1
2
3
4
5
6
7

# For PulseAudio
systemctl --user status pulseaudio
systemctl --user start pulseaudio  # If it is not running

# Or for PipeWire (more recent)
systemctl --user status pipewire
systemctl --user start pipewire

1
2
3
4
5
6
7
8
9

# List devices
pactl list sinks short

# Example output:
# 0	alsa_output.pci-0000_00_1f.3.analog-stereo	module-alsa-card.c	s16le 2ch 44100Hz	SUSPENDED

# If you see SUSPENDED, the device is not active
# Reactivate it:
pactl set-sink-state <ID> running

1
2
3
4
5
6
7
8

# See the current volume
pactl list sinks | grep Volume

# Set the volume (0-100%)
pactl set-sink-volume <ID> 50%

# Or turn the volume up
pactl set-sink-volume @DEFAULT_SINK@ +10%

1
2
3
4
5

# See whether it is muted
pactl list sinks | grep Mute

# Unmute
pactl set-sink-mute <ID> false

1
2
3
4
5

# If nothing works, restore the defaults
pulseaudio --kill
rm -rf ~/.config/pulse/
rm -rf ~/.local/share/pulse/
systemctl --user start pulseaudio

1
2
3
4
5
6
7
8
9

# Increase the PulseAudio buffer
# Edit: ~/.config/pulse/daemon.conf

# Look for or add:
default-fragment-size = 4096
default-tlength = 16384

# Restart
systemctl --user restart pulseaudio

1
2
3
4
5

# Check amplification
pactl list sinks | grep -A 30 "Volume levels"

# Try using the software amplifier
pactl set-sink-volume @DEFAULT_SINK@ 150%

1
2
3
4
5
6
7
8

# See the status
rfkill list bluetooth

# If it is blocked (blocked in software)
rfkill unblock bluetooth

# If it is hard-blocked (blocked physically)
# Check your laptop/keyboard for Bluetooth shortcuts

1
2
3
4
5

sudo systemctl start bluetooth
sudo systemctl enable bluetooth

# Check the status
sudo systemctl status bluetooth

1
2
3
4
5
6

# See the adapters
hciconfig -a

# If none appears, the hardware may not be supported
# Check:
lsusb | grep -i bluetooth

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# Start bluetoothctl
bluetoothctl

# Inside bluetoothctl:
power on              # Turn the adapter on
discoverable on       # Put it in discoverable mode
scan on              # Look for devices

# Wait until it sees your device, then:
pair XX:XX:XX:XX:XX:XX  # The device MAC
trust XX:XX:XX:XX:XX:XX
connect XX:XX:XX:XX:XX:XX

exit

1
2
3
4
5
6
7

# Make sure you are in the bluetooth group
groups | grep bluetooth

# If it does not appear, add yourself
sudo usermod -a -G bluetooth $USER

# You will need to log out and back in

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# Increase the distance or remove interference
# Typical problems:
# - Microwave ovens
# - WiFi on the same channel
# - Too many Bluetooth devices at once

# Check the health of the adapter
sudo hciconfig hci0 reset

# If it still disconnects, it is probably:
# - A problem with the device (low battery)
# - The system's Bluetooth controller
# - Radio interference

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# See the status
rfkill list wifi

# Enable it if it is blocked
rfkill unblock wifi

# See the physical device
ip link show | grep -i wlan

# Bring the interface up
sudo ip link set wlan0 up

1
2
3
4
5
6
7

# It should be running
systemctl status NetworkManager
sudo systemctl start NetworkManager

# See the network status
nmcli device status
nmcli radio

1
2
3
4
5
6
7
8
9

# Turn WiFi off and on
nmcli radio wifi off
sleep 2
nmcli radio wifi on

# Cycle the device
sudo ip link set wlan0 down
sleep 2
sudo ip link set wlan0 up

1
2
3
4
5
6
7

# See the networks
nmcli device wifi list

# If you see no networks, the adapter may be damaged
# Check physically
lsusb | grep -i network  # For USB
lspci | grep -i network  # For built-in

1
2
3
4
5
6
7
8
9

# Connect to an open network
nmcli device wifi connect "SSID"

# Connect to a protected network
nmcli device wifi connect "SSID" password "password"

# Verify the connection
nmcli device status
ping 8.8.8.8

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# Check the speed
nmcli device wifi list | grep SSID

# Check for interference (change channel)
# Routers usually pick automatically, but you can:

# See the channels in use in your area
sudo iwlist wlan0 scan | grep Channel

# If it is 5GHz WiFi, there is generally less interference
# Configure it on your router

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# Check the IP configuration
ip addr show

# If it has no IP (inet), request one
sudo dhclient wlan0

# Or with NetworkManager
nmcli connection down "SSID"
nmcli connection up "SSID"

# Check DNS
cat /etc/resolv.conf
ping 8.8.8.8  # Test against Google's DNS

1
2
3
4
5
6
7
8
9

# See which process is using the most
top -p $(pgrep -f vasak-desktop)

# Or use ps
ps aux | grep vasak-desktop

# See historical usage
RUST_LOG=debug vasak-desktop 2>&1 | tee performance.log
# (Reproduce the problem, then Ctrl+C)

1
2
3
4

# Edit: ~/.config/vasak-desktop/config.toml
[ui]
animations_enabled = false
animation_duration = 50

1
2
3

# In ~/.config/vasak-desktop/config.toml
[rendering]
refresh_rate = 30  # Down from 60

1
2
3
4

# Look for these in the configuration:
effects_enabled = false
blur_effects = false
transparency_effects = false

1
2
3
4
5

# See all the Vasak processes
pgrep -af vasak

# If there are duplicated processes, end them
pkill -f vasak-secondary-process

1
2
3
4
5

# Clear the configuration and restart
mv ~/.config/vasak ~/.config/vasak.backup
pkill vasak-desktop
sleep 2
vasak-desktop &

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# The configuration is read at startup
# Restart the application
pkill vasak-desktop
sleep 2
vasak-desktop &

# Check that the configuration saved correctly
cat ~/.config/vasak/system_config.json

# Check the permissions
ls -la ~/.config/vasak/system_config.json

# If you do not have read permission:
chmod 644 ~/.config/vasak/system_config.json

1
2
3
4
5
6
7
8

# Back up the current configuration
mv ~/.config/vasak ~/.config/vasak.backup

# On the next run it is recreated with default values
vasak-desktop

# If it works, you can restore individual settings by copying
# values from ~/.config/vasak.backup/system_config.json

1
2
3
4
5
6
7
8
9

# Adjust the system scale through GTK
gsettings set org.gnome.desktop.interface text-scaling-factor 1.25

# For X11, adjust the DPI
echo "Xft.dpi: 120" >> ~/.Xresources
xrdb -merge ~/.Xresources

# Restart to apply
pkill vasak-desktop && vasak-desktop &

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# For audio:
sudo usermod -a -G audio $USER

# For Bluetooth:
sudo usermod -a -G bluetooth $USER

# To access devices:
sudo usermod -a -G input $USER
sudo usermod -a -G dialout $USER

# These changes require logging out and back in
# Or run this in a new terminal:
su - $USER

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 1. Stop all the Vasak processes
pkill -f vasak

# 2. Stop related services
systemctl --user stop pulseaudio
systemctl --user stop dbus

# 3. Restart the system services
systemctl --user restart dbus
systemctl --user restart pulseaudio  # or pipewire if you use PipeWire

# 4. Start with debug
RUST_LOG=debug vasak-desktop 2>&1 | tee restart-debug.log