# All 76 fastfetch modules

> A module is one line (or block) of fastfetch output, such as CPU, GPU, Memory or Disk. This explorer lists all 76 in version 2.71.0, built from the source code and the official JSON schema.

Canonical page: https://fastfetch.dev/modules/ · Checked against fastfetch 2.71.0 · Updated 2026-11-06 · Independent guide, not affiliated with the fastfetch-cli project.

#### Modules by category

Our grouping of the 76 modules in src/modules/ (2.71.0).

| Category | Modules |
| --- | --- |
| Hardware | 30 |
| System & software | 18 |
| Desktop & theme | 9 |
| Network & media | 8 |
| Graphics APIs | 4 |
| Layout & custom | 7 |

Source: fastfetch 2.71.0 source

#### Modules with an implementation, per platform

Counted from the per-platform source lists in CMakeLists.txt. Code being present does not guarantee a result on every machine.

| Platform | Modules with an implementation |
| --- | --- |
| Linux | 71 of 76 |
| macOS | 69 of 76 |
| Windows | 69 of 76 |
| FreeBSD | 68 of 76 |
| NetBSD | 62 of 76 |
| OpenBSD | 61 of 76 |
| Haiku | 59 of 76 |
| Android | 58 of 76 |
| illumos/Solaris | 58 of 76 |
| GNU Hurd | 51 of 76 |

Source: fastfetch 2.71.0 CMakeLists.txt

## How to turn modules on and off

Just this once

Show only the modules you name, separated by colons:

```bash
fastfetch -s cpu:gpu:memory
```

Default minus a few

Keep the default list but drop some modules:

```bash
fastfetch --structure-disabled localip:battery
```

Everything

The bundled `all` preset runs 73 modules (all except Command, Custom and Logo). It includes PublicIp and Weather, which go online.

```bash
fastfetch -c all
```

To make changes permanent, list modules in the `"modules"` array of your [config file](/config/). A module can be a plain string (`"cpu"`) or an object with options (`{"type": "cpu", "temp": true}`). Options exist only in the config file: per-module command-line flags such as `--cpu-temp` were removed in 2.50.0.

### Battery

Print battery information

**Category:** Hardware · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku

```bash
fastfetch -s battery
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{manufacturer}` | Battery manufacturer |
| `{model-name}` | Battery model name \* |
| `{technology}` | Battery technology |
| `{capacity}` | Battery capacity (percentage num) |
| `{status}` | Battery status |
| `{temperature}` | Battery temperature (formatted) |
| `{cycle-count}` | Battery cycle count |
| `{serial}` | Battery serial number |
| `{manufacture-date}` | Battery manufacture date |
| `{capacity-bar}` | Battery capacity (percentage bar) |
| `{time-days}` | Battery time remaining days |
| `{time-hours}` | Battery time remaining hours |
| `{time-minutes}` | Battery time remaining minutes |
| `{time-seconds}` | Battery time remaining seconds |
| `{time-formatted}` | Battery time remaining (formatted) |

### BIOS

Print first-stage bootloader information (name, version, release date, etc.)

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku

```bash
fastfetch -s bios
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{date}` | BIOS date |
| `{release}` | BIOS release |
| `{vendor}` | BIOS vendor |
| `{version}` | BIOS version |
| `{type}` | Firmware type \* |

### Bluetooth

List connected Bluetooth devices

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, Haiku, GNU Hurd

```bash
fastfetch -s bluetooth
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Name |
| `{address}` | Address |
| `{type}` | Type |
| `{device-type}` | Bluetooth stacks the device answers on |
| `{battery-percentage}` | Battery percentage number |
| `{battery-percentage-bar}` | Battery percentage bar |
| `{signal-quality}` | Signal quality number |
| `{signal-quality-bar}` | Signal quality bar |
| `{connected}` | Is connected |

Options:

| Option | Meaning |
| --- | --- |
| `showDisconnected` | Whether to show disconnected Bluetooth devices Default: `false` |
| `showType` | Which Bluetooth stacks to look for Default: `"both"` |

### BluetoothRadio

List Bluetooth radios (supported versions, vendors, etc.)

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, GNU Hurd

```bash
fastfetch -s bluetoothradio
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Radio name for discovering \* |
| `{address}` | Address |
| `{lmp-version}` | LMP version |
| `{lmp-subversion}` | LMP subversion |
| `{version}` | Bluetooth version |
| `{vendor}` | Vendor |
| `{discoverable}` | Discoverable |
| `{connectable}` | Connectable / Pairable |

### Board

Print motherboard name and other information

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku

```bash
fastfetch -s board
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Board name |
| `{vendor}` | Board vendor |
| `{version}` | Board version |
| `{serial}` | Board serial number |

### Bootmgr

Print second-stage bootloader information (name, firmware, etc.)

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Haiku

```bash
fastfetch -s bootmgr
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Name / description |
| `{firmware-path}` | Firmware file path |
| `{firmware-name}` | Firmware file name |
| `{secure-boot}` | Is secure boot enabled |
| `{order}` | Boot order |

### Break

Print an empty line

**Category:** Layout & custom · **In default output:** yes · **Detection code for:** Works everywhere (no detection needed)

```bash
fastfetch -s break
```

### Brightness

Print the current brightness level of your monitors

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Haiku

```bash
fastfetch -s brightness
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{percentage}` | Screen brightness (percentage num) |
| `{name}` | Screen name \* |
| `{max}` | Maximum brightness value |
| `{min}` | Minimum brightness value |
| `{current}` | Current brightness value |
| `{percentage-bar}` | Screen brightness (percentage bar) |
| `{is-builtin}` | Is built-in screen |

Options:

| Option | Meaning |
| --- | --- |
| `ddcciSleep` | Sleep time in milliseconds between DDC/CI requests Set to null to skip DDC/CI detection Default: `10` |
| `compact` | Whether to print multiple results on a single line Default: `false` |

### Btrfs

Print Linux BTRFS volumes

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux

Linux only.

