Global USE flags

Flag	Description	Packages
${PYTHON_REQUIRED_USE}		2
(		3
)		2
X	Enable audible bell for X11	25
alsa		3
apparmor		3
appindicator		2
aqua		4
archive	Enables support for accessing files in archives transparently via <pkg>app-arch/libarchive</pkg>	3
audit	Enable support for <pkg>sys-process/audit</pkg>	3
avif		2
bash-completion		3
big-endian		3
bluetooth		6
bpf	Enable BPF support for sandboxing and firewalling.	2
broadway	Enable the GDK Broadway backend.	2
brotli		2
bzip2		3
cairo		2
cdda		2
clang		3
cloudproviders	Enable the cloudproviders support	3
colord	Use <pkg>x11-misc/colord</pkg> for color management in printing	4
cpu_flags_x86_f16c		2
cpu_flags_x86_sse2		5
crypt	Support encrypted images	3
cups		8
dbus		7
debug		26
designer		3
doc		39
eds		2
egl		2
elfutils	Enable DWARF-based backtraces using <pkg>dev-libs/elfutils</pkg>.	2
elogind	Rely on <pkg>sys-auth/elogind</pkg> as runtime logind provider	10
emacs		2
examples	Build and install the examples and demo applications	17
ffmpeg		3
flatpak	Enable Flatpak support	3
geolocation		5
gif		4
git		2
gles2-only		8
gnome		8
gnome-online-accounts	Enable configuration panel for <pkg>net-libs/gnome-online-accounts</pkg> accounts	4
gphoto2		2
gssapi		2
gstreamer	Enable the Audio/Video file properties page	9
gtk	Enable use of gdk in thumbnailer	8
gtk-doc		41
gui		4
heif		2
help		2
http	Include support for importing dhall modules from HTTP URLs	4
ibus	Enable support for enhanced input methods through <pkg>app-i18n/ibus</pkg>	3
icu		5
ieee1394		2
input_devices_wacom		4
introspection		50
ios		2
jpeg		5
jpegxl		3
jumbo-build		2
kde		4
kerberos		4
keyring		3
l10n_		2
latex		2
ldap		2
libproxy		2
lto		4
lzma		3
man		3
minimal		2
modemmanager	Build and install Modem Manager plugin	4
multimedia		2
nautilus		2
ncurses		2
network	Add functionality to setup (host) PAN connections using either <pkg>net-dns/dnsmasq</pkg> or <pkg>net-misc/dhcp</pkg>	2
nls		4
opengl	Enable gtkglsink OpenGL sink based on desktop OpenGL API	7
openmp		4
pam		2
pdf		2
playlist	Enable support for playlists through <pkg>dev-libs/totem-pl-parser</pkg>	2
plugins		2
png		6
policykit		6
printsupport		2
profile		2
pulseaudio		5
python		8
qml		8
qt6		3
raw		2
readline		4
samba		2
screencast		3
scxml		2
seccomp		7
selinux		11
sound	Sound notification support through <pkg>media-libs/libcanberra-gtk3</pkg> (does nothing without USE=gtk)	2
spell		7
ssl	Enable raop-sink support (needs <pkg>dev-libs/openssl</pkg>)	9
static-libs		10
svg		6
sysprof	Enable profiling data capture support using <pkg>dev-util/sysprof-capture</pkg>	11
system-icu	Use system <pkg>dev-libs/icu</pkg> instead of the bundled version	2
systemd	Rely on <pkg>sys-apps/systemd</pkg> as runtime logind provider	26
test		83
test-full		2
threads		5
tiff		6
tools	Build svg viewer tool	6
udev	Enable udev base replacement code for cdda feature	8
utils		3
v4l		3
vaapi		2
vala		23
valgrind		2
vanilla	Disable Gentoo-specific behavior and compatibility quirks	2
video_cards_nvidia		3
vnc		2
vulkan	Enable experimental Vulkan backend	7
wayland		19
weather	Enable optional weather calendar support	2
webp		4
widgets		4
xml		3
xps		2
xwayland	Enable <pkg>x11-base/xwayland</pkg> integration for running X11 applications under Wayland	3
zeroconf		3
zstd		4

