Global USE flags

Flag	Description	Packages
X		13
appindicator	Enable tray icon support through <pkg>dev-libs/libayatana-appindicator</pkg>	2
bzip2	Build with bzip2 compression support	2
caps	Use libcap support	2
cet	Enable Intel Control-flow Enforcement Technology (needs binutils 2.29 and gcc 8)	2
cjk	Install the CN variant with Chinese glyphs	3
clang	Allow building with clang (if proper environment is set). Highly experimental. Disable to auto-force gcc usage.	5
cli	Install the companion Antigravity command-line interface	3
curl	Enable LLM support via <pkg>net-misc/curl</pkg>	2
dbus		3
debug	Pseudo flag	6
doc	Install extended documentation using <pkg>app-text/doxygen</pkg>. (Man pages are included by default.)	14
egl	Use EGL for OpenGL rendering	7
elibc_glibc		2
examples		2
geoip	Install geoip.dat	2
gnome	add support for gnome	4
gtk2	Enable GTK2 IM support	3
gtk3	Enable support for GTK+3	5
gtk4	Enable support for GTK 4	4
gui	Enable GUI Client	4
hwaccel	Hardware Video Decoding support	2
introspection		3
lto	Enable Link Time Optimizations (improves performance and decreases size of executables)	3
mamba	enable libmamba resolver	2
mpv	Build the libmpv+EGL/GBM video plugin	2
nls		3
opencc	Install OpenCC configurations (for Emoji, Traditional Chinese, etc.).	3
perl	Install additional scripts written in Perl	2
pipewire	Enable pipewire's alsa support if using pipewire as sound server	4
plus	Plus variant (Supports Unicode CJK Unified Ideographs Extension A)	3
python	Build the python bindings	2
qt6	Build support for QT6	6
remote	enable remote bitbang support	2
rime	Install Rime dictionary	5
sdl2	Use system libSDl2 instead of bundled GLFW	2
selinux		3
server	Enable server daemon	4
static	TTF format for this font	3
static-libs	Build static versions of dynamic libraries as well	5
suid	Make internal pt_chown helper setuid -- not needed if using Linux and have /dev/pts mounted with gid=5	2
systemd		9
test	Enable Test	31
vaapi		2
vulkan		2
wayland	Enable Wayland support with the Ozone platform	20
web	Build Web Renderer	2
webengine	Enable built-in browser using <pkg>dev-qt/qtwebengine</pkg>	2
webui	Enable the Web UI	3
zstd	Use zstd support	2

Category USE flags

app-alternatives

Flag	Description	Packages
loyalsoldier	use dev-libs/v2ray-rules-dat-bin	2
v2fly	use virtual/v2ray-geoip	2

app-dicts

Flag	Description	Packages
fcitx	Install Fcitx 5 dictionary	4

app-editors

Flag	Description	Packages
kerberos	Keep the bundled Kerberos authentication module	4
webkit	Keep the bundled Microsoft authentication extension, which needs WebKitGTK	2

app-emulation

Flag	Description	Packages
headers-only	Build and install only the headers.	2

app-i18n

Flag	Description	Packages
data	Enable language model and dictionary data	2
lua	Add lua support.	3
onlyplugin	Build only plugin	2

dev-util

Flag	Description	Packages
cpu_flags_x86_avx2		2

media-fonts

Flag	Description	Packages
mono	Monospace variant	3
regular	Regular variant	4

net-im

Flag	Description	Packages
bwrap	Use <pkg>sys-apps/bubblewrap</pkg> to prevent private information leakage	2

net-p2p

Flag	Description	Packages
upnp	Use miniupnpc and libnatpmp support	2

net-proxy

Flag	Description	Packages
gvisor	Enable gvisor stack support	2

sys-kernel

Flag	Description	Packages
initramfs	Build initramfs along with the kernel.	2

Local USE flags

app-arch

libzim

Flag	Description
xapian	Build libzim with xapian support

app-crypt

cotp

Flag	Description
converter	Install converter scripts to import secrets from other authenticator apps (Authy, FreeOTP, Google Authenticator, MAuth)

