Global USE flags

Flag Description Packages
( 2
) 2
X 22
accessibility 2
alsa 3
apparmor 2
aqua 3
audit 2
bash-completion 2
big-endian 3
bluetooth 5
branding 2
broadway 2
bzip2 2
cairo 2
cdda 2
clang Use Clang compiler instead of GCC 4
cloudproviders 3
colord 5
cpu_flags_x86_avx2 2
cpu_flags_x86_sse2 4
crypt Support encrypted images 3
cups 9
custom-cflags 2
dbus 9
debug 27
designer 3
doc 34
eds 3
egl 2
elogind 7
examples 16
flatpak 2
geolocation 6
gif 3
git 2
gles2-only 8
gnome 8
gnome-online-accounts 4
gssapi 2
gstreamer 9
gtk 8
gtk-doc 42
gui 3
hardened 2
heif 2
help 2
http Include support for importing dhall modules from HTTP URLs 3
ibus 3
icu 5
input_devices_wacom 4
introspection 50
ios 2
jack 2
java 2
jpeg 4
jpegxl Add JPEG XL / jxl image support 4
jumbo-build Enable unified build - combines source files to speed up build process, but requires more memory 3
kde 5
kerberos 4
keyring 3
l10n_ 3
lcms 2
ldap 3
libproxy Enable libproxy support 3
lto 4
modemmanager 2
multimedia 2
nautilus 2
ncurses 2
nls 2
opengl Enable gtkglsink OpenGL sink based on desktop OpenGL API 6
openmp 3
pdf 2
playlist Enable support for playlists through <pkg>dev-libs/totem-pl-parser</pkg> 2
plugins 2
png 4
policykit 3
postgres 2
printsupport 2
profile 2
pulseaudio Add sound server support via media-libs/libpulse (may be PulseAudio or Pipewire, or apulse if installed) 4
python 7
qml 8
qt6 3
raw 2
readline 2
samba 2
screencast 3
scxml 2
seccomp 4
selinux 9
sound 2
spell 7
ssl 8
static-libs 9
svg 5
sysprof 11
system-icu Use system <pkg>dev-libs/icu</pkg> instead of the bundled version 3
systemd 26
test 79
test-full 2
threads 5
tiff 5
tools 5
udev 8
vala 25
valgrind 3
video_cards_nvidia 2
vim-syntax 2
vnc 2
vulkan 7
wayland 17
weather 2
webp 4
widgets 4
xml 2
xps 2
zeroconf 3

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 When building with a version of GHC older than 9.0, depend on the @integer-gmp@ library. You can disable this if you do not wish to link against GMP, but at the expense of having a slower @TextShow Natural@ instance. 2

dev-libs

Flag Description Packages
lua 2
man 2
utils 2
zstd 2

dev-qt

Flag Description Packages
jit 3

gnome-base

Flag Description Packages
networkmanager 3

media-libs

Flag Description Packages
cpu_flags_arm_neon 3
cpu_flags_x86_sse 2

media-plugins

Flag Description Packages
orc 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

tinysparql

Flag Description
localsearch
stemmer

tmux

Flag Description
jemalloc
sixel
utempter

app-office

abiword

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

gnumeric

Flag Description
libgda
perl

libreoffice

Flag Description
$(printf
${LO_EXTS})
'
'libreoffice_extensions_%s
base
coinmp
googledrive
gtk3
gtk4
mariadb
odk
pdfimport

libreoffice-l10n

Flag Description
offlinehelp

app-text

aspell

Flag Description
unicode

evince

Flag Description
dvi
postscript

papers

Flag Description
comics
gnome-keyring

dev-build

cmake

Flag Description
dap

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.
elfutils Enable DWARF-based backtraces using <pkg>dev-libs/elfutils</pkg>.
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
minimal
racket

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
bpf
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
lzma
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
network
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
emacs
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
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
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
appindicator

gnome-builder

Flag Description
d-spy
webkit

games-simulation

alchemy

Flag Description
fmod
fork

firestorm-bin

Flag Description
voice

games-util

mangohud