Category USE flags

app-text

Flag	Description	Packages
djvu		2

dev-haskell

Flag	Description	Packages
devel	Development commands	3
example	Build the example application.	2
integer-gmp	Whether or not to use GMP for some functions	2

dev-libs

Flag	Description	Packages
lua		2

dev-qt

Flag	Description	Packages
jit		3

gnome-base

Flag	Description	Packages
networkmanager		3

media-libs

Flag	Description	Packages
cpu_flags_arm_neon		4
cpu_flags_x86_avx		2
cpu_flags_x86_sse		3
java		2

media-plugins

Flag	Description	Packages
orc		2

sys-apps

Flag	Description	Packages
gnutls		2
tpm	Install Trusted Platform Module plugin	2

x11-libs

Flag	Description	Packages
xinerama		2

Local USE flags

app-accessibility

at-spi2-core

Flag	Description
dbus-broker

app-containers

snapd

Flag	Description
forced-devmode

app-editors

fresh

Flag	Description
dev-bins
embed-plugins

app-emulation

proton-ge-custom-meta

Flag	Description
steam

app-misc

localsearch

Flag	Description
cue
exif
gsf
iptc
iso
upower
xmp

app-office

abiword

Flag	Description
calendar
collab
goffice
grammar
map
math
redland
thesaurus
wmf
wordperfect

gnumeric

Flag	Description
libgda
perl

app-text

aspell

Flag	Description
unicode

editorconfig-core-c

Flag	Description
cli	Install command line interface.

evince

Flag	Description
dvi
postscript

papers

Flag	Description
comics
gnome-keyring

dev-build

cmake

Flag	Description
dap

dev-debug

gdb

Flag	Description
cet
debuginfod
guile
multitarget
rocm
server
sim
source-highlight
xxhash

dev-haskell

aeson

Flag	Description
ordered-keymap	Use ordered @Data.Map.Strict@ for KeyMap implementation.

bitvec

Flag	Description
simd	Use a C SIMD implementation for the ultimate performance of `zipBits`, `invertBits` and `countBits`. Disable this flag if there are problems with the C FFI.

cborg

Flag	Description
optimize-gmp

config-ini

Flag	Description
enable-doctests

crypton

Flag	Description
check-alignment	extra check on alignment in C layers, which cause lowlevel assert errors. for debugging only.
old-toolchain-inliner	use -fgnu89-inline to workaround an old compiler / linker / glibc issue.
support-aesni	allow compilation with AESNI on system and architecture that supports it
support-deepseq	add deepseq instances for cryptographic types
support-pclmuldq	Allow compilation with pclmuldq on architecture that supports it
support-rdrand	allow compilation with RDRAND on system and architecture that supports it
support-sse	Use SSE optimized version of (BLAKE2, ARGON2)
target-attributes	use GCC / clang function attributes instead of global target options.

crypton-socks

Flag	Description
network-3-0-0-0	Use network-3.0.0.0 or later. If used the example application has a dependency on network-bsd.

di-monad

Flag	Description
conduit
monad-control
pipes
pipes-safe
primitive
resourcet
streaming
transformers-base
unliftio-core

ghc-lib-parser-ex

Flag	Description
auto
no-ghc-lib

ghc-tcplugins-extra

Flag	Description
deverror

haskeline

Flag	Description
terminfo

hsyaml-aeson

Flag	Description
exe

http2

Flag	Description
h2spec	Development commands

hw-kafka-client

Flag	Description
it

jose

Flag	Description
demos

libyaml

Flag	Description
no-unicode
system-libyaml

mlkem

Flag	Description
crypton

optics-core

Flag	Description
explicit-generic-labels	Require explicit GenericLabelOptics instances in order to use generics-based labels

polysemy-plugin

Flag	Description
corelint

taffybar

Flag	Description
deprecated-pager-hints	Enables the deprecated System.Taffybar.Support.PagerHints module, which has been moved to xmonad-contrib.
wireplumber	Enables WirePlumber/PipeWire audio support.