app-editors

antigravity

Flag	Description
ide	Install the companion Antigravity IDE and preserve the editor during the 1.x to 2.x transition

appflowy-bin

Flag	Description
llvm-libunwind

neomacs

Flag	Description
jit	Enable just-in-time compilation support
terminal	Enable the embedded terminal emulator feature
video	Enable GStreamer-backed inline video support

neovim-bin

Flag	Description
nvimpager	Install nvimpager symlink to less.sh macro

app-emulation

deepin-wine-plugin

Flag	Description
virtual-pkg	With deepin-wine-plugin-virtual package

liblol-glibc

Flag	Description
audit
compile-locales	build *all* locales in src_install; this is generally meant for stage building only as it ignores /etc/locale.gen file and can be pretty slow
custom-cflags
gd	build memusage and memusagestat tools
hash-sysv-compat	enable sysv linker hashes in glibc for compatibility with binary software (EAC via wine/proton)
multiarch	enable optimizations for multiple CPU architectures (detected at runtime)
multilib
multilib-bootstrap	Provide prebuilt libgcc.a and crt files if missing. Only needed for ABI switch.
nscd	Build, and enable support for, the Name Service Cache Daemon
profile
sframe	enable building with sframe backtrace support
split-usr
ssp	protect stack of glibc internals
stack-realign	Realign the stack in the 32-bit build for compatibility with older binaries at some performance cost
systemtap	Enable enhanced debugging hooks/interface via SystemTap static probe points. Note that this isn't exclusive to SystemTap, despite the name. This provides an interface which <pkg>dev-debug/gdb</pkg> optionally uses, see https://sourceware.org/gdb/wiki/LinkerInterface.
vanilla

looking-glass

Flag	Description
backtrace	Enable backtrace support
host	Build host application
obs	Build OBS plugin
pulseaudio

app-i18n

fcitx

Flag	Description
autostart	Enable XDG-compatible autostart of Fcitx
emoji	Enable emoji loading for CLDR
enchant	Enable Enchant backend (using <pkg>app-text/enchant</pkg>) for spelling hinting
keyboard	Enable key event translation with XKB and build keyboard engine
presage	Enable presage for word predication (not stable)

fcitx-chinese-addons

Flag	Description
cloudpinyin	Build cloud pinyin addon

fcitx-configtool

Flag	Description
config-qt	Enable fcitx5-config-qt
kcm	Enable KDE KCM support

fcitx-gtk

Flag	Description
snooper	Enable key snooper for gtk app

fcitx-lua

Flag	Description
dlopen	Use dlopen to load lua library

fcitx-meta

Flag	Description
anthy	Install Anthy Japanese input method
bamboo	Install Bamboo Vietnamese input method
chewing	Install Chewing (Intelligent phonetic, Zhuyin/Bopomofo) input method
chinese-addons	Install Chinese addons for fcitx5
configtool	Enable GUI config tool
hangul	Install Hangul Korean input method
m17n	Install m17n-provided input methods
qt5
skk	Install SKK Japanese input method

fcitx-qt

Flag	Description
staticplugin	Build plugin as static

libime-jyutping

Flag	Description
engine	Enable input method for fcitx

rime-data

Flag	Description
extra	Install extra input method packages

rime-ice

Flag	Description
base	Install base character sets (8105/41448). Recommended.
english	Install English dictionaries and enable mixed input support.
tencent	Install the Tencent large dictionary (popular vocabulary vectors).
theme	Install suggested color schemes.

app-misc

ccal

Flag	Description
pdf

joshuto

Flag	Description
fzf	Fuzzy search via fzf

app-office

freeoffice

Flag	Description
l10n_

app-shells

gitstatus

Flag	Description
zsh-completion

app-text

goldendict

Flag	Description
epwing	Enable EPWING Dictionary Format
ffmpeg	Use ffmpeg to play audio
systemfmt	Build with dev-lib/libfmt
systemtoml	Build with dev-cpp/tomlplusplus
tts	Enable QTexttoSpeech support
zim	Add Zim and Slob formats support