Flag Description
${PYTHON_REQUIRED_USE}
mangoapp
mangohudctl
mangoplot
video_cards_amdgpu
xnvctrl

gnome-base

gdm

Flag Description
bluetooth-sound
fprint
plymouth

gnome-desktop

Flag Description
qr

gnome-keyring

Flag Description
caps
pam
ssh-agent

gnome-settings-daemon

Flag Description
smartcard

gnome-shell

Flag Description
pipewire

gvfs

Flag Description
bluray
fuse
gphoto2
mtp
nfs
onedrive
udisks

nautilus

Flag Description
previewer

gnome-extra

evolution-data-server

Flag Description
berkdb
oauth-gtk3
oauth-gtk4

gui-libs

gtk

Flag Description
cpu_flags_x86_f16c

mail-client

evolution

Flag Description
archive
bogofilter
highlight
libnotify
spamassassin
ytnef

media-gfx

gthumb

Flag Description
cdr
slideshow

media-libs

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_avx
cpu_flags_x86_mmx
cpu_flags_x86_sse3
cpu_flags_x86_sse4_1
cpu_flags_x86_sse4_2
cpu_flags_x86_ssse3

opus

Flag Description
custom-modes
deep-plc
dred
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
ffmpeg
flac
lame
libass
libvisual
modplug
mp3
mpeg
ogg
opus
oss
taglib
theora
v4l
vaapi
vcd
vorbis
vpx
wavpack
x264

net-libs

gnome-online-accounts

Flag Description
ms365

libproxy

Flag Description
duktape

libqmi

Flag Description
mbim
qrtr

libsoup

Flag Description
brotli

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
avif
gamepad
webdriver

net-misc

gnome-remote-desktop

Flag Description
rdp

net-vpn

amneziawg-tools

Flag Description
awg-quick

net-wireless

gnome-bluetooth

Flag Description
sendto

sci-ml

transformers

Flag Description
torch

sys-apps

dbus-broker

Flag Description
launcher

gnome-disk-utility

Flag Description
fat

sys-devel

mold

Flag Description
mimalloc

www-client

firefox

Flag Description
eme-free Disable EME (DRM plugin) capability at build time
gmp-autoupdate Allow Gecko Media Plugins (binary blobs) to be automatically downloaded and kept up-to-date in user profiles
gnome-shell Integrate with gnome-base/gnome-shell search
hwaccel Force-enable hardware-accelerated rendering (Mozilla bug 594876)
openh264 Use <pkg>media-libs/openh264</pkg> for H264 support instead of downloading binary blob from Mozilla at runtime
pgo Add support for profile-guided optimization for faster binaries - this option will double the compile time
sndio Enable support for the <pkg>media-sound/sndio</pkg> backend
system-av1 Use the system-wide <pkg>media-libs/dav1d</pkg> and <pkg>media-libs/libaom</pkg> library instead of bundled
system-harfbuzz Use the system-wide <pkg>media-libs/harfbuzz</pkg> instead of bundled and <pkg>media-gfx/graphite2</pkg> in most cases
system-jpeg Use the system-wide <pkg>media-libs/libjpeg-turbo</pkg> instead of bundled
system-libevent Use the system-wide <pkg>dev-libs/libevent</pkg> instead of bundled
system-libvpx Use the system-wide <pkg>media-libs/libvpx</pkg> instead of bundled
system-pipewire Use system <pkg>media-video/pipewire</pkg> for WebRTC and screencast instead of bundled one
system-png Use the system-wide <pkg>media-libs/libpng</pkg> instead of bundled (requires APNG patches)
system-webp Use the system-wide <pkg>media-libs/libwebp</pkg> instead of bundled
telemetry
wasm-sandbox Sandbox certain third-party libraries through WebAssembly using RLBox
wifi Enable necko-wifi for NetworkManager integration, and access point MAC address scanning for better precision with opt-in geolocation services

x11-libs

fltk

Flag Description
games
xft

gdk-pixbuf

Flag Description
glycin
multilib
thumbnailer

x11-wm

mutter

Flag Description
devkit
xwayland