unboxing-vector

Flag	Description
mono-traversable

wai-extra

Flag	Description
build-example	Build example executable.

zlib

Flag	Description
bundled-c-zlib
non-blocking-ffi

dev-lang

dhall

Flag	Description
http-client-tls	Use http-client-tls for resolving HTTP imports by default (requires with-http to be enabled)

ghc

Flag	Description
binary	Install the binary version directly, rather than using it to build the source version.
ghcbootstrap	Internal: Bootstrap GHC from an existing GHC installation.
ghcmakebinary	Internal: Build binary friendly for redistribution.
gmp	Use <pkg>dev-libs/gmp</pkg> for integer operations (works faster, but an external depend).
llvm	Pull in dependencies for the <pkg>llvm-core/llvm</pkg> codegen backend.
numa	Enable NUMA thread balancing policy using <pkg>sys-process/numactl</pkg>.
unregisterised	Create an unregisterised build in which only the C codegen backend will be available.

idris2

Flag	Description
chez
racket

ocaml

Flag	Description
flambda	Enables the Flambda optimizer: A new intermediate representation (introduced in ocaml 4.03) in the depths of the compiler designed to allow for better inlining.
ocamlopt
xemacs

rust

Flag	Description
"(
${ALL_LLVM_TARGETS[*]}
)"
AArch64
AMDGPU
ARC
ARM
AVR
BPF
CSKY
DirectX
Hexagon
Lanai
LoongArch
M68k
MSP430
Mips
NVPTX
PowerPC
RISCV
SPIRV
Sparc
SystemZ
VE
WebAssembly
X86
XCore
Xtensa
clippy	Install clippy, Rust code linter
dist	Install dist tarballs (used for bootstrapping)
llvm-libunwind
llvm_targets_BPF
llvm_targets_WebAssembly
miri	Install miri, an interpreter for Rust's mid-level intermediate representation (requires USE=nightly, sometimes is broken)
mrustc-bootstrap	Use <pkg>dev-lang/mrustc</pkg> to build the bootstrap Rust sysroot from this package's source
nightly	Enable nightly (UNSTABLE) features (NOTE: it does not install nightly version, just enables features marked as nightly at time of release)
parallel-compiler	Build a multi-threaded rustc (experimental, not tested by upstream)
rust-analyzer	Install rust-analyzer, A Rust compiler front-end for IDEs (language server)
rust-src	Install rust-src, needed by developer tools and for build-std (cross)
rustfmt	Install rustfmt, Rust code formatter
system-llvm	Use the system LLVM installation
wasm	Build support for the wasm32-unknown-unknown target

dev-libs

appstream

Flag	Description
apt
compose

appstream-glib

Flag	Description
fonts

boost

Flag	Description
context
mpi
numpy
stacktrace
zlib

feedbackd

Flag	Description
daemon

glib

Flag	Description
elf
mime
systemtap
xattr

gobject-introspection

Flag	Description
doctool	Install g-ir-doc-tool for generating documentation from introspected data

json-c

Flag	Description
cpu_flags_x86_rdrand

libhighscore

Flag	Description
vapi

liborcus

Flag	Description
spreadsheet-model

libpeas

Flag	Description
glade
javascript

ocl-icd

Flag	Description
khronos-headers

dev-python

pympler

Flag	Description
charts

pyqt6

Flag	Description
nfc
pdfium
positioning
quick
quick3d
remoteobjects
sensors
serialport
spatialaudio
speech
sql
testlib
webchannel
websockets

python-socketio

Flag	Description
asyncio-client
client

dev-qt

designer

Flag	Description
declarative

ghoul

Flag	Description
android
autotest
autotools
baremetal
bazaar
beautifier
bineditor
bookmarks
boot2qt
classview
clearcase
cmake
cmakeprojectmanager
coco
compilationdatabase
conan
cppcheck
ctfvisualizer
cvs
docker
drp
gitlab
glsl
imageviewer
incredibuild
lsp
macros
marketplace
mercurial
meson
modeling
nim
perforce
perfprofiler
qbs
qmake
qnx
remotelinux
serialterminal
silversearcher
subversion
todo
vcsbase
vim
webassembly
webengine
welcome

