Sorun Giderme

Mutlaka oku

Ortam değişkeni önkoşulu

$ILLOGICAL_IMPULSE_VIRTUAL_ENV ortam değişkeni doğru ayarlanmalı, aksi halde AGS yapılandırması çalışmaz.

Varsayılan yapılandırmayı ~/.config/hypr/hyprland/env.conf içine koyduk, ancak bu dosyanın ~/.config/hypr/hyprland.conf içinde dahil edildiğinden emin olman gerekiyor. Çoğu zaman Hyprland’ı yeniden başlatmak gerekir.

Değeri tekrar kontrol etmek için ./diagnose çalıştırabilirsin.

Beklenen örnek

[===diagnose===] declare -p ILLOGICAL_IMPULSE_VIRTUAL_ENV
declare -x ILLOGICAL_IMPULSE_VIRTUAL_ENV="/home/myself/.local/state/ags/.venv"
[---SUCCESS---]

Buradaki myself, gerçek kullanıcı adını temsil eder.

Beklenmeyen örnek 1

[===diagnose===] declare -p ILLOGICAL_IMPULSE_VIRTUAL_ENV
./diagnose: line 30: declare: ILLOGICAL_IMPULSE_VIRTUAL_ENV: not found
[---EXIT 1---]

Yukarıdaki durum için:

Büyük ihtimalle eski ~/.config/hypr/hyprland.conf dosyasını kullanıyorsun ve içeriği ~/.config/hypr/hyprland.conf.new ile değiştirmeyi unuttun. Şunu çalıştır: cd ~/.config/hypr;mv hyprland.conf{,.old};mv hyprland.conf{.new,}.
Hyprland’ı yeniden başlattığından emin ol.

Beklenmeyen örnek 2

[===diagnose===] declare -p ILLOGICAL_IMPULSE_VIRTUAL_ENV
declare -x ILLOGICAL_IMPULSE_VIRTUAL_ENV="\$XDG_STATE_HOME/ags/.venv"
[---SUCCESS---]

Bu durumda $XDG_STATE_HOME genişletilmemiş; bu oldukça garip (belki Hyprland bug’ı?).

install.sh çalıştırırken install-python-packages() adımını atlamadığından ve düzgün çalıştırdığından emin ol; bu adım ~/.local/state/ags/.venv klasörünü dolu şekilde üretmeli.
Değeri doğrudan ~/.config/hypr/custom/env.conf içine şu şekilde yazabilirsin:

env = ILLOGICAL_IMPULSE_VIRTUAL_ENV, /home/myself/.local/state/ags/.venv

Ve myself yerine gerçek kullanıcı adını yazmayı unutma.

En az bir kez denemen gerekenler

Ortam değişkeni değişikliklerinin uygulanması için Hyprland’ı yeniden başlat veya sistemi yeniden aç.
AGS (yani “bar”lar) ile ilgili sorun varsa Super+Ctrl+T ile duvar kâğıdı değiştirip açılan pencerede bir görsel seç. Her zaman çözmez; özellikle kurulum veya ortam değişkeni tarafında sorun varsa.
install.sh betiği eşgüçlüdür (tekrar tekrar çalıştırıldığında aynı sonucu verir). İstediğin zaman tekrar çalıştırabilirsin.

Log nasıl alınır

Bir şeyde sorun varsa terminal aç (Super+T) ve ilgili şeyi kabukta çalıştır. Sorunlu olabilecek hata/uyarılara bak.
Bar, yan paneller, kısayol rehberi vb. AGS ile çalışır. (İpucu: Waybar değil.) Terminalde pkill agsv1; agsv1 çalıştır.

Çeşitli bilgiler

Bu wiki’de (özellikle bu sayfada), ayrıca mevcut issue ve discussion içeriklerinde ara.
Biraz sağduyu kullan. Yine de çözemezsen yardım için discussion aç.

Bazı sorunlar ve çözümler/geçici çözümler

AGS / bar tema-ikon-CSS bozuldu/çalışmıyor

Referans: end-4/dots-hyprland#1010

Super+Ctrl+T ile duvar kâğıdı değiştirip açılan pencereden görsel seç.

Bazı uygulamaların ikonu dock veya genel bakış üzerinde yok

Referans: end-4/dots-hyprland#497 yorum end-4/dots-hyprland#487

Aşağıdaki çözümleri/geçici çözümleri dene:

İkon temasını `gsettings` ile ayarla

Örneğin Papirus (çok uygulamayı kapsadığı için önerilir):

gsettings set org.gnome.desktop.interface icon-theme Papirus