```bash
fastfetch -s btrfs
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Name / Label \* |
| `{uuid}` | UUID |
| `{devices}` | Associated devices |
| `{features}` | Enabled features |
| `{used}` | Size used |
| `{allocated}` | Size allocated |
| `{total}` | Size total |
| `{used-percentage}` | Used percentage num |
| `{allocated-percentage}` | Allocated percentage num |
| `{used-percentage-bar}` | Used percentage bar |
| `{allocated-percentage-bar}` | Allocated percentage bar |
| `{node-size}` | Node size |
| `{sector-size}` | Sector size |

### Camera

Print available cameras

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android

```bash
fastfetch -s camera
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Device name |
| `{vendor}` | Vendor |
| `{colorspace}` | Color space |
| `{id}` | Identifier |
| `{width}` | Width (in px) |
| `{height}` | Height (in px) |

### Chassis

Print chassis type information (desktop, laptop, etc.)

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, illumos/Solaris, Haiku

```bash
fastfetch -s chassis
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{type}` | Chassis type |
| `{vendor}` | Chassis vendor |
| `{version}` | Chassis version |
| `{serial}` | Chassis serial number |

### Codec

Print hardware video acceleration codec types (decode / encode)

**Category:** Graphics APIs · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s codec
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{gpu}` | GPU name \* |
| `{direction}` | Decoder / Encoder \* |
| `{types}` | Compatibility alias of codec types |
| `{platform-api}` | Platform API used for detection |

Options:

| Option | Meaning |
| --- | --- |
| `splitGPU` | Whether to print each GPU separately. If false, merge codecs from all GPUs Default: `false` |
| `useVulkan` | Whether to use Vulkan for codec detection instead of other platform-specific APIs Default: `false` |
| `showType` | Which types of codecs to detect and show Default: `"both"` |

### Colors

Display the terminal's 16-color palette

**Category:** Layout & custom · **In default output:** yes · **Detection code for:** Works everywhere (no detection needed)

Prints the terminal palette blocks you see at the bottom of the default output.

```bash
fastfetch -s colors
```

Options:

| Option | Meaning |
| --- | --- |
| `symbol` | Set the symbol to use Default: `"background"` |
| `paddingLeft` | Set the number of white spaces to print before the symbol Default: `0` |
| `block` | Set behavior of block printing. Only works when symbol is set to `block` or `background` |
| `brightness` | Set the brightness of colors. Works together with the block color range to determine which colors are displayed Default: `"default"` |

### Command

Run custom shell scripts

**Category:** Layout & custom · **In default output:** no · **Detection code for:** none

Runs a shell command every time fastfetch starts. Read any config you copy for `"type": "command"` entries before using it.

```bash
fastfetch -s command
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{result}` | Command result |

Options:

| Option | Meaning |
| --- | --- |
| `shell` | Shell program used to execute the command text Default: `cmd` on Windows, `/bin/sh` on Unix-like systems |
| `param` | Parameter used when starting the shell If set to an empty string, it is ignored Default: `/c` on Windows, `-c` on Unix-like systems |
| `text` | Command text to execute |
| `useOutput` | Which of the command's output streams to capture The stream that is not captured is discarded Default: `"both"` |
| `parallel` | Whether to execute the command in parallel with other commands This can improve performance when using multiple commands, but may cause issues with some commands Default: `true` |
| `splitLines` | Whether to split command output into multiple lines Default: `false` |

### CPU

Print CPU name, frequency, etc.

**Category:** Hardware · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s cpu
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Name |
| `{vendor}` | Vendor |
| `{cores-physical}` | Physical core count |
| `{cores-logical}` | Logical core count |
| `{cores-online}` | Online core count |
| `{freq-base}` | Base frequency (formatted) |
| `{freq-max}` | Max frequency (formatted) |
| `{temperature}` | Temperature (formatted) |
| `{core-types}` | Logical core count grouped by frequency |
| `{packages}` | Processor package count |
| `{march}` | CPU microarchitecture |
| `{numa-nodes}` | NUMA node count |

Options:

| Option | Meaning |
| --- | --- |
| `tempSensor` | Set the temperature sensor to use for CPU temperature detection \* Linux: `hwmon` or `thermal` path name (eg. `hwmon0`, `thermal\_zone0)` \* macOS: SMC sensor key (eg. `Tp01`) \* Windows: thermal zone key (eg. `\\_TZ.CPUZ`) \* FreeBSD: sysctl key (eg. `dev.cpu.0.temperature`) \* NetBSD: sysmon sensor key (eg. `coretemp0`) |
| `showPeCoreCount` | Whether to detect and display CPU frequencies for different core types (for example, P-cores and E-cores), if supported Default: `true` |

### CPUCache

Print CPU cache sizes

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku

```bash
fastfetch -s cpucache
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{result}` | Separate result |
| `{sum}` | Sum result |
| `{level}` | Cache level \* |

Options:

| Option | Meaning |
| --- | --- |
| `compact` | Print one line with a total per cache level instead of one line per level Default: `false` |

### CPUUsage

Print CPU usage. Collecting data takes some time

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

Measures usage by sampling CPU time twice, `waitTime` apart (default 200 ms), so it adds that delay to every run.

```bash
fastfetch -s cpuusage
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{avg}` | CPU usage (percentage num, average) |
| `{max}` | CPU usage (percentage num, maximum) |
| `{max-index}` | CPU core index of maximum usage |
| `{min}` | CPU usage (percentage num, minimum) |
| `{min-index}` | CPU core index of minimum usage |
| `{avg-bar}` | CPU usage (percentage bar, average) |
| `{max-bar}` | CPU usage (percentage bar, maximum) |
| `{min-bar}` | CPU usage (percentage bar, minimum) |

Options:

| Option | Meaning |
| --- | --- |
| `separate` | Show CPU usage for each logical core instead of an average Default: `false` |
| `waitTime` | Wait time (in ms). CPU usage = (inUseEnd - inUseStart) / waitTime Default: `200` |

### Cursor

Print cursor style name

**Category:** Desktop & theme · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, GNU Hurd

```bash
fastfetch -s cursor
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{theme}` | Cursor theme |
| `{size}` | Cursor size |

### Custom

Print a custom string, with or without key

**Category:** Layout & custom · **In default output:** no · **Detection code for:** Works everywhere (no detection needed)

```bash
fastfetch -s custom
```

### DateTime

Print the current date and time

**Category:** System & software · **In default output:** no · **Detection code for:** Works everywhere (no detection needed)

```bash
fastfetch -s datetime
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{year}` | Year |
| `{year-short}` | Last two digits of year |
| `{month}` | Month |
| `{month-pretty}` | Month with leading zero |
| `{month-name}` | Month name |
| `{month-name-short}` | Month name short |
| `{week}` | Week number on year |
| `{weekday}` | Weekday |
| `{weekday-short}` | Weekday short |
| `{day-in-year}` | Day in year |
| `{day-in-month}` | Day in month |
| `{day-in-week}` | Day in week |
| `{hour}` | Hour |
| `{hour-pretty}` | Hour with leading zero |
| `{hour-12}` | Hour 12h format |
| `{hour-12-pretty}` | Hour 12h format with leading zero |
| `{minute}` | Minute |
| `{minute-pretty}` | Minute with leading zero |
| `{second}` | Second |
| `{second-pretty}` | Second with leading zero |
| `{offset-from-utc}` | Offset from UTC in the ISO 8601 format |
| `{timezone-name}` | Locale-dependent timezone name or abbreviation |
| `{day-pretty}` | Day in month with leading zero |
| `{am-pm}` | AM or PM |

### DE

Print desktop environment name

**Category:** Desktop & theme · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s de
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{process-name}` | DE process name |
| `{pretty-name}` | DE pretty name |
| `{version}` | DE version |