qtcore

Flag	Description
old-kernel

qtdeclarative

Flag	Description
localstorage

qtgui

Flag	Description
accessibility
eglfs
evdev
libinput
linuxfb
tslib
tuio

qtmultimedia

Flag	Description
openal

qtnetwork

Flag	Description
sctp

qtscript

Flag	Description
scripttools

qtsql

Flag	Description
freetds
mysql
oci8
odbc
postgres
sqlite

qtwayland

Flag	Description
compositor

qtwebengine

Flag	Description
bindist

qtwebkit

Flag	Description
hyphen
nsplugin
orientation

dev-util

beekeeper-studio-bin

Flag	Description
abi_x86_64

gnome-builder

Flag	Description
d-spy
webkit

pkgconf

Flag	Description
native-symlinks

games-simulation

alchemy

Flag	Description
fmod
fork

firestorm-bin

Flag	Description
voice

games-util

mangohud

Flag	Description
mangoapp
mangohudctl
mangoplot
video_cards_amdgpu
xnvctrl

gnome-base

gdm

Flag	Description
bluetooth-sound	Allow loading of bluetooth sound modules. This may be necessary for accessibility screen readers, but may cause bluetooth sound issues for users logging in.
fprint	Enables experimental fingerprint authentication using <pkg>sys-auth/fprintd</pkg>
plymouth	Enable support for smooth transition from <pkg>sys-boot/plymouth</pkg>

gnome-desktop

Flag	Description
qr

gnome-keyring

Flag	Description
caps
ssh-agent	Use GNOME Keyring to unlock SSH keys.

gnome-settings-daemon

Flag	Description
smartcard

gnome-shell

Flag	Description
pipewire	Use pipewire to enable the camera monitor

gvfs

Flag	Description
afp	Enables support for accessing AFP (Apple Filing Protocol) network shares
bluray	Enable playback of Blu-ray filesystems using <pkg>media-libs/libbluray</pkg>
fuse	Enables fuse mount points in $HOME/.gvfs for legacy application access
gcr	Enables keystore handling using <pkg>app-crypt/gcr</pkg>
google	Enables support for accessing Google accounts via <pkg>dev-libs/libgdata</pkg>
mtp
nfs	Enable NFS client support via <pkg>net-fs/libnfs</pkg>
onedrive	Enable Onedrive backend via <pkg>net-libs/msgraph</pkg>
sftp	Enable SFTP client support via <pkg>virtual/openssh</pkg>
udisks

nautilus

Flag	Description
previewer	Use <pkg>gnome-extra/sushi</pkg> to preview files from the file manager

gnome-extra

evolution-data-server

Flag	Description
berkdb	<pkg>sys-libs/db</pkg> support needed to migrate old (pre-3.13 evolution versions) addressbook data
oauth-gtk3	Enable internal OAuth2 authentication for GTK+3 applications (libedataserverui-*.so) support for Google and Outlook.com. If gnome-online-accounts is enabled and used, this is not necessary, but both can be supported at the same time with different setup at runtime
oauth-gtk4	Enable internal OAuth2 authentication for GTK 4 applications (libedataserverui4-*.so) support for Google and Outlook.com. If gnome-online-accounts is enabled and used, this is not necessary, but both can be supported at the same time with different setup at runtime

mail-client

evolution

Flag	Description
bogofilter
highlight
libnotify
spamassassin
ytnef

media-libs

freetype

Flag	Description
adobe-cff
cleartype-hinting
fontforge
harfbuzz

imgui

Flag	Description
allegro5
glfw
sdl2
sdl2-renderer
sdl3
sdl3-renderer
webgpu

libaom

Flag	Description
cpu_flags_arm_crc32
cpu_flags_ppc_vsx
cpu_flags_x86_avx2
cpu_flags_x86_mmx
cpu_flags_x86_sse3
cpu_flags_x86_sse4_1
cpu_flags_x86_sse4_2
cpu_flags_x86_ssse3