Elbette önce kurmuş olman gerekir; Arch Linux için sudo pacman -S papirus-icon-theme.

AGS `user_options.jsonc` içinde ikon eşleştirmesi ayarla

~/.config/ags/user_options.jsonc dosyasını aç, icons.substitutions içine örneğin şu girdiyi ekle:

    'icons': {
        substitutions: {
            'footclient': "foot",
        },
    },

İkon arama yolunu ayarla

İkon dosyasını ayrı tutuyorsan bu yöntem uygundur.

~/.config/ags/user_options.jsonc içindeki icons.searchPaths değerini uygun şekilde düzenle.

Müzik kontrolleri görünmüyor

Referans: end-4/dots-hyprland#168

Oynatıcının Mpris desteği olduğundan emin ol (liste: Arch Wiki link)
Tarayıcıysa Plasma Integration eklentisini kur: Firefox veya Chromium ve ayrıca plasma-browser-integration (bu paket Arch içindir)

Sonra firefox medya oynatırken şu komut:

dbus-send --print-reply --dest=org.freedesktop.DBus /org/freedesktop/DBus org.freedesktop.DBus.ListNames|grep mpris

çıktısında şunlardan biri olmalı:

string "org.mpris.MediaPlayer2.plasma-browser-integration"

Sadece “plasma-browser-integration” isimleri çalışır, diğerleri çalışmaz.

Her şeye rağmen firefox dbus’ta org.mpris.MediaPlayer2.plasma-browser-integration göstermiyorsa şu adımları dene:

firefox --ProfileManager ile yeni profil oluştur.
Firefox’u yeni profille aç ve Plasma Integration eklentisini tekrar kur.
Yeni profille Firefox’u yeniden başlatıp tekrar dene.

Not: Hata ayıklamada playerctl -F metadata de yardımcı olabilir.

İkonlar görünmüyor, garip yazılar çıkıyor

Material Symbols fontu eksik. Fontu manuel indirip ~/.local/share/fonts içine koyabilirsin
Material Symbols olmalı, Material Icons değil!
Font önbelleğini yenilemek için fc-cache -fv çalıştırmayı unutma. Yeniden başlatmak da işe yarar.

`loginctl lock-session` hiçbir şey yapmıyor

Referans: end-4/dots-hyprland#278

Arch Linux forumundaki bu gönderiye göre:

Bunun çalışması için bir şeyin systemd-logind’in dbus sinyallerini dinlemesi gerekiyor.

Hypridle bu “şey” olabilir; yani çalıştığından emin olmalısın. Bundan sonra loginctl lock-session hypridle’a sinyal gönderir, sonuç olarak hypridle ~/.config/hypr/hypridle.conf içindeki $lock_cmd komutunu çalıştırarak ekranı kilitler.

Detay için Hyprland Wiki.

Terminal: Neden Ctrl+C ile kesemiyorum?

foot içinde Ctrl+C metin kopyalamaya ayarlı. Kesmek için Ctrl+Shift+C kullan
Bunu istemiyor musun?
- Bu kısayolu kaldırmak için: ~/.config/foot/foot.ini içinde clipboard-copy=Control+c satırını yorum satırı yap veya sil
- Terminal uygulamalarını çok kullanıyorsan daha zengin özellikli bir terminal tercih etmek iyi fikir olabilir

Rastgele donma

Bkz: https://github.com/end-4/dots-hyprland/issues/746 .

Kullanımdan kalkmış sorun çözümleri/geçici çözümler

Aşağıdaki içerikler artık çok faydalı değil çünkü bazı şeyler değişti.

Yine de ileride tekrar gerekirse diye burada tutuluyor.

AGS kurulumu başarısız

`PermissionError: [Errno 13] Permission denied: '/usr/local/lib/libgvc.so'`

Bu dosyanın bir pakete ait olup olmadığını kontrol et (çok büyük ihtimalle değildir, çünkü /usr/local altında):

pacman -Qo /usr/local/lib/libgvc.so

Ait değilse büyük ihtimalle güvenle kaldırabilirsin. Bunun için:

sudo mv /usr/local/lib/libgvc.so /tmp/

Diğer hatalar

./cache/ags klasörünü silip tekrar kur.

Hyprland kurulumu başarısız

Bazen AUR paketi tüm bağımlılıkları otomatik kurmuyor. Hyprland sürekli geliştiği için yeni bir şey eklendiğinde bu durum yaşanabiliyor.

Loglara bak; bir şey kurmanı söylüyorsa kurup tekrar derlemeyi dene.
Not: ~/.cache/yay temizlemen gerekebilir.