lektra

Flag	Description
synctex	Enable SyncTeX support for TeX editor synchronization

dev-cpp

cppcoro

Flag	Description
shared	Build shared library instead of static library.

tgbot-cpp

Flag	Description
shared-libs	Build shared library instead of static library.

dev-java

oraclejdk-bin

Flag	Description
alsa
commercial	Install features requiring a commercial license for production use
cups
fontconfig
headless-awt	Don't install the X backend for AWT, needed by some GUIs (used to be X flag)
javafx	Install JavaFX libraries
source	Install JVM sources

dev-libs

lunar-calendar

Flag	Description
vala

v2ray-rules-dat-bin

Flag	Description
geosite	Install geosite.dat

dev-python

conda

Flag	Description
user	use user's home directory as default pkgs and envs prefix

nvchecker

Flag	Description
ini	convert your old configuration files from ini to toml
notify	enable nvchecker-notify support

pyrime

Flag	Description
prompt-toolkit	Add support for dev-python/prompt-toolkit

dev-util

arch-install-scripts

Flag	Description
archroot	Install arch-chroot
genfstab	Install genfstab
pacstrap	Install pacstrap

hunk-bin

Flag	Description
abi_x86_64
cpu_flags_arm_asimd
cpu_flags_arm_crc32
cpu_flags_x86_avx
cpu_flags_x86_bmi1
cpu_flags_x86_bmi2
cpu_flags_x86_f16c
cpu_flags_x86_fma3
cpu_flags_x86_popcnt
cpu_flags_x86_sse3
cpu_flags_x86_sse4_1
cpu_flags_x86_sse4_2
cpu_flags_x86_ssse3

pi-coding-agent-bin

Flag	Description
system-fd	Use system fd instead of the pi's downloaded one

games-arcade

osu-lazer-bin

Flag	Description
complete-icon	Generate more icons from .ICO files
gamemode	Use gamemode to run the game
system-ffmpeg	Use system ffmpeg
system-sdl	Use system SDL

gui-apps

waywallen

Flag	Description
ui	Build Qt QML UI
wallhaven	Install the Wallhaven source plugin

media-fonts

Plangothic

Flag	Description
otf	OpenType format for this font (default)

maple-mono

Flag	Description
nerdfont	Install the Nerd Font variant with extra icon glyphs

nerd-fonts