opencv

Flag	Description
abi_x86_32
atlas	Use <pkg>sci-libs/atlas</pkg> for blas, lapack and sparse blas routines (Experimental!)
contrib	Install user contributed scripts from opencv_contrib (Experimental!)
contribcvv	Enable CVV in contrib
contribdnn	Enable DNN module
contribfreetype	Enable Drawing UTF-8 strings with <pkg>media-libs/freetype</pkg>&amp;<pkg>media-libs/harfbuzz</pkg>
contribhdf	Enable HDF module (requires <pkg>sci-libs/hdf5</pkg>)
contribovis	Enable OGRE vision module support (<pkg>dev-games/ogre</pkg>)
contribsfm	Enable SFM module (requires USE="eigen gflags glog")
contribxfeatures2d	Enables xfeatures2d and autodownload of samples in contrib
cpu_flags_x86_avx512_4fmaps
cpu_flags_x86_avx512_4vnniw
cpu_flags_x86_avx512er
cpu_flags_x86_avx512pf
cuda	Enable NVIDIA Cuda computations support (Experimental!)
cudnn	Enable support for nVidia cuDNN library
dnnsamples	Enable dnn caffeemodel samples
eigen	Enable usage of <pkg>dev-cpp/eigen</pkg> for computations
features2d	Enable features2d module
gdal	Enable support for <pkg>sci-libs/gdal</pkg> library
gflags	Use Google's C++ argument parsing library (<pkg>dev-cpp/gflags</pkg>)
glog	Use Google's C++ logging library (<pkg>dev-cpp/glog</pkg>)
gtk3	Enable <pkg>x11-libs/gtk+</pkg>:3 support
jasper	Use <pkg>media-libs/jasper</pkg> for jpeg2k support
jpeg2k
lapack
mkl	Use <pkg>sci-libs/mkl</pkg> for blas, lapack and sparse blas routines
non-free	Enable non-free components
opencl
opencvapps	Enable compilation with opencvapps
openexr
openni	Adds support for Kinect-like 3D sensors devices with <pkg>dev-libs/OpenNI</pkg>
openni2	Adds support for Kinect-like 3D sensors devices with <pkg>dev-libs/OpenNI2</pkg> (should be preferred over openni)
spng	Use <pkg>media-libs/libspng</pkg> for png support
tbb	Enable multithreading with the Intel Threads Building Block (<pkg>dev-cpp/tbb</pkg>)
tesseract	Use Google's OCR Engine
testprograms	Build and install programs for testing OpenCV (performance)
truetype	Enable <pkg>media-libs/freetype</pkg> support for gapi module
video_cards_intel	Enable Video Acceleration API for hardware decoding for Intel cards
vtk	Build new 3D visualization module viz based on <pkg>sci-libs/vtk</pkg>
wechat-qrcode	Enable wechat_qrcode module
xine

opus

Flag	Description
custom-modes
deep-plc
dred
hardened
osce

media-plugins

gst-plugins-gtk

Flag	Description
gles2	Enable gtkglsink OpenGL sink based on GLESv2 API

gst-plugins-meta

Flag	Description
a52
aac
dts
dv
dvb
dvd
flac
jack
lame
libass
libvisual
modplug
mp3
mpeg
ogg
opus
oss
taglib
theora
vcd
vorbis
vpx
wavpack
x264

media-video

pipewire

