i tried some quickshell based dotfiles for a while now - my favorite is Noctalia Shell - almost everyday updates.
the following is an example - this will work with almost every quickshell based dotfiles !
emerge gui-wm/hyprland via hyproverlay <<< https://wiki.gentoo.org/wiki/Hyprland#Emerge and https://github.com/noctalia-dev/noctalia-qs << look at last post << using *.9999 live version is maybe a better approach.
i use stable with some live ebuilds, without Xwayland - works great for me.
look at https://docs.noctalia.dev >>> Installation >>> Dependencies Explained - or use the *.ebuild from GURU overlay https://gpo.zugaina.org/gui-apps/noctalia-shell <<< thx, to the creator.
i'll stay with manual method, because it's easier to update or go back without waiting for the release - i always make a copy of the noctalia folder before using git pull as user!
go to https://gpo.zugaina.org - here, you can find all needed ebuilds >>> read https://wiki.gentoo.org/wiki/Ebuild_rep ... positories <<< to not mess up portage.
or create a local overlay >> https://wiki.gentoo.org/wiki/Creating_a ... repository - copy and use only needed ebuilds from multiple overlays.
create a new user via - useradd -m -G users,wheel,audio,video,input,portage,seat,plugdev -s /bin/bash your_user_name >>> create a password via passwd your_user_name
login with your new created user on TTY >> create quickshell folder via mkdir quickshell inside .config folder >> cd into quickshell folder and sync via git clone -b main https://github.com/noctalia-dev/noctalia-shell.git noctalia-shell
using git is the best practice - makes updates of the dotfiles easier, e.g. via git pull inside noctalia-shell folder - works even while running the shell, but logging out or restart is definitely better option after git pull update.
also create a hypr folder inside .config, e.g. mkdir hypr and copy my hyprland.conf to it http://0x0.st/KvBI.conf <<< this is just an example - change the hyprland.conf to your liking - read https://wiki.hypr.land for other additional options.
restart your device - login and enjoy quickshell/hyprland - open Settings and configure it to your liking.
" thanks to outfoxxed https://git.outfoxxed.me/quickshell/quickshell - creator of quickshell
noctalia-dev https://github.com/noctalia-dev - creator of Noctalia Shell
and https://hypr.land - creator of Hyprland and all contributors."
EDIT: my current OpenRC @world list of USE flags for comparison - http://0x0.st/Po_t.2026.txt (01.05.2026)
EDIT1: thanks to timasoft - a little tool for all those who's not familiar with some settings or difficulties understanding it clearly (<<< no offence) - it'll be sourced via hyprland.conf.
save it under /var/db/repos/name_of_your_local_overlay/gui-apps/hyprviz-9999.ebuild - need edit of /etc/portage/package.accept_keywords/hyprviz << gui-apps/hyprviz << NOT hyprland-0.52.* compatible atm.
Code: Select all
# Copyright 2025 Gentoo Authors
# Distributed under the terms of the GNU General Public License v2
# Autogenerated by pycargoebuild 0.15.0
EAPI=8
inherit cargo
DESCRIPTION="GUI for configuring Hyprland!"
HOMEPAGE="https://github.com/timasoft/hyprviz"
inherit git-r3
EGIT_REPO_URI="https://github.com/timasoft/hyprviz.git"
src_unpack() {
git-r3_src_unpack
cargo_live_src_unpack
}
LICENSE="GPL-2"
# Dependent crate licenses
LICENSE+="
Apache-2.0 Apache-2.0-with-LLVM-exceptions GPL-2 ISC MIT MPL-2.0
Unicode-3.0
"
SLOT="0"
KEYWORDS="~amd64"--
EDIT2: using OpenRC without X in make.conf - but, some ebuilds are in need of X anyway, e.g.
eix --installed-with-use --only-names X
Code: Select all
dev-cpp/cairomm
dev-python/pycairo
dev-qt/qtbase
gui-apps/quickshell
media-libs/libepoxy
media-libs/libglvnd
media-libs/mesa
virtual/opengl
x11-libs/cairo
x11-libs/gtk+
x11-libs/libxkbcommon
x11-libs/pangoEDIT4: hyprland.conf >>> Version 0.53.x only https://0x0.st/Po_W.conf