### Disk

Print partitions, space usage, file system, etc

**Category:** Hardware · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s disk
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{size-used}` | Size used (formatted) |
| `{size-total}` | Size total (formatted) |
| `{size-percentage}` | Size percentage num |
| `{files-used}` | Files used |
| `{files-total}` | Files total |
| `{files-percentage}` | Files percentage num |
| `{is-external}` | True if external volume |
| `{is-hidden}` | True if hidden volume |
| `{filesystem}` | Filesystem \* |
| `{name}` | Label / name \* |
| `{is-readonly}` | True if read-only |
| `{create-time}` | Create time in local timezone |
| `{size-percentage-bar}` | Size percentage bar |
| `{files-percentage-bar}` | Files percentage bar |
| `{days}` | Days after creation |
| `{hours}` | Hours after creation |
| `{minutes}` | Minutes after creation |
| `{seconds}` | Seconds after creation |
| `{milliseconds}` | Milliseconds after creation |
| `{mountpoint}` | Mount point / drive letter \* |
| `{mount-from}` | Mount from (device path) \* |
| `{years}` | Years integer after creation |
| `{days-of-year}` | Days of year after creation |
| `{years-fraction}` | Years fraction after creation |
| `{size-free}` | Size free (formatted) |
| `{bytes-used}` | Size used (in bytes) |
| `{bytes-total}` | Size total (in bytes) |

Options:

| Option | Meaning |
| --- | --- |
| `folders` | A list of folder paths for the disk output Default: auto detection using mount-points This option overrides other `show\*` options |
| `hideFolders` | A list of folder paths (or glob patterns) to hide from the disk output Default: `"/efi:/boot:/boot/*"` |
| `hideFS` | A list of file systems to hide from the disk output |
| `showRegular` | Whether to show regular volumes Default: `true` |
| `showExternal` | Whether to show external volumes Default: `true` |
| `showHidden` | Whether to show hidden volumes Default: `false` |
| `showSubvolumes` | Whether to show subvolumes Default: `false` |
| `showReadOnly` | Whether to show read-only volumes Default: `false` |
| `showUnknown` | Whether to show unknown volumes whose sizes cannot be detected Default: `false` |
| `useAvailable` | Use f\_bavail instead of f\_bfree to calculate used bytes May be required for macOS to display correct results On Windows, set to true to make fastfetch honors the quota settings Default: `false` |

### DiskIO

Print physical disk I/O throughput

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris

Samples disk counters twice, `waitTime` apart (default 250 ms).

```bash
fastfetch -s diskio
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{size-read}` | Size of data read [per second] (formatted) |
| `{size-written}` | Size of data written [per second] (formatted) |
| `{name}` | Device name \* |
| `{dev-path}` | Device raw file path \* |
| `{bytes-read}` | Size of data read [per second] (in bytes) |
| `{bytes-written}` | Size of data written [per second] (in bytes) |
| `{read-count}` | Number of reads |
| `{write-count}` | Number of writes |

Options:

| Option | Meaning |
| --- | --- |
| `namePrefix` | Show only disks whose names start with this prefix |
| `detectTotal` | Show total bytes instead of the current rate Default: `false` |
| `waitTime` | Wait time (in ms) used to measure the I/O rate (calculated in bytes/sec). Avoid setting this too low, as the kernel requires time to accurately update counters. Ignored if 'detectTotal' is true. Default: `250` |

### Display

Print resolutions, refresh rates, etc

**Category:** Hardware · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s display
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{width}` | Screen configured width (in pixels) |
| `{height}` | Screen configured height (in pixels) |
| `{refresh-rate}` | Screen configured refresh rate (in Hz) |
| `{scaled-width}` | Screen scaled width (in pixels) |
| `{scaled-height}` | Screen scaled height (in pixels) |
| `{name}` | Screen name \* |
| `{type}` | Screen type (Built-in or External) \* |
| `{rotation}` | Screen rotation (in degrees) |
| `{is-primary}` | True if being the primary screen |
| `{physical-width}` | Screen physical width (in millimeters) |
| `{physical-height}` | Screen physical height (in millimeters) |
| `{inch}` | Physical diagonal length in inches |
| `{ppi}` | Pixels per inch (PPI) |
| `{bit-depth}` | Bits per color channel |
| `{hdr-enabled}` | True if high dynamic range (HDR) mode is enabled |
| `{manufacture-year}` | Year of manufacturing |
| `{manufacture-week}` | Nth week of manufacturing in the year |
| `{serial}` | Serial number |
| `{platform-api}` | The platform API used when detecting the display |
| `{hdr-compatible}` | True if the display is HDR compatible |
| `{scale-factor}` | HiDPI scale factor |
| `{preferred-width}` | Screen preferred width (in pixels) |
| `{preferred-height}` | Screen preferred height (in pixels) |
| `{preferred-refresh-rate}` | Screen preferred refresh rate (in Hz) |
| `{dpi}` | DPI |

