onefetch - Man Page
Command-line Git information tool
Examples (TL;DR)
- Display statistics for the Git repository in the current working directory:
onefetch - Display statistics for the Git repository in the specified directory:
onefetch path/to/directory - Ignore commits made by bots:
onefetch --no-bots - Ignore merge commits:
onefetch --no-merges - Don't print the ASCII art of the language logo:
onefetch --no-art - Show
nauthors, languages, or file churns (default: 3, 6, and 3 respectively):onefetch --number-of-authors|languages|file-churns n - Ignore the specified files and directories:
onefetch -e|--exclude path/to/file_or_directory|regular_expression - Only detect languages from the specified categories (default: programming and markup):
onefetch -T|--type programming|markup|prose|data
Synopsis
onefetch [Options] [INPUT]
Description
Command-line Git information tool
Arguments
[INPUT]
Run as if onefetch was started in <input> instead of the current working directory
Options
- -h, --help
- Print help (see a summary with '-h')
- -V, --version
- Print version
Info
-d, --disabled-fields <FIELD>...
Allows you to disable FIELD(s) from appearing in the output
--no-title
Hides the title
--number-of-authors <NUM>
Maximum NUM of authors to be shown
[default: 3]
--number-of-languages <NUM>
Maximum NUM of languages to be shown
[default: 6]
--number-of-file-churns <NUM>
Maximum NUM of file churns to be shown
[default: 3]
--churn-pool-size <NUM>
Minimum NUM of commits from HEAD used to compute the churn summary
By default, the actual value is non-deterministic due to time-based computation and will be displayed under the info title "Churn (NUM)"
- -e, --exclude <EXCLUDE>...
Ignore all files & directories matching EXCLUDE
- --no-bots[=<REGEX>]
Exclude [bot] commits. Use <REGEX> to override the default pattern
- --no-merges
Ignores merge commits
- -E, --email
Show the email address of each author
- --http-url
Display repository URL as HTTP
- --hide-token
Hide token in repository URL
- --include-hidden
Count hidden files and directories
- -T, --type <TYPE>...
Filters output by language type
[default: programming markup] [possible values: programming, markup, prose, data]
Text Formatting
-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'
-z, --iso-time
Use ISO 8601 formatted timestamps
--number-separator <SEPARATOR>
Which thousands SEPARATOR to use
[default: plain] [possible values: plain, comma, space, underscore]
--no-bold
Turns off bold formatting
ASCII
--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)"'
-c, --ascii-colors <X>...
Colors (X X X...) to print the ascii art
-a, --ascii-language <LANGUAGE>
Which LANGUAGE's ascii art to print
--true-color <WHEN>
Specify when to use true color
If set to auto: true color will be enabled if supported by the terminal
[default: auto] [possible values: auto, never, always]
Image
-i, --image <IMAGE>
Path to the IMAGE file
--image-protocol <PROTOCOL>
Which image PROTOCOL to use
[possible values: kitty, sixel, iterm]
--color-resolution <VALUE>
VALUE of color resolution to use with SIXEL backend
[default: 16] [possible values: 16, 32, 64, 128, 256]
Visuals
--no-color-palette
Hides the color palette
--no-art
Hides the ascii art or image if provided
--nerd-fonts
Use Nerd Font icons
Replaces language chips with Nerd Font icons
Developer
-o, --output <FORMAT>
Outputs Onefetch in a specific format
[possible values: json, yaml]
--generate <SHELL>
If provided, outputs the completion file for given SHELL
[possible values: bash, elvish, fish, powershell, zsh]
Other
-l, --languages
Prints out supported languages
-p, --package-managers
Prints out supported package managers