Flag	Description
((
))
0xproto	Install Nerd-fonts-patched 0xProto fonts
3270	Install Nerd-fonts-patched 3270 fonts
adwaitamono	Install Nerd-fonts-patched Adwaita Mono fonts
agave	Install Nerd-fonts-patched Agave fonts
anonymouspro	Install Nerd-fonts-patched Anonymous Pro fonts
arimo	Install Nerd-fonts-patched Arimo fonts
atkinsonhyperlegiblemono	Install Nerd-fonts-patched Atkinson Hyperlegible Mono fonts
aurulentsansmono	Install Nerd-fonts-patched Aurulent Sans Mono fonts
bigblueterminal	Install Nerd-fonts-patched Big Blue Terminal fonts
bitstreamverasansmono	Install Nerd-fonts-patched Bitstream Vera Sans Mono fonts
cascadiacode	Install Nerd-fonts-patched Cascadia Code fonts
cascadiamono	Install Nerd-fonts-patched Cascadia Mono fonts
codenewroman	Install Nerd-fonts-patched Code New Roman fonts
comicshannsmono	Install Nerd-fonts-patched Comic Shanns Mono fonts
commitmono	Install Nerd-fonts-patched Commit Mono fonts
cousine	Install Nerd-fonts-patched Cousine fonts
d2coding	Install Nerd-fonts-patched D2Coding fonts
daddytimemono	Install Nerd-fonts-patched Daddy Time Mono fonts
dejavusansmono	Install Nerd-fonts-patched DejaVu Sans Mono fonts
departuremono	Install Nerd-fonts-patched Departure Mono fonts
droidsansmono	Install Nerd-fonts-patched Droid Sans Mono fonts
envycoder	Install Nerd-fonts-patched EnvyCodeR fonts
fantasquesansmono	Install Nerd-fonts-patched Fantasque Sans mono fonts
firacode	Install Nerd-fonts-patched Fira Code fonts
firamono	Install Nerd-fonts-patched Fira Mono fonts
geistmono	Install Nerd-fonts-patched Geist Mono fonts
go-mono	Install Nerd-fonts-patched Go-Mono fonts
gohu	Install Nerd-fonts-patched Gohu fonts
hack	Install Nerd-fonts-patched Hack fonts
hasklig	Install Nerd-fonts-patched Hasklig fonts
heavydata	Install Nerd-fonts-patched Heavy Data fonts
hermit	Install Nerd-fonts-patched Hermit fonts
ia-writer	Install Nerd-fonts-patched iA-Writer fonts
ibmplexmono	Install Nerd-fonts-patched IBM Plex Mono fonts
inconsolata	Install Nerd-fonts-patched Inconsolata fonts
inconsolatago	Install Nerd-fonts-patched Inconsolata Go fonts
inconsolatalgc	Install Nerd-fonts-patched Inconsolata LGC fonts
intelonemono	Install Nerd-fonts-patched Intel One Mono fonts
iosevka	Install Nerd-fonts-patched Iosevka fonts
iosevkaterm	Install Nerd-fonts-patched Iosevka Terminal fonts
iosevkatermslab	Install Nerd-fonts-patched Iosevka Terminal Slab fonts
jetbrainsmono	Install Nerd-fonts-patched JetBrains Mono fonts
lekton	Install Nerd-fonts-patched Lekton fonts
liberationmono	Install Nerd-fonts-patched Liberation Mono fonts
lilex	Install Nerd-fonts-patched Lilex Mono fonts
martianmono	Install Nerd-fonts-patched Martian Mono fonts
meslo	Install Nerd-fonts-patched Meslo fonts
monaspace	Install Nerd-fonts-patched Monaspace fonts
monofur	Install Nerd-fonts-patched Monofur fonts
monoid	Install Nerd-fonts-patched Monoid fonts
mononoki	Install Nerd-fonts-patched Mononoki fonts
mplus	Install Nerd-fonts-patched Mplus fonts
nerdfontssymbolsonly	Install extra glyphs from popular iconic fonts
noto	Install Nerd-fonts-patched Noto fonts
opendyslexic	Install Nerd-fonts-patched Open Dyslexic fonts
overpass	Install Nerd-fonts-patched Overpass fonts
profont	Install Nerd-fonts-patched Pro Font fonts
proggyclean	Install Nerd-fonts-patched Proggy Clean fonts
recursive	Install Nerd-fonts-patched Recursive fonts
robotomono	Install Nerd-fonts-patched Roboto Mono fonts
sharetechmono	Install Nerd-fonts-patched Share Tech Mono fonts
sourcecodepro	Install Nerd-fonts-patched Source Code Pro fonts
spacemono	Install Nerd-fonts-patched Space Mono fonts
terminus	Install Nerd-fonts-patched Terminus fonts
tinos	Install Nerd-fonts-patched Tinos fonts
ubuntu	Install Nerd-fonts-patched Ubuntu fonts
ubuntumono	Install Nerd-fonts-patched Ubuntu Mono fonts
ubuntusans	Install Nerd-fonts-patched Ubuntu Sans fonts
victormono	Install Nerd-fonts-patched Victor Mono fonts
zedmono	Install Nerd-fonts-patched Zed Mono fonts

shanggu

Flag	Description
round	Install ShangguRound font family
sans	Install ShangguSans font family
serif	Install ShangguSerif font family (default)
variant	Install ShangguSansVF and ShangguSerifVF font families

yozai-font

Flag	Description
light	Light weight variant
medium	Medium weight variant

media-gfx

open-wallpaper-engine

Flag	Description
scene	Build Scene Renderer
waywallen	Build as waywallen plugin

unityhub

Flag	Description
legacy	add support for Legacy versions

media-plugins

osdlyrics

Flag	Description
indicator	add support for appindicator