Options:

| Option | Meaning |
| --- | --- |
| `compactType` | Whether to print all displays on a single line |
| `preciseRefreshRate` | Whether to preserve decimal refresh rates instead of rounding them to integers Default: `false` |
| `order` | Order to use when printing displays |

### DNS

Print configured DNS servers

**Category:** Network & media · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s dns
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{result}` | DNS result |

Options:

| Option | Meaning |
| --- | --- |
| `showType` | Which DNS server types to show Default: `"both"` |

### Editor

Print information about the default editor ($VISUAL or $EDITOR)

**Category:** System & software · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, Android, GNU Hurd

```bash
fastfetch -s editor
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{type}` | Type (Visual / Editor) |
| `{name}` | Name |
| `{exe-name}` | Exe name of real path |
| `{path}` | Full path of real path |
| `{version}` | Version |

### Font

Print system font names

**Category:** Desktop & theme · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s font
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{font1}` | Font 1 |
| `{font2}` | Font 2 |
| `{font3}` | Font 3 |
| `{font4}` | Font 4 |
| `{combined}` | Combined fonts for display |

### Gamepad

List connected gamepads

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, Haiku

```bash
fastfetch -s gamepad
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Name |
| `{serial}` | Serial number |
| `{battery-percentage}` | Battery percentage num |
| `{battery-percentage-bar}` | Battery percentage bar |

Options:

| Option | Meaning |
| --- | --- |
| `ignores` | An array of case-insensitive device name prefixes to ignore |

### GPU

Print GPU names, memory sizes, types, etc

**Category:** Hardware · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s gpu
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{vendor}` | GPU vendor |
| `{name}` | GPU name |
| `{driver}` | GPU driver |
| `{temperature}` | GPU temperature |
| `{core-count}` | GPU core count |
| `{type}` | GPU type |
| `{dedicated-total}` | GPU total dedicated memory |
| `{dedicated-used}` | GPU used dedicated memory |
| `{shared-total}` | GPU total shared memory |
| `{shared-used}` | GPU used shared memory |
| `{platform-api}` | The platform API used when detecting the GPU |
| `{frequency}` | Current frequency in GHz |
| `{index}` | GPU vendor specific index |
| `{dedicated-percentage-num}` | Dedicated memory usage percentage num |
| `{dedicated-percentage-bar}` | Dedicated memory usage percentage bar |
| `{shared-percentage-num}` | Shared memory usage percentage num |
| `{shared-percentage-bar}` | Shared memory usage percentage bar |
| `{core-usage-num}` | Core usage percentage num |
| `{core-usage-bar}` | Core usage percentage bar |
| `{memory-type}` | Memory type (Windows only) |
| `{pcie-max-speed}` | PCIe maximum speed in gen and lanes |
| `{pcie-curr-speed}` | PCIe current speed in gen and lanes |

Options:

| Option | Meaning |
| --- | --- |
| `driverSpecific` | Use driver specific method to detect more detailed GPU information (memory usage, core count, etc) Requires the latest GPU drivers to be installed. Default: `false` |
| `detectionMethod` | Force a specific GPU detection method Default: `"<varies-by-platform>"` |
| `hideType` | Hide GPUs of a specific type |

### Host

Print your computer's product name

**Category:** Hardware · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku

```bash
fastfetch -s host
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{family}` | Product family |
| `{name}` | Product name |
| `{version}` | Product version |
| `{sku}` | Product sku |
| `{vendor}` | Product vendor |
| `{serial}` | Product serial number |
| `{uuid}` | Product uuid |

### Icons

Print icon style name

**Category:** Desktop & theme · **In default output:** yes · **Detection code for:** Linux, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, GNU Hurd

```bash
fastfetch -s icons
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{icons1}` | Icons part 1 |
| `{icons2}` | Icons part 2 |

### InitSystem

Print init system (pid 1) name and version

**Category:** System & software · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s initsystem
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Init system name |
| `{exe}` | Init system exe path |
| `{version}` | Init system version path |
| `{pid}` | Init system pid |

### Kernel

Print system kernel version

**Category:** System & software · **In default output:** yes · **Detection code for:** Works everywhere (no detection needed)

```bash
fastfetch -s kernel
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{sysname}` | Sysname |
| `{release}` | Release |
| `{version}` | Version |
| `{arch}` | Architecture |
| `{page-size}` | Page size |

### Keyboard

List connected keyboards

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, Haiku

```bash
fastfetch -s keyboard
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Name |
| `{serial}` | Serial number |

Options:

| Option | Meaning |
| --- | --- |
| `ignores` | An array of case-insensitive device name prefixes to ignore |

### LM

Print login manager (desktop manager) name and version

**Category:** Desktop & theme · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, illumos/Solaris, GNU Hurd

```bash
fastfetch -s lm
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{service}` | LM service / process name |
| `{pretty-name}` | LM pretty name |
| `{version}` | LM version |

### Loadavg

Print system load averages

**Category:** System & software · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s loadavg
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{loadavg1}` | Load average over 1min |
| `{loadavg2}` | Load average over 5min |
| `{loadavg3}` | Load average over 15min |

Options:

| Option | Meaning |
| --- | --- |
| `ndigits` | Set the number of digits to keep after the decimal point Default: `2` |
| `compact` | Show values in one line Default: `true` |

### Locale

Print system locale name

**Category:** System & software · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s locale
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{result}` | Locale code |

### LocalIp

List local IP addresses (IPv4 or IPv6), MAC addresses, etc

**Category:** Network & media · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s localip
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{ipv4}` | IPv4 address |
| `{ipv6}` | IPv6 address |
| `{mac}` | MAC address \* |
| `{ifname}` | Interface name \* |
| `{is-default-route}` | Is default route |
| `{mtu}` | MTU size in bytes |
| `{speed}` | Link speed (formatted) |
| `{flags}` | Interface flags |

Options:

