Solucion a Problemas
Problemas de Inicio
La aplicación no inicia
Síntoma
Ejecutas vasak-desktop pero nada sucede o se cierra inmediatamente.
Solución Paso a Paso
Paso 1: Verifica servicios del sistema
1
2
3
4
5
|
# Comprueba que D-Bus está corriendo
systemctl --user status dbus
# Si no está corriendo, inicia lo
systemctl --user start dbus
|
Paso 2: Verifica servicios opcionales
1
2
3
4
|
# Dependiendo de tus funcionalidades, estos pueden ser necesarios
systemctl --user status pulseaudio
systemctl --user status bluetooth
sudo systemctl status NetworkManager
|
Paso 3: Ejecuta con logs de debug
1
2
3
4
5
|
# Ejecutar con logs detallados
RUST_LOG=debug vasak-desktop 2>&1 | tee vasak-debug.log
# Revisa el archivo generado
less vasak-debug.log
|
Paso 4: Limpia caché y configuración
1
2
3
4
5
|
# Backup de configuración (por si acaso)
mv ~/.config/vasak ~/.config/vasak.backup
# Intenta iniciar de nuevo
vasak-desktop
|
Paso 5: Reinstala la aplicación
1
2
3
4
5
6
7
|
# Según tu gestor de paquetes
sudo apt remove vasak-desktop
sudo apt install vasak-desktop
# O si usas otra distro
sudo dnf remove vasak-desktop
sudo dnf install vasak-desktop
|
Problemas de Pantalla y Monitor
Panel no aparece
Síntoma
No ves el panel del sistema en ninguna pantalla.
Solución
1
2
3
4
5
6
7
8
9
10
11
|
# Reinicia solo el panel
pkill -f vasak-panel
# Debería reiniciarse automáticamente en 2-3 segundos
# Si no se reinicia:
RUST_LOG=debug vasak-desktop --debug-panel 2>&1 | tee panel-debug.log
# Reinicia la aplicación completa
pkill -f vasak-desktop
sleep 2
vasak-desktop &
|
Panel no cubre todos los monitores
Síntoma
El panel no aparece en todos los monitores conectados.
Solución
1
2
3
4
5
6
7
8
9
10
|
# Verifica la detección de monitores
xrandr --query # Para X11
# O para Wayland con wlr-randr
wlr-randr
# Reinicia la aplicación para redetectar monitores
pkill vasak-desktop
sleep 2
vasak-desktop
|
Resolución incorrecta o pixelado
Síntoma
La interfaz se ve pixelada o a resolución incorrecta.
Solución
1
2
3
4
5
6
7
8
|
# Verifica tu resolución actual
xrandr --query | grep connected
# Si es incorrecta, ajústala
xrandr --output HDMI-1 --mode 1920x1080
# En Wayland, normalmente se detecta automáticamente
# Si no, verifica en configuración de monitor del sistema
|
Problemas de Audio
Sin sonido
Síntoma
No hay sonido en ninguna aplicación.
Solución Paso a Paso
Paso 1: Verifica que el servicio de audio está corriendo
1
2
3
4
5
6
7
|
# Para PulseAudio
systemctl --user status pulseaudio
systemctl --user start pulseaudio # Si no está corriendo
# O para PipeWire (más reciente)
systemctl --user status pipewire
systemctl --user start pipewire
|
Paso 2: Verifica dispositivos de audio
1
2
3
4
5
6
7
8
9
|
# Lista dispositivos
pactl list sinks short
# Ejemplo de salida:
# 0 alsa_output.pci-0000_00_1f.3.analog-stereo module-alsa-card.c s16le 2ch 44100Hz SUSPENDED
# Si ves SUSPENDED, el dispositivo no está activo
# Reactívalo:
pactl set-sink-state <ID> running
|
Paso 3: Verifica volumen
1
2
3
4
5
6
7
8
|
# Ver volumen actual
pactl list sinks | grep Volume
# Establecer volumen (0-100%)
pactl set-sink-volume <ID> 50%
# O subir volumen
pactl set-sink-volume @DEFAULT_SINK@ +10%
|
Paso 4: Verifica que no está silenciado
1
2
3
4
5
|
# Ver si está muted
pactl list sinks | grep Mute
# Des-silenciar
pactl set-sink-mute <ID> false
|
Paso 5: Restaura configuración
1
2
3
4
5
|
# Si nada funciona, restaura a valores por defecto
pulseaudio --kill
rm -rf ~/.config/pulse/
rm -rf ~/.local/share/pulse/
systemctl --user start pulseaudio
|
Audio entrecortado o latencia
Síntoma
El audio suena entrecortado, con pausas o con demora.
Solución
1
2
3
4
5
6
7
8
9
|
# Aumenta el buffer de PulseAudio
# Edita: ~/.config/pulse/daemon.conf
# Busca o añade:
default-fragment-size = 4096
default-tlength = 16384
# Reinicia
systemctl --user restart pulseaudio
|
Volumen muy bajo
Síntoma
El volumen está al máximo pero muy bajo.
Solución
1
2
3
4
5
|
# Verifica amplificación
pactl list sinks | grep -A 30 "Volume levels"
# Intenta usar el amplificador de software
pactl set-sink-volume @DEFAULT_SINK@ 150%
|
Problemas de Bluetooth
Bluetooth no detecta dispositivos
Síntoma
No puedes parear o conectar dispositivos Bluetooth.
Solución Paso a Paso
Paso 1: Verifica que Bluetooth está habilitado
1
2
3
4
5
6
7
8
|
# Ver estado
rfkill list bluetooth
# Si está blocked (bloqueado en software)
rfkill unblock bluetooth
# Si está hard-blocked (físicamente bloqueado)
# Verifica tu laptop/teclado para atajos Bluetooth
|
Paso 2: Inicia el servicio de Bluetooth
1
2
3
4
5
|
sudo systemctl start bluetooth
sudo systemctl enable bluetooth
# Verifica estado
sudo systemctl status bluetooth
|
Paso 3: Verifica interfaz Bluetooth
1
2
3
4
5
6
|
# Ver adaptadores
hciconfig -a
# Si no aparece ninguno, el hardware podría no estar soportado
# Verifica:
lsusb | grep -i bluetooth
|
Paso 4: Pon el adaptador en modo discoverable
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
# Inicia bluetoothctl
bluetoothctl
# Dentro de bluetoothctl:
power on # Enciende el adaptador
discoverable on # Pon en modo descubierto
scan on # Busca dispositivos
# Espera a que vea tu dispositivo, luego:
pair XX:XX:XX:XX:XX:XX # MAC del dispositivo
trust XX:XX:XX:XX:XX:XX
connect XX:XX:XX:XX:XX:XX
exit
|
Paso 5: Verifica permisos
1
2
3
4
5
6
7
|
# Asegúrate de que estás en el grupo bluetooth
groups | grep bluetooth
# Si no aparece, añádete
sudo usermod -a -G bluetooth $USER
# Necesitarás cerrar sesión y entrar de nuevo
|
Se desconecta frecuentemente
Síntoma
El dispositivo Bluetooth se desconecta solo.
Solución
1
2
3
4
5
6
7
8
9
10
11
12
13
|
# Aumenta la distancia o elimina interferencias
# Problemas típicos:
# - Microondas
# - WiFi en el mismo canal
# - Muchos dispositivos Bluetooth simultáneamente
# Verifica integridad del adaptador
sudo hciconfig hci0 reset
# Si sigue desconectándose, probablemente sea:
# - Problema del dispositivo (batería baja)
# - Controlador Bluetooth del sistema
# - Interferencia de radio
|
Problemas de Red/WiFi
WiFi no aparece o no se conecta
Síntoma
No ves redes WiFi disponibles o no puedes conectarte.
Solución Paso a Paso
Paso 1: Verifica que WiFi está habilitado
1
2
3
4
5
6
7
8
9
10
11
|
# Ver estado
rfkill list wifi
# Habilitar si está bloqueado
rfkill unblock wifi
# Ver dispositivo físico
ip link show | grep -i wlan
# Activar interfaz
sudo ip link set wlan0 up
|
Paso 2: Verifica NetworkManager
1
2
3
4
5
6
7
|
# Debe estar corriendo
systemctl status NetworkManager
sudo systemctl start NetworkManager
# Ver estado de red
nmcli device status
nmcli radio
|
Paso 3: Recarga el adaptador WiFi
1
2
3
4
5
6
7
8
9
|
# Desactiva y activa WiFi
nmcli radio wifi off
sleep 2
nmcli radio wifi on
# Recarga dispositivo
sudo ip link set wlan0 down
sleep 2
sudo ip link set wlan0 up
|
Paso 4: Escanea redes disponibles
1
2
3
4
5
6
7
|
# Ver redes
nmcli device wifi list
# Si no ve redes, el adaptador podría estar dañado
# Comprueba físicamente
lsusb | grep -i network # Para USB
lspci | grep -i network # Para integrado
|
Paso 5: Conecta a una red
1
2
3
4
5
6
7
8
9
|
# Conectar a una red abierta
nmcli device wifi connect "SSID"
# Conectar a una red protegida
nmcli device wifi connect "SSID" password "contraseña"
# Verificar conexión
nmcli device status
ping 8.8.8.8
|
Conexión lenta
Síntoma
La conexión de red es muy lenta.
Solución
1
2
3
4
5
6
7
8
9
10
11
|
# Verifica la velocidad
nmcli device wifi list | grep SSID
# Comprueba interferencias (cambia canal)
# Normalmente los routers auto-seleccionan, pero puedes:
# Ver canales activos en tu zona
sudo iwlist wlan0 scan | grep Channel
# Si es WiFi 5GHz, generalmente menos interferencias
# Configura en tu router
|
Sin conexión de red
Síntoma
No hay conexión incluso aunque aparezca conectado.
Solución
1
2
3
4
5
6
7
8
9
10
11
12
13
|
# Verifica configuración IP
ip addr show
# Si no tiene IP (inet), solicita una
sudo dhclient wlan0
# O con NetworkManager
nmcli connection down "SSID"
nmcli connection up "SSID"
# Verifica DNS
cat /etc/resolv.conf
ping 8.8.8.8 # Prueba DNS de Google
|
Uso alto de CPU/Memoria
Síntoma
Vasak Desktop usa mucho CPU o consume mucha RAM.
Diagnóstico
1
2
3
4
5
6
7
8
9
|
# Ver qué proceso consume más
top -p $(pgrep -f vasak-desktop)
# O usar ps
ps aux | grep vasak-desktop
# Ver consumo histórico
RUST_LOG=debug vasak-desktop 2>&1 | tee performance.log
# (Reproduce el problema, luego Ctrl+C)
|
Soluciones
Opción 1: Desactiva animaciones
1
2
3
4
|
# Edita: ~/.config/vasak-desktop/config.toml
[ui]
animations_enabled = false
animation_duration = 50
|
Opción 2: Reduce tasa de refresco
1
2
3
|
# En ~/.config/vasak-desktop/config.toml
[rendering]
refresh_rate = 30 # Reducir de 60
|
Opción 3: Desactiva efectos visuales
1
2
3
4
|
# Busca en configuración:
effects_enabled = false
blur_effects = false
transparency_effects = false
|
Opción 4: Revisa procesos en segundo plano
1
2
3
4
5
|
# Ver todos los procesos de Vasak
pgrep -af vasak
# Si hay procesos duplicados, termínalos
pkill -f vasak-secondary-process
|
Aplicación lenta para responder
Síntoma
Los clics o interacciones tienen demora.
Solución
1
2
3
4
5
|
# Limpia configuración y reinicia
mv ~/.config/vasak ~/.config/vasak.backup
pkill vasak-desktop
sleep 2
vasak-desktop &
|
Problemas de Configuración
Cambios de configuración no se aplican
Síntoma
Los cambios en la configuración no se reflejan en la interfaz.
Solución
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
# La configuración se lee al iniciar
# Reinicia la aplicación
pkill vasak-desktop
sleep 2
vasak-desktop &
# Verifica que la configuración está guardada correctamente
cat ~/.config/vasak/system_config.json
# Verifica permisos
ls -la ~/.config/vasak/system_config.json
# Si no tienes permisos de lectura:
chmod 644 ~/.config/vasak/system_config.json
|
Configuración corrupta
Síntoma
La aplicación no inicia o se comporta de manera impredecible.
Solución
1
2
3
4
5
6
7
8
|
# Respalda la configuración actual
mv ~/.config/vasak ~/.config/vasak.backup
# Al reiniciar, se recreará con valores por defecto
vasak-desktop
# Si funciona, puedes restaurar ajustes específicos copiando
# valores de ~/.config/vasak.backup/system_config.json
|
Escalado y DPI
Interfaz demasiado pequeña o grande
Síntoma
Los elementos de UI se ven muy pequeños o muy grandes.
Solución
1
2
3
4
5
6
7
8
9
|
# Ajusta la escala del sistema mediante GTK
gsettings set org.gnome.desktop.interface text-scaling-factor 1.25
# Para X11, ajusta DPI
echo "Xft.dpi: 120" >> ~/.Xresources
xrdb -merge ~/.Xresources
# Reinicia para aplicar
pkill vasak-desktop && vasak-desktop &
|
pkill -f vasak-desktop
vasak-desktop &
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
---
## Errores de Permiso
### "Permission Denied" en operaciones
#### Síntoma
Ves errores de permiso en logs.
#### Solución
```bash
# Para audio:
sudo usermod -a -G audio $USER
# Para Bluetooth:
sudo usermod -a -G bluetooth $USER
# Para acceder a dispositivos:
sudo usermod -a -G input $USER
sudo usermod -a -G dialout $USER
# Estos cambios requieren cerrar sesión y entrar de nuevo
# O ejecutar en nueva terminal:
su - $USER
|
Cuando Nada Funciona
Reinicio completo
1
2
3
4
5
6
7
8
9
10
11
12
13
|
# 1. Detén todos los procesos de Vasak
pkill -f vasak
# 2. Detén servicios relacionados
systemctl --user stop pulseaudio
systemctl --user stop dbus
# 3. Reinicia servicios del sistema
systemctl --user restart dbus
systemctl --user restart pulseaudio # o pipewire si usas PipeWire
# 4. Inicia con debug
RUST_LOG=debug vasak-desktop 2>&1 | tee restart-debug.log
|
Reportar el problema
Si nada funciona:
-
Recopila la información y logs:
1
2
3
4
5
6
7
8
|
# Captura información del sistema y logs
RUST_LOG=debug vasak-desktop 2>&1 | tee vasak-debug-report.log
# Añade información del sistema
echo "=== Información del Sistema ===" >> vasak-debug-report.log
echo "Distro: $(lsb_release -d)" >> vasak-debug-report.log
echo "Kernel: $(uname -r)" >> vasak-debug-report.log
echo "Sesión: $XDG_SESSION_TYPE" >> vasak-debug-report.log
|
-
Abre un issue en GitHub adjuntando vasak-debug-report.log
Ver
Cómo Reportar Errores
para más detalles.