Rocketfetch was inspired by neofetch. I wanted to add some performance to
neofetch while also improving the configuration. I modeled my configuration after that of
Starship.
Installation
Using Cargo:
cargo install rocketfetch
If this fails to install, please make sure you have the most recent Rust version installed.
Using Homebrew For MacOSX:
brew install devanlooches/rocketfetch/rocketfetch
Command Line
rocketfetch 0.6.9
A WIP command line system information tool (neofetch) rewritten in rust for performance with toml file configuration.
USAGE:
rocketfetch [FLAGS] [OPTIONS]
FLAGS:
-h, --help Prints help information
--no-line-wrap Disables Line Wrapping
-V, --version Prints version information
OPTIONS:
-c, --config <FILE> Sets custom configuration file.
-m, --mode <mode> Set the printing mode. Can be one of `side-block`, `bottom-block`, or `classic`
Configuration
You can configure rocketfetch either through the default path of ~/.config/rocketfetch or pass a path in cli by
specifying the -c option.
Top Level
Value
Default
Description
module-order
"user delimiter os host kernel uptime packages"
Specify the order in which the modules will go in separated by spaces. Possible modules are: user, delimiter, os, host, kernel, uptime, packages, as well as any custom modules you have defined. You may specify some more than once. More coming soon!
offset
4
Specify the number of spaces between the logo and the information.
wrap-lines
true
Wether or not to wrap the output lines.
logo-cmd
"auto"
The command to run in order to get the logo. If set to auto or nothing, it will automatically detect the operating system and choose a logo based on the result. (Only macos and Arch Linux is supported as of right now.)
Format Header
Value
Default
Description
mode
"classic"
Set the mode of output. Could be one of classic (neofetch style), side-block (with a block around the info), or bottom-block (with the logo above the block of info).
top-left-corner-char
"╭"
Set the character to use as the top left corner of the block (Only works in and bottom-block modes).
top-right-corner-char
"╮"
Set the character to use as the top right corner of the block (Only works in side-block and bottom-block modes).
bottom-left-corner-char
"╰"
Set the character to use as the bottom left corner of the block (Only works in side-block and bottom-block modes).
bottom-right-corner-char
"╯"
Set the character to use as the bottom right corner of the block (Only works in side-block and bottom-block modes).
horizontal-char
"─"
Set the character to use as the top and bottom parts of the block (Only works in side-block and bottom-block modes).
vertical-char
"│"
Set the character to use as the right and left parts of the block (Only works in side-block and bottom-block modes).
padding-left
1
Set the number of spaces to put before each module inside the block (Only works in side-block and bottom-block modes).
padding-right
1
Set the number of spaces to put after each module inside the block (Only works in side-block and bottom-block modes).
padding-top
0
Set the number of lines to put above the modules inside the block (Only works in side-block and bottom-block modes).
User Header
Value
Default
Description
pre-text-style
"bold.yellow"
A format string with each word separated by dots that describes the style of the text that comes before this module
pre-text
""
Text that comes before this module
output-style
"white"
A format string with each word separated by dots that describes the style of the text
separator-style
"white"
A format string with each word separated by dots that describes the style of the between username and hostname
separator-char
"@"
A character that separates between the username and hostname
Delimiter Header
Value
Default
Description
style
"white"
A format string with each word separated by dots that describes the style of the delimiter
repeat-num
0
The number of times to repeat the delimiter char to form the delimiter. If set to 0, it will the repeat number to the length of the module above this one
char
"-"
The character to use as the delimiter
OS Header
Value
Default
Description
pre-text-style
"bold.yellow"
A format string with each word separated by dots that describes the style of the text that comes before this module
pre-text
"OS: "
Text that comes before this module
output-style
"white"
A format string with each word separated by dots that describes the style of the text
Host Header
Value
Default
Description
pre-text-style
"bold.yellow"
A format string with each word separated by dots that describes the style of the text that comes before this module
pre-text
"Host: "
Text that comes before this module
output-style
"white"
A format string with each word separated by dots that describes the style of the output text
Kernel Header
Value
Default
Description
pre-text-style
"bold.yellow"
A format string with each word separated by dots that describes the style of the text that comes before this module
pre-text
"Kernel: "
Text that comes before this module
output-style
"white"
A format string with each word separated by dots that describes the style of the output text
Uptime Header
Value
Default
Description
pre-text-style
"bold.yellow"
A format string with each word separated by dots that describes the style of the text that comes before this module
pre-text
"Uptime: "
Text that comes before this module
output-style
"white"
A format string with each word separated by dots that describes the style of the output text
time-format
"$days days, $hours hours, $minutes minutes"
A String that describes the format of the time. Variables are: $years, $days, $hours, $minutes, $seconds.
Packages Header
Value
Default
Description
pre-text-style
"bold.yellow"
A format string with each word separated by dots that describes the style of the text that comes before this module
pre-text
"Packages: "
Text that comes before this module
output-style
"white"
A format string with each word separated by dots that describes the style of the output text
Shell Header
Value
Default
Description
pre-text-style
"bold.yellow"
A format string with each word separated by dots that describes the style of the text that comes before this module
pre-text
"Shell: "
Text that comes before this module
output-style
"white"
A format string with each word separated by dots that describes the style of the output text
Resolution Header
Value
Default
Description
pre-text-style
"bold.yellow"
A format string with each word separated by dots that describes the style of the text that comes before this module
pre-text
"Resolution: "
Text that comes before this module
output-style
"white"
A format string with each word separated by dots that describes the style of the output text
Desktop Environment Header
Value
Default
Description
pre-text-style
"bold.yellow"
A format string with each word separated by dots that describes the style of the text that comes before this module
pre-text
"Desktop Environment: "
Text that comes before this module
output-style
"white"
A format string with each word separated by dots that describes the style of the output text
Window Manager Header
Value
Default
Description
pre-text-style
"bold.yellow"
A format string with each word separated by dots that describes the style of the text that comes before this module
pre-text
"Window Manager: "
Text that comes before this module
output-style
"white"
A format string with each word separated by dots that describes the style of the output text
Terminal Header
Value
Default
Description
pre-text-style
"bold.yellow"
A format string with each word separated by dots that describes the style of the text that comes before this module
pre-text
"Terminal: "
Text that comes before this module
output-style
"white"
A format string with each word separated by dots that describes the style of the output text
Custom Header
Value
Description
pre-text-style
A format string with each word separated by dots that describes the style of the text that before this module
pre-text
Text that comes before this module
output-style
A format string with each word separated by dots that describes the style of the output text
command
The command to run to get the output of the module
The Tidelift Subscription provides access to a continuously curated stream of human-researched and maintainer-verified data on open source packages and their licenses, releases, vulnerabilities, and development practices.