| Option | Meaning |
| --- | --- |
| `showIpv4` | Show IPv4 addresses Default: `true` |
| `showIpv6` | Show IPv6 addresses Default: `false` |
| `showSpeed` | Show Ethernet RX speed Default: `false` |
| `showMtu` | Show MTU Default: `false` |
| `showMac` | Show MAC addresses Default: `false` |
| `showLoop` | Show loop back addresses (127.0.0.1) Default: `false` |
| `showPrefixLen` | Show network prefix length (/N) Default: `true` |
| `showAllIps` | Show all IPs bound to the same interface By default, only the first detected IP is shown Default: `false` |
| `showFlags` | Show the interface's flags Default: `false` |
| `compact` | Show all IPs in one line Default: `false` |
| `namePrefix` | Show IPs with given name prefix only |
| `defaultRouteOnly` | Show only IPs used for the default route Does not work on Android Default: `true` |

### Logo

Query built-in logo for JSON output

**Category:** Layout & custom · **In default output:** no · **Detection code for:** Works everywhere (no detection needed)

Not shown in normal output. Use it with `--format json` to get the built-in logo data.

```bash
fastfetch -s logo
```

### Media

Print the name of the currently playing song

**Category:** Network & media · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s media
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{combined}` | Pretty media name |
| `{title}` | Media name |
| `{artist}` | Artist name |
| `{album}` | Album name |
| `{status}` | Status |
| `{progress}` | Progress in text |
| `{progress-num}` | Progress in percentage (number) |
| `{progress-bar}` | Progress in percentage (bar) |
| `{player-name}` | Player name |
| `{player-id}` | Player ID |
| `{url}` | URL |

### Memory

Print system memory usage information

**Category:** Hardware · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s memory
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{used}` | Used size |
| `{total}` | Total size |
| `{percentage}` | Percentage used (num) |
| `{percentage-bar}` | Percentage used (bar) |

### Monitor

Same as Display module, but with a different default output format

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s monitor
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Display name \* |
| `{width}` | Native resolution width in pixels |
| `{height}` | Native resolution height in pixels |
| `{physical-width}` | Physical width in millimeters |
| `{physical-height}` | Physical height in millimeters |
| `{inch}` | Physical diagonal length in inches |
| `{ppi}` | Pixels per inch (PPI) |
| `{manufacture-year}` | Year of manufacturing |
| `{manufacture-week}` | Nth week of manufacturing in the year |
| `{serial}` | Serial number |
| `{refresh-rate}` | Maximum refresh rate in Hz |
| `{hdr-compatible}` | True if the display is HDR compatible |

### Mouse

List connected mice

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, Haiku

```bash
fastfetch -s mouse
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Mouse name |
| `{serial}` | Mouse serial number |

Options:

| Option | Meaning |
| --- | --- |
| `ignores` | An array of case-insensitive device name prefixes to ignore |

### NetIO

Print network I/O throughput

**Category:** Network & media · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku

Samples network counters twice, `waitTime` apart (default 250 ms).

```bash
fastfetch -s netio
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{rx-size}` | Size of data received [per second] (formatted) |
| `{tx-size}` | Size of data sent [per second] (formatted) |
| `{ifname}` | Interface name \* |
| `{is-default-route}` | Is default route |
| `{rx-bytes}` | Size of data received [per second] (in bytes) |
| `{tx-bytes}` | Size of data sent [per second] (in bytes) |
| `{rx-packets}` | Number of packets received [per second] |
| `{tx-packets}` | Number of packets sent [per second] |
| `{rx-errors}` | Number of errors received [per second] |
| `{tx-errors}` | Number of errors sent [per second] |
| `{rx-drops}` | Number of packets dropped when receiving [per second] |
| `{tx-drops}` | Number of packets dropped when sending [per second] |

Options:

| Option | Meaning |
| --- | --- |
| `namePrefix` | Show only interfaces whose names start with this prefix |
| `defaultRouteOnly` | Show only interfaces used for the default route Does not work on Android Default: `true` |
| `detectTotal` | Detect total bytes instead of current rate Default: `false` |
| `waitTime` | Wait time (in ms) used to measure the I/O rate (calculated in bytes/sec). Avoid setting this too low, as the kernel requires time to accurately update counters. Ignored if 'detectTotal' is true. Default: `250` |

### OpenCL

Print the highest OpenCL version supported by the GPU

**Category:** Graphics APIs · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s opencl
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{version}` | Platform version |
| `{name}` | Platform name |
| `{vendor}` | Platform vendor |

### OpenGL

Print the highest OpenGL version supported by the GPU

**Category:** Graphics APIs · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

Creates an OpenGL context to read the version, so it is one of the slower modules (about 9 ms on the Linux CI runner).

```bash
fastfetch -s opengl
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{version}` | OpenGL version |
| `{renderer}` | OpenGL renderer |
| `{vendor}` | OpenGL vendor |
| `{slv}` | OpenGL shading language version |
| `{library}` | OpenGL library used |

Options:

| Option | Meaning |
| --- | --- |
| `library` | Set the OpenGL context creation library to use Default: `"auto"` |

### OS

Print the OS or Linux distribution name and version

