Skip to content

Command line options

Ossama Hjaji edited this page Jul 9, 2021 · 15 revisions
USAGE:
      onefetch [OPTIONS] [--] [input]

OPTIONS:
-o, --output <output>

      Outputs Onefetch in a specific format (json, yaml).

-l, --languages

      Prints out supported languages.

-p, --package-managers

      Prints out supported package managers.

--show-logo <WHEN>

      Specify when to show the logo (auto, never, *always*).  If set to auto: the logo will be hidden if the terminal's width < 95.

-i, --image <IMAGE>

      Path to the IMAGE file.

--image-backend <BACKEND>

      Which image BACKEND to use.

--color-resolution <VALUE>

      VALUE of color resolution to use with SIXEL backend.

-a, --ascii-language <LANGUAGE>

      Which LANGUAGE's ascii art to print.

--ascii-input <STRING>

      Takes a non-empty STRING as input to replace the ASCII logo. It is possible to pass a generated STRING by command substitution.  For example:

      '--ascii-input "$(fortune | cowsay -W 25)"'

--true-color <WHEN>

      Specify when to use true color (*auto*, never, always).  If set to auto: true color will be enabled if supported by the terminal.

-c, --ascii-colors <X>...

      Colors (X X X...) to print the ascii art.

-t, --text-colors <X>...

      Changes the text colors (X X X...). Goes in order of title, ~, underline, subtitle, colon, and info.  For example:

      '--text-colors 9 10 11 12 13 14'

--no-bold

      Turns off bold formatting.

--no-palette

      Hides the color palette.

--no-merges

      Ignores merge commits.

--no-bots <REGEX>

      Exclude [bot] commits. Use <REGEX> to override the default pattern.

-z, --isotime

      Use ISO 8601 formatted timestamps.

-d, --disable-fields <FIELD>...

      Allows you to disable FIELD(s) from appearing in the output.

-A, --authors-number <NUM>

      NUM of authors to be shown. [default: 3]

-E, --show-email

      show the email address of each author.

-e, --exclude <EXCLUDE>...

      Ignore all files & directories matching EXCLUDE.

-h, --help

      Prints help information

-V, --version

      Prints version information

ARGS:
      <input>

      Run as if onefetch was started in <input> instead of the current working directory.
Clone this wiki locally