waywallen-display

Flag	Description
layer	Display with protocol zwlr_layer_shell_v1
plasma

media-sound

feeluown

Flag	Description
bilibili	add support for bilibili
cookies	add support for cookies login
netease	add netease cloud music support for feeluown
qqmusic	add qq music support for feeluown
ytmusic	add support for youtube music

termusic

Flag	Description
gst	Use <pkg>media-libs/gstreamer</pkg> as decoding backend
symphonia	Use symphonia as decoding backend (default)
yt-dlp	Use <pkg>net-misc/yt-dlp</pkg> to provide the youtebe-dl feature

media-video

davinci-resolve

Flag	Description
video_cards_amdgpu
video_cards_intel
video_cards_nvidia

wiliwili

Flag	Description
glfw	Use bundled GLFW
webp	webp image compression format support

net-dns

dnsmasq-china-list

Flag	Description
dnscrypt-proxy	Install rules for dnscrypt-proxy
dnsmasq	Install rules for dnsmasq
smartdns	Install rules for smartdns

net-im

tencent-qq

Flag	Description
system-fdk-aac	Use <pkg>media-libs/fdk-aac</pkg> instead of shipped libs.
system-libssh2	Use <pkg>net-libs/libssh2</pkg> instead of shipped libs.
system-openh264	Use <pkg>media-libs/openh264</pkg> instead of shipped libs.
system-zlib	Use <pkg>virtual/zlib</pkg> instead of shipped libs.

vesktop-bin

Flag	Description
seccomp	Enable seccomp sandbox (recommended for security)

net-libs

bun-bin

Flag	Description
symlink	Install node symlink to fix shell shebang

net-misc

eternalterminal

Flag	Description
icu
unwind
utempter	Record terminal sessions through <pkg>sys-libs/libutempter</pkg>

ntpd-rs

Flag	Description
metrics	Enable metrics support

pcmanx-gtk2

Flag	Description
iplookup	IP location lookup, Useful to China locations
libnotify
proxy	proxy server support
wget	use wget to download files

reframe

Flag	Description
neatvnc	Use optional neatvnc implementation instead of the default libvncserver implementation

net-p2p

amule-dlp

Flag	Description
daemon	Enable amule daemon
stats	Enable statistic reporting

n2n

Flag	Description
openssl	Use openssl support
pcap	Use libpcap support

net-proxy

clash-rs

Flag	Description
bench	Enable Bench Protocol
perf	Enable Perf Features, plus + jemallocator
standard	Enable Standard Features

juicity

Flag	Description
client	install juicity-client

naiveproxy-bin

Flag	Description
abi_mips_n64
abi_mips_o32
big-endian

qv2ray

Flag	Description
themes	Build with built-in themes

qvplugin-trojan

Flag	Description
mysql	build with MySQL support
nat	Build with NAT support
reuseport	Build with SO_REUSEPORT support
tcpfastopen	Force build with TCP Fast Open support

shadowsocks-rust

Flag	Description
redir	Enable redir protocol for sslocal (transparent proxy)
tun	Enable Tun interface protocol for sslocal

sing-box

Flag	Description
acme	Build with ACME TLS certificate issuer support
ccm	Build with Claude Code Multiplexer service support
clash-api	Build with Clash API support
cloudflared	Build with Cloudflare Tunnel inbound support
dhcp	Build with DHCP support
ech	Build with TLS ECH extension support for TLS outbound
grpc	Build with standard gRPC support
naive	Build with NaiveProxy outbound support
ocm	Build with OpenAI Codex Multiplexer service support
quic	Build with QUIC support
reality	Build with reality TLS server support
tailscale	Build with Tailscale support
tor	Build with embedded Tor support
utls	Build with uTLS support for TLS outbound
v2ray-api	Build with V2Ray API support
wireguard	Build with WireGuard support

v2rayA

Flag	Description
xray	To be able to use net-proxy/Xray. Disable the v2ray useflag to use xray as default

yass