**Category:** System & software · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s os
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{sysname}` | Name of the kernel \* |
| `{name}` | Name of the OS \* |
| `{pretty-name}` | Pretty name of the OS, if available |
| `{id}` | ID of the OS |
| `{id-like}` | ID like of the OS |
| `{variant}` | Variant of the OS |
| `{variant-id}` | Variant ID of the OS |
| `{version}` | Version of the OS |
| `{version-id}` | Version ID of the OS |
| `{codename}` | Version codename of the OS |
| `{build-id}` | Build ID of the OS |
| `{arch}` | Architecture of the OS |
| `{kernel-release}` | Release of the kernel |

### Packages

List installed package managers and count of installed packages

**Category:** System & software · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s packages
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{am-system}` | Number of am-system packages |
| `{am-user}` | Number of am-user (aka appman) packages |
| `{appimage}` | Number of appimage packages |
| `{apk}` | Number of apk packages |
| `{brew}` | Number of brew packages |
| `{brew-cask}` | Number of brew-cask packages |
| `{cards}` | Number of cards packages |
| `{choco}` | Number of choco packages |
| `{crux}` | Number of crux packages |
| `{dpkg}` | Number of dpkg packages |
| `{emerge}` | Number of emerge packages |
| `{eopkg}` | Number of eopkg packages |
| `{flatpak-system}` | Number of flatpak-system app packages |
| `{flatpak-user}` | Number of flatpak-user app packages |
| `{guix-home}` | Number of guix-home packages |
| `{guix-system}` | Number of guix-system packages |
| `{guix-user}` | Number of guix-user packages |
| `{hpkg-system}` | Number of hpkg-system packages |
| `{hpkg-user}` | Number of hpkg-user packages |
| `{install-release}` | Number of install-release packages |
| `{kiss}` | Number of kiss packages |
| `{linglong}` | Number of linglong packages |
| `{lpkg}` | Number of lpkg packages |
| `{lpkgbuild}` | Number of lpkgbuild packages |
| `{macports}` | Number of macports packages |
| `{mport}` | Number of mport packages |
| `{moss}` | Number of moss packages |
| `{nix-default}` | Number of nix-default packages |
| `{nix-system}` | Number of nix-system packages |
| `{nix-user}` | Number of nix-user packages |
| `{opkg}` | Number of opkg packages |
| `{pacman}` | Number of pacman packages |
| `{pacman-branch}` | Pacman branch on manjaro |
| `{pacstall}` | Number of pacstall packages |
| `{paludis}` | Number of paludis packages |
| `{pisi}` | Number of pisi packages |
| `{pkg}` | Number of pkg packages |
| `{pkgsrc}` | Number of pkgsrc packages |
| `{pkgtool}` | Number of pkgtool packages |
| `{porg}` | Number of porg packages |
| `{rpm}` | Number of rpm packages |
| `{rum}` | Number of rum overlay packages |
| `{scoop-global}` | Number of scoop-global packages |
| `{scoop-user}` | Number of scoop-user packages |
| `{snap}` | Number of snap packages |
| `{soar}` | Number of soar packages |
| `{sorcery}` | Number of sorcery packages |
| `{winget}` | Number of winget packages |
| `{xbps}` | Number of xbps packages |
| `{brew-all}` | Total number of all brew packages |
| `{flatpak-all}` | Total number of all flatpak app packages |
| `{guix-all}` | Total number of all guix packages |
| `{hpkg-all}` | Total number of all hpkg packages |
| `{nix-all}` | Total number of all nix packages |
| `{all}` | Number of all packages |

Options:

| Option | Meaning |
| --- | --- |
| `disabled` |  |
| `combined` | Whether to combine related package managers into single counts (e.g., nix-system + nix-user = nix) Default: `false` |

### PhysicalDisk

Print physical disk information

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku

```bash
fastfetch -s physicaldisk
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{size}` | Device size (formatted) |
| `{name}` | Device name \* |
| `{interconnect}` | Device interconnect type |
| `{dev-path}` | Device raw file path \* |
| `{serial}` | Serial number |
| `{physical-type}` | Device kind (SSD or HDD) |
| `{removable-type}` | Device kind (Removable or Fixed) |
| `{readonly-type}` | Device kind (Read-only or Read-write) |
| `{revision}` | Product revision |
| `{temperature}` | Device temperature (formatted) |

Options:

| Option | Meaning |
| --- | --- |
| `namePrefix` | Show disks with given name prefix only |
| `hideVirtual` | Hide virtual disks (e.g. loop, RAM or file baked disks) Default: `false` |
| `hideUnused` | Hide disks with `size == 0` (likely unused/unconnected) Default: `true` |

### PhysicalMemory

Print system physical memory devices

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, illumos/Solaris, Haiku

```bash
fastfetch -s physicalmemory
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{bytes}` | Size (in bytes) |
| `{size}` | Size formatted |
| `{max-speed}` | Max speed (in MT/s) |
| `{running-speed}` | Running speed (in MT/s) |
| `{type}` | Type (DDR4, DDR5, etc.) |
| `{form-factor}` | Form factor (SODIMM, DIMM, etc.) |
| `{locator}` | Bank/Device Locator (BANK0/SIMM0, BANK0/SIMM1, etc.) |
| `{vendor}` | Vendor |
| `{serial}` | Serial number |
| `{part-number}` | Part number |
| `{is-ecc-enabled}` | True if ECC enabled |
| `{is-installed}` | True if a memory module is installed in the slot |

Options:

| Option | Meaning |
| --- | --- |
| `showEmptySlots` | Whether to show uninstalled memory slots Default: `false` |

### Player

Print the music player name that is currently active

**Category:** Network & media · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s player
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{player}` | Pretty player name |
| `{name}` | Player name |
| `{id}` | Player Identifier |
| `{url}` | URL name |

### PowerAdapter

Print power adapter name and charging watts

**Category:** Hardware · **In default output:** yes · **Detection code for:** Linux, macOS

```bash
fastfetch -s poweradapter
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{watts}` | Power adapter watts |
| `{name}` | Power adapter name |
| `{manufacturer}` | Power adapter manufacturer |
| `{model-name}` | Power adapter model name |
| `{description}` | Power adapter description |
| `{serial}` | Power adapter serial number |

### Processes

Print number of running processes and threads

**Category:** System & software · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s processes
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{result}` | Process count |
| `{threads}` | Thread count |

Options:

| Option | Meaning |
| --- | --- |
| `countKprocs` | Whether to take kernel processes and threads into account Default: `false` |

### PublicIp

Print your public IP address and related information

**Category:** Network & media · **In default output:** no · **Detection code for:** none

Makes a network request, by default to `ipinfo.io` over HTTP. Only runs if you add it to your config.

```bash
fastfetch -s publicip
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{ip}` | Public IP address |
| `{location}` | Location |

Options:

| Option | Meaning |
| --- | --- |
| `url` | URL of the public IP detection server to use. Only HTTP is supported If empty, `http://ipinfo.io/json` is requested (`http://v6.ipinfo.io/json` when `ipv6` is set), with TCP Fast Open enabled. A non-empty URL disables both and makes `ipv6` have no effect |
| `timeout` | Time in milliseconds to wait for the public IP server to respond Set to 0 to disable the timeout Default: `0` |
| `ipv6` | Whether to use IPv6 for the public IP detection server Default: `false` |

### Separator

Print a separator line

**Category:** Layout & custom · **In default output:** yes · **Detection code for:** Works everywhere (no detection needed)

```bash
fastfetch -s separator
```

Options:

| Option | Meaning |
| --- | --- |
| `string` | String to print for the separator line Default: `"-"` |
| `times` | Number of times to repeat the separator string, or 0 to auto-detect Default: `0` |

