how to have my own zsh config

[KevinNitroG]

Maybe I haven't read the docs of HyDE that much, but I just want well-handled config for the OS, DE,... and mainly use my shell (zsh). In the back old versions, when I updated HyDE config, I always had to restore my .zshenv, zshrc. Recently I have updated to HyDE v25.9.1, and everything is messed up. My zsh config isn't recognised, instead it is loaded from .config/zsh which seemed not to be a standard of zsh (I guess) and handled by HyDE. Moving that folder in order to not load it, my hyprland config breaks.

Also I have no idea how to custom QT_AUTO_SCREEN_SCALE_FACTOR and GDK_SCALE. Recently I put them in the top level of .config/hyde/config.toml but now it doesn't work.

So, do we have a way that I can manage my own zsh config, and what is the right way to config hyprland config now?

Thank you for your great effort for hyprland community!!! Hope for your reply soon, because my shell is broken.

[KevinNitroG]

Update: I have override my ~/.zshenv and I can now use my zsh config. But I still don't know how to config hyprland now, and what is the use of ~/.config/hyde/config.toml

[kRHYME7]

Basically you missed a lot.

ZSH

1. We move zsh because the standard directory for zsh it $ZDOTDIR/. And we decided that $ZDOTDIR should be in ~/.config/zsh which is common and avoid cluttering the $HOME . Now to modify your own set of config modify ``$ZDOTDIR/.zshrcto modify the terminal. If you want to modify your shell and have a global variable etc (outside zshrc/terminal) then add your own config file in$ZDOTDIR/conf.d/`. Just add any file you want or your own declaration of `zshenv` in here and it should work. This is to ensure HyDE does not break and still making it customizable for the USERS.

Now if you don't want these fork HyDE and modify the ~/.zshenv. or add a P flag in the ~/HyDE/Scripts/restore_cfg.psv for the ~/.zshenv file.

Also I have no idea how to custom QT_AUTO_SCREEN_SCALE_FACTOR and GDK_SCALE. Recently I put them in the top level of .config/hyde/config.toml but now it doesn't work.

We are using UWSM now. Add your declaration in ~/.config/uwsm/env.d/YourFile.sh (any name as long as it has .sh as suffix). This will be your variables or whatever. Treat the file as a shell (this is run after your shell). Please Read more about UWSM.

But I still don't know how to config hyprland now

Just modify ~/.config/hypr/hyprland.confor the related files

and what is the use of ~/.config/hyde/config.toml

Here https://hydeproject.pages.dev/en/configuring/config_toml/

---

This is a lot so I will make AI (perplexity) rewrite what I said ,formatted.

[kRHYME7]

Here's AI's formatting. I reviewed it and looks accurate to me.

ZSH Configuration

• The standard directory for ZSH configuration is $ZDOTDIR.

• In this setup, $ZDOTDIR is set to ~/.config/zsh to avoid cluttering the home directory.

• To customize your terminal configuration, edit:

  $ZDOTDIR/.zshrc

• For global shell variables or configuration (outside .zshrc), add individual files in:

  $ZDOTDIR/conf.d/

  • You can place any files with your own zshenv declarations here.
  • This modular system maintains HyDE compatibility and user customizability.

• If you prefer to bypass this modular method, you can fork HyDE and edit your ~/.zshenv or add a P flag in ~/HyDE/Scripts/restore_cfg.psv for ~/.zshenv.

---

Environment Variable Management with UWSM

• HyDE uses UWSM for environment variable and shell environment management.
• To add custom environment variables, create a script under:

  ~/.config/uwsm/env.d/YourFile.sh

  • The filename just needs to end with .sh.
  • Content should be shell-compatible and this file is sourced after the shell starts.
• This method replaces older configurations like top-level environment variables in ~/.config/hyde/config.toml.

---

QT_AUTO_SCREEN_SCALE_FACTOR and GDK_SCALE variables

• These environment variables no longer work reliably when put inside ~/.config/hyde/config.toml.
• Instead, define them in a UWSM environment script, for example:

  export QT_AUTO_SCREEN_SCALE_FACTOR=1
  export GDK_SCALE=2

• Save this in a .sh file inside ~/.config/uwsm/env.d/.

---

Hyprland Configuration

• Configure Hyprland by editing:

  ~/.config/hypr/hyprland.conf

• Additional related files in the same directory can also be used for custom settings.

---

Use of ~/.config/hyde/config.toml

• This file is for configuring HyDE-specific options, not the shell or Hyprland itself.
• For detailed usage, consult: [HyDE config.toml documentation](https://hydeproject.pages.dev/en/configuring/config_toml/)

[kRHYME7]

Also, please use Hyprland (UWSM Managed) as your session. UWSM is shell agnostic so we are not only depending on zsh configs. This might be the reason when you load your own config hyprland breaks because we needed ENV variables that are declared in HyDE's zsh configs. And should be fixed when you use UWSM