Flag	Description
amd64
dylib	Enable YASS-C library
jemalloc	Enable jemalloc allocator
mimalloc	Enable mimalloc allocator
tbbmalloc	Enable tbbmalloc allocator
tcmalloc	Enable tcmalloc allocator
x86

sci-chemistry

vesta

Flag	Description
powderplot	Install the bundled PowderPlot tool, which plots powder diffraction patterns produced by RIETAN

sci-electronics

openfpgaloader

Flag	Description
cmsisdap	enable cmsis-dap support
gpio	enable libgpiod bitbang support

sci-ml

llama-cpp

Flag	Description
"(
(
)
)"
amx_bf16
amx_int8
amx_tile
avx
avx2
avx512_bf16
avx512_vnni
avx512bw
avx512cd
avx512dq
avx512f
avx512vbmi
avx512vl
avx_vnni
blis	Build a BLIS backend
bmi2
cuda
f16c
flexiblas	Build a FlexiBLAS backend
fma3
openblas	Build an OpenBLAS backend
opencl	Build an OpenCL backend, so far only works on Adreno and Intel GPUs
openmp
riscv
rocm	Build a HIP (ROCm) backend
rpc	Build with rpc-server
sse4_2
v
wmma	Use rocWMMA to enhance flash attention performance
xtheadvector
zba
zfh
zicbop
zihintpause
zvfh

sys-apps

pacman

Flag	Description
gpg	Enable GPG signature verification using <pkg>app-crypt/gpgme</pkg>

sys-boot

ventoy-bin

Flag	Description
gtk

sys-kernel

cachyos-sources

Flag	Description
bore	BORE CPU scheduler
prjc	Project C CPU scheduler (BMQ/PDS)
prjc-lfbmq	Project C CPU scheduler (BMQ/PDS) with Lock Free Run Queue
rt	RT i915 patches
thin	Install a ThinLTO config fragment and require the LLVM toolchain used to build it

xanmod-rt

Flag	Description
experimental	Apply experimental patches; for more information, see "https://wiki.gentoo.org/wiki/Project:Kernel/Experimental".
generic-uki	Build and install a generic initramfs and Unified Kernel Image, this is intended for building binpkgs with a pre-generated UKI included (EXPERIMENTAL).
hardened	Use selection of hardening options recommended by Kernel Self Protection Project

sys-libs

libsolv

Flag	Description
appdata	Build with AppStream appdata support
arch	Build with archlinux repository support
comps	Build with fedora comps support
conda	Build with conda dependency support
cudf	Build with cudf repository support
debian	Build with debian database/repository support
helix	Build with helix repository support
libxml2	Build with libxml2 instead of libexpat
lzma	Build with lzma/xz compression support
mdk	Build with mandriva/mageia repository support
pubkey	Build with pubkey support
rpm	Build with rpm database support
ruby	Build the ruby bindings
suse	Build with suse repository support
tcl	Build the Tcl bindings
zchunk	Build with zchunk compression support

virtual

linux-sources

Flag	Description
firmware	Install linux kernel firmware

www-servers

woof

Flag	Description
gzip	gzip decompression of the archive from woof
unzip	ZIP decompression of the archive from woof

x11-misc

picom-jonaburg

Flag	Description
config-file	Enable config file support
drm	Enable support for using drm for vsync
opengl	Enable features that require opengl (opengl backend, and opengl vsync methods)
pcre

x11-themes

bibata-cursor

Flag	Description
color-amber	Cursor color: Yellow
color-black	Cursor color: Black
color-white	Cursor color: White
lefthanded	Right-leaning mouse cursor
modern-style	Rounded style
original-style	Sharp-edged style
righthanded	Left-leaning mouse cursor

nordic

Flag	Description
cinnamon	Install theme for <pkg>gnome-extra/cinnamon</pkg>
gnome-shell	Install theme for <pkg>gnome-base/gnome-shell</pkg>
kde	Install KDE theme
mate	Install Metacity theme for <pkg>mate-base/mate</pkg>
xfce	Install theme for <pkg>xfce-base/xfwm4</pkg>

nordzy-cursors

Flag	Description
nord-white	Install ${PN}-white cursors theme

---