### Shell

Print the current shell name and version

**Category:** System & software · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s shell
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{process-name}` | Shell process name |
| `{exe}` | The first argument of the command line when running the shell |
| `{exe-name}` | Shell base name of arg0 |
| `{version}` | Shell version |
| `{pid}` | Shell pid |
| `{pretty-name}` | Shell pretty name |
| `{exe-path}` | Shell full exe path |
| `{tty}` | Shell tty used |

### Sound

Print sound devices, volume levels, etc

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s sound
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{is-main}` | Is main sound device |
| `{is-active}` | Is active sound device |
| `{name}` | Device name |
| `{volume-percentage}` | Volume (in percentage num) |
| `{identifier}` | Identifier |
| `{volume-percentage-bar}` | Volume (in percentage bar) |
| `{platform-api}` | Platform API used |

Options:

| Option | Meaning |
| --- | --- |
| `soundType` | Which sound devices to print Default: `"main"` |

### Swap

Print swap (paging file) space usage

**Category:** Hardware · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s swap
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{used}` | Used size |
| `{total}` | Total size |
| `{percentage}` | Percentage used (num) |
| `{percentage-bar}` | Percentage used (bar) |
| `{name}` | Name \* |

Options:

| Option | Meaning |
| --- | --- |
| `separate` | Whether to report individual swap devices on separate lines instead of showing a summary Default: `false` |

### Terminal

Print the current terminal name and version

**Category:** System & software · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s terminal
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{process-name}` | Terminal process name |
| `{exe}` | The first argument of the command line when running the terminal |
| `{exe-name}` | Terminal base name of arg0 |
| `{pid}` | Terminal pid |
| `{pretty-name}` | Terminal pretty name |
| `{version}` | Terminal version |
| `{exe-path}` | Terminal full exe path |
| `{tty}` | Terminal tty / pts used |

### TerminalFont

Print the font name and size used by the current terminal

**Category:** System & software · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s terminalfont
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{combined}` | Terminal font combined |
| `{name}` | Terminal font name |
| `{size}` | Terminal font size |
| `{styles}` | Terminal font styles |

### TerminalSize

Print the current terminal size

**Category:** System & software · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

On Windows, if the console API cannot report the size, it asks the terminal with an escape sequence and waits up to 1 s for the answer (visible in the CI benchmark).

```bash
fastfetch -s terminalsize
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{rows}` | Terminal rows |
| `{columns}` | Terminal columns |
| `{width}` | Terminal width (in pixels) |
| `{height}` | Terminal height (in pixels) |

### TerminalTheme

Print the current terminal theme (foreground and background colors)

**Category:** System & software · **In default output:** no · **Detection code for:** none

Asks the terminal for its colors with an escape sequence and waits up to 1 s for the answer.

```bash
fastfetch -s terminaltheme
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{fg-color}` | Terminal foreground color |
| `{fg-type}` | Terminal foreground type (Dark / Light) |
| `{bg-color}` | Terminal background color |
| `{bg-type}` | Terminal background type (Dark / Light) |

### Theme

Print the current desktop environment theme

**Category:** Desktop & theme · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, GNU Hurd

```bash
fastfetch -s theme
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{theme1}` | Theme part 1 |
| `{theme2}` | Theme part 2 |

### Title

Print the title, including your username and hostname

**Category:** Layout & custom · **In default output:** yes · **Detection code for:** Works everywhere (no detection needed)

```bash
fastfetch -s title
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{user-name}` | User name |
| `{host-name}` | Host name |
| `{home-dir}` | Home directory |
| `{exe-path}` | Executable path of current process |
| `{user-shell}` | User's default shell |
| `{user-name-colored}` | User name (colored) |
| `{at-symbol-colored}` | @ symbol (colored) |
| `{host-name-colored}` | Host name (colored) |
| `{full-user-name}` | Full user name |
| `{user-id}` | UID (\*nix) / SID (Windows) |
| `{pid}` | PID of current process |
| `{cwd}` | CWD with home dir replaced by `~` |

Options:

| Option | Meaning |
| --- | --- |
| `fqdn` | Whether to use the fully qualified domain name in the title Default: `false` |
| `color` | Colors for the different parts of the title |

### Top

Print processes with the highest CPU, memory or disk I/O usage

**Category:** System & software · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

Samples processes twice, `waitTime` apart (default 250 ms).

```bash
fastfetch -s top
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Process name |
| `{pid}` | Process ID |
| `{cpu}` | CPU usage |
| `{mem}` | Memory usage (RSS) in bytes |
| `{disk-read}` | Disk read bytes per second (0 if unsupported) |
| `{disk-write}` | Disk write bytes per second (0 if unsupported) |
| `{threads}` | Number of threads |
| `{cpu-percentage}` | CPU usage percentage |
| `{mem-formatted}` | Memory usage (RSS) formatted |
| `{disk-read-formatted}` | Disk read formatted |
| `{disk-write-formatted}` | Disk write formatted |

Options:

| Option | Meaning |
| --- | --- |
| `sort` | Sort processes by CPU, memory, disk IO usage, start time or thread count Default: `"cpu"` |
| `showTypes` | Specify which resource usages are detected and displayed. If memory or threads is enabled is enabled alone, only a single process snapshot is taken and `waitTime` sampling wait is skipped Default: `["cpu", "memory", "disk"]` |
| `processes` | Number of top processes to print Default: `5` |
| `waitTime` | Wait time between process samples, in milliseconds. Ignored when showTypes contains "memory" only Default: `250` |
| `compact` | Print all process on a single line Default: `false` |

### TPM

Print information about the Trusted Platform Module (TPM) security device

**Category:** Hardware · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD

```bash
fastfetch -s tpm
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{version}` | TPM device version |
| `{description}` | TPM general description |

### Uptime

Print how long the system has been running