Flag	Description
echo-cancel	Enable WebRTC-based echo canceller via <pkg>media-libs/webrtc-audio-processing</pkg>
extra	Build pw-cat/pw-play/pw-record
fftw
gsettings	Use gsettings (<pkg>dev-libs/glib</pkg>) to read/save used modules (useful for e.g. <pkg>media-sound/paprefs</pkg>
jack-client	Install a plugin for running PipeWire as a JACK client
jack-sdk	Use PipeWire as JACK replacement
libcamera	Enable libcamera plugin via <pkg>media-libs/libcamera</pkg>
loudness	Enable loudness normalisation according to the EBU R128 standard using <pkg>media-libs/libebur128</pkg>
lv2	Allow loading LV2 plugins via <pkg>media-libs/lv2</pkg>
pipewire-alsa	Install ALSA plugin, similar to <pkg>media-plugins/alsa-plugins</pkg>'s USE=pulseaudio.
roc	Enable roc support for real-time audio streaming over the network, using <pkg>media-libs/roc-toolkit</pkg>. See https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Network#roc
sofa	Spatially Oriented Format for Acoustics (SOFA) support via <pkg>media-libs/libmysofa</pkg>
sound-server	Provide sound server using ALSA and bluetooth devices
system-service	Install systemd unit files for running as a system service. Not recommended.

net-libs

gnome-online-accounts

Flag	Description
ms365

libproxy

Flag	Description
duktape

libqmi

Flag	Description
mbim
qrtr

nodejs

Flag	Description
inspector	Enable V8 inspector
npm	Enable NPM package manager
pax-kernel	Enable building under a PaX enabled kernel
pnpm	Install the <pkg>sys-apps/pnpm</pkg> package manager
snapshot	Enable snapshot creation for faster startup
system-ssl	Use system OpenSSL instead of the bundled one

webkit-gtk

Flag	Description
custom-cflags
gamepad
lcms
webdriver

net-misc

gnome-remote-desktop

Flag	Description
rdp

net-vpn

amneziawg-tools

Flag	Description
awg-quick

net-wireless

gnome-bluetooth

Flag	Description
sendto

sys-apps

dbus-broker

Flag	Description
launcher

fwupd

Flag	Description
amdgpu	Build and install AMD dGPU (Navi3x and above) plugin
cbor	Enable CBOR support for coSWID and uSWID via <pkg>dev-libs/libcbor</pkg>
flashrom	Enable flashrom plugin via <pkg>sys-apps/flashrom</pkg>
nvme	Build and install NVMe plugin
protobuf	Enable protobuf plugins
spi	Install Intel-SPI plugin
synaptics	Install synaptics plugin
uefi	Enable UEFI support

gnome-disk-utility

Flag	Description
fat

systemd

Flag	Description
acl
boot	Enable EFI boot manager and stub loader
cgroup-hybrid	Default to hybrid (legacy) cgroup hierarchy instead of unified (modern).
cryptsetup	Enable cryptsetup tools (includes unit generator for crypttab)
curl	Enable libcurl (required by several features)
dns-over-tls	Enable DNS-over-TLS support
fido2	Enable FIDO2 support
gcrypt	Enable use of <pkg>dev-libs/libgcrypt</pkg> for various features
homed	Enable portable home directories
idn
imds	Enable IMDS (Instance Metadata Service)
importd	Enable import daemon
kernel-install	Enable kernel-install
kmod	Enable kernel module loading via <pkg>sys-apps/kmod</pkg>
libarchive	Enable libarchive support
lz4	Enable lz4 compression for the journal
openssl	Enable use of <pkg>dev-libs/openssl</pkg> for various features
passwdqc	Use <pkg>sys-auth/passwdqc</pkg> for password checking in homed
pcre
pkcs11	Enable PKCS#11 support for cryptsetup and homed
pwquality	Use <pkg>dev-libs/libpwquality</pkg> for password checking in homed
qrcode	Enable qrcode output support in journal
remote	Enable remote journal access
resolvconf	Install resolvconf symlink for systemd-resolve
sysv-utils	Install sysvinit compatibility symlinks and manpages for init, telinit, halt, poweroff, reboot, runlevel, and shutdown
ukify	Enable systemd-ukify
xkb	Depend on <pkg>x11-libs/libxkbcommon</pkg> to allow logind to control the X11 keymap

sys-devel

mold

Flag	Description
mimalloc

x11-libs

cairo

Flag	Description
glib
lzo

fltk

Flag	Description
games
xft

gdk-pixbuf

Flag	Description
glycin
multilib
thumbnailer

gtk+

Flag	Description
vim-syntax

x11-themes

adwaita-icon-theme

Flag	Description
branding

x11-wm

mutter

Flag	Description
devkit	Enable support for running a nested wayland session

---