**Category:** System & software · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s uptime
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{days}` | Days after boot |
| `{hours}` | Hours after boot |
| `{minutes}` | Minutes after boot |
| `{seconds}` | Seconds after boot |
| `{milliseconds}` | Milliseconds after boot |
| `{boot-time}` | Boot time in local timezone |
| `{years}` | Years integer after boot |
| `{days-of-year}` | Days of year after boot |
| `{years-fraction}` | Years fraction after boot |
| `{formatted}` | Formatted uptime |

### Users

Print users who are currently logged in

**Category:** System & software · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s users
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | User name |
| `{host-name}` | Host name |
| `{session-name}` | Session name |
| `{client-ip}` | Client IP |
| `{login-time}` | Login Time in local timezone |
| `{days}` | Days after login |
| `{hours}` | Hours after login |
| `{minutes}` | Minutes after login |
| `{seconds}` | Seconds after login |
| `{milliseconds}` | Milliseconds after login |
| `{years}` | Years integer after login |
| `{days-of-year}` | Days of year after login |
| `{years-fraction}` | Years fraction after login |

Options:

| Option | Meaning |
| --- | --- |
| `compact` | Show all active users in one line Default: `false` |
| `myselfOnly` | Show only the current user Default: `false` |

### Version

Print the Fastfetch version and build information

**Category:** System & software · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, Android, GNU Hurd

```bash
fastfetch -s version
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{project-name}` | Project name |
| `{version}` | Version |
| `{version-tweak}` | Version tweak |
| `{build-type}` | Build type (debug or release) |
| `{sysname}` | System name |
| `{arch}` | Architecture |
| `{cmake-built-type}` | CMake build type when compiling (Debug, Release, RelWithDebInfo, MinSizeRel) |
| `{compile-time}` | Date time when compiling |
| `{compiler}` | Compiler used when compiling |
| `{libc}` | Libc used when compiling |

### Vulkan

Print the highest Vulkan version supported by the GPU

**Category:** Graphics APIs · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s vulkan
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{driver}` | Driver name |
| `{api-version}` | API version |
| `{conformance-version}` | Conformance version |
| `{instance-version}` | Instance version |

### Wallpaper

Print the file path of the current wallpaper

**Category:** Desktop & theme · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s wallpaper
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{file-name}` | File name |
| `{full-path}` | Full path |

### Weather

Print weather information

**Category:** Network & media · **In default output:** no · **Detection code for:** none

Makes a network request to `wttr.in` over HTTP. Only runs if you add it to your config.

```bash
fastfetch -s weather
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{result}` | Weather result |

Options:

| Option | Meaning |
| --- | --- |
| `location` | Location to display Must be URI-encoded (for example, spaces must be encoded as `+`) |
| `timeout` | Time in milliseconds to wait for the weather server to respond. 0 to disable timeout Default: `0` |
| `outputFormat` | Weather output format to use (must be URI-encoded) Default: `"%t+-+%C+(%l)"` |

### Wifi

Print connected Wi-Fi info (SSID, connection and security protocol)

**Category:** Network & media · **In default output:** no · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku

```bash
fastfetch -s wifi
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{inf-desc}` | Interface description |
| `{inf-status}` | Interface status |
| `{status}` | Connection status |
| `{ssid}` | Connection SSID |
| `{bssid}` | Connection BSSID |
| `{protocol}` | Connection protocol |
| `{signal-quality}` | Connection signal quality (percentage num) |
| `{rx-rate}` | Connection RX rate |
| `{tx-rate}` | Connection TX rate |
| `{security}` | Connection Security algorithm |
| `{signal-quality-bar}` | Connection signal quality (percentage bar) |
| `{channel}` | Connection channel number |
| `{channel-width}` | Connection channel width in MHz |
| `{band}` | Connection channel band in GHz |

### WM

Print the window manager name and version

**Category:** Desktop & theme · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s wm
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{process-name}` | WM process name |
| `{pretty-name}` | WM pretty name |
| `{protocol-name}` | WM protocol name |
| `{plugin-name}` | WM plugin name |
| `{version}` | WM version |

Options:

| Option | Meaning |
| --- | --- |
| `detectPlugin` | Whether to detect the window manager plugin on supported platforms Default: `true` |

### WMTheme

Print the current window manager theme

**Category:** Desktop & theme · **In default output:** yes · **Detection code for:** Linux, macOS, Windows, FreeBSD, NetBSD, OpenBSD, Android, illumos/Solaris, Haiku, GNU Hurd

```bash
fastfetch -s wmtheme
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{result}` | WM theme |

### Zpool

Print ZFS storage pools

**Category:** Hardware · **In default output:** no · **Detection code for:** none

Reads ZFS pools through libzfs; it reports an error on systems without ZFS.

```bash
fastfetch -s zpool
```

Placeholders:

| Placeholder | Meaning |
| --- | --- |
| `{name}` | Zpool name \* |
| `{guid}` | Zpool guid \* |
| `{state}` | Zpool state |
| `{size-used}` | Size used |
| `{size-allocated}` | Size allocated |
| `{size-total}` | Size total |
| `{used-percentage}` | Size used percentage num |
| `{allocated-percentage}` | Size allocated percentage num |
| `{frag-percentage}` | Fragmentation percentage num |
| `{used-percentage-bar}` | Size used percentage bar |
| `{allocated-percentage-bar}` | Size allocated percentage bar |
| `{frag-percentage-bar}` | Fragmentation percentage bar |
| `{is-readonly}` | Is read-only |

## What the default output shows

With no config file, fastfetch 2.71.0 runs these 29 modules, in this order (from `DEFAULT_STRUCTURE` in `CMakeLists.txt`):

*default structure*

```text
Title:Separator:OS:Host:Kernel:Uptime:Packages:Shell:Display:DE:WM:WMTheme:Theme:Icons:Font:Cursor:Terminal:TerminalFont:CPU:GPU:Memory:Swap:Disk:LocalIp:Battery:PowerAdapter:Locale:Break:Colors
```

A module that finds nothing (no battery on a desktop, no desktop environment over SSH) is skipped silently. Add `--show-errors` to see why.

## Get any module's raw data as JSON

Every module can print machine-readable output. This is the reliable way to read fastfetch from scripts; don't parse the colored text:

```bash
fastfetch -s cpu:memory --format json
```

The result is a JSON array with one object per module, holding a `type` and either a `result` or an `error`. More in the [JSON output reference](/doc/#json).

---

Contact: hello@fastfetch.dev · Official project: https://github.com/fastfetch-cli/fastfetch
