2020-05-05 13:07:34 -04:00
# Presets
Here is a collection of community-submitted configuration presets for Starship. If you have a preset to share, please [submit a PR ](https://github.com/starship/starship/edit/master/docs/presets/README.md ) updating this file! 😊
## Nerd Font Symbols
This preset doesn't change anything except for the symbols used for each module. If emojis aren't your thing, this might catch your eye!

### Prerequisites
- A [Nerd Font ](https://www.nerdfonts.com/ ) installed and enabled in your terminal (the example uses Fira Code Nerd Font)
### Configuration
``` toml
[ aws ]
2021-03-15 13:18:42 -04:00
symbol = " "
2020-05-05 13:07:34 -04:00
[ conda ]
symbol = " "
2020-09-30 16:26:13 -04:00
[ dart ]
symbol = " "
2021-01-03 03:56:07 -05:00
[ directory ]
read_only = " "
2021-04-05 10:55:57 -04:00
[ docker_context ]
2020-05-05 13:07:34 -04:00
symbol = " "
[ elixir ]
symbol = " "
[ elm ]
symbol = " "
[ git_branch ]
symbol = " "
[ golang ]
symbol = " "
[ hg_branch ]
symbol = " "
[ java ]
symbol = " "
[ julia ]
symbol = " "
[ memory_usage ]
symbol = " "
2020-06-10 21:28:04 -04:00
[ nim ]
symbol = " "
2020-05-05 13:07:34 -04:00
[ nix_shell ]
symbol = " "
[ package ]
symbol = " "
2020-09-30 16:26:13 -04:00
[ perl ]
symbol = " "
2020-05-05 13:07:34 -04:00
[ php ]
symbol = " "
[ python ]
symbol = " "
[ ruby ]
symbol = " "
[ rust ]
2020-11-28 23:45:59 -05:00
symbol = " "
2020-09-30 16:26:13 -04:00
2021-03-15 13:18:42 -04:00
[ scala ]
symbol = " "
2021-06-20 14:10:36 -04:00
[ shlvl ]
symbol = " "
2020-09-30 16:26:13 -04:00
[ swift ]
symbol = "ﯣ "
2020-05-05 13:07:34 -04:00
```
2021-06-20 14:10:36 -04:00
## Bracketed Segments
This preset changes the format of all the built-in modules to show their segment in brackets instead of using the default Starship wording ("via", "on", etc.).
Before:

After:

### Configuration
``` toml
[ aws ]
format = '\[[$symbol($profile)(\($region\))(\[$duration\])]($style)\]'
[ cmake ]
format = '\[[$symbol($version)]($style)\]'
[ cmd_duration ]
2021-08-14 09:24:51 -04:00
format = '\[[⏱ $duration ]($style)\]'
2021-06-20 14:10:36 -04:00
2021-09-21 09:36:29 -04:00
[ cobol ]
format = '\[[$symbol($version)]($style)\]'
2021-06-20 14:10:36 -04:00
[ conda ]
format = '\[[$symbol$environment]($style)\]'
[ crystal ]
format = '\[[$symbol($version)]($style)\]'
[ dart ]
format = '\[[$symbol($version)]($style)\]'
[ deno ]
format = '\[[$symbol($version)]($style)\]'
[ docker_context ]
format = '\[[$symbol$context]($style)\]'
[ dotnet ]
format = '\[[$symbol($version)(🎯 $tfm)]($style)\]'
[ elixir ]
format = '\[[$symbol($version \(OTP $otp_version\))]($style)\]'
[ elm ]
format = '\[[$symbol($version)]($style)\]'
[ erlang ]
format = '\[[$symbol($version)]($style)\]'
[ gcloud ]
format = '\[[$symbol$account(@$domain)(\($region\))]($style)\]'
[ git_branch ]
format = '\[[$symbol$branch]($style)\]'
[ git_status ]
format = '([\[$all_status$ahead_behind\]]($style))'
[ golang ]
format = '\[[$symbol($version)]($style)\]'
[ helm ]
format = '\[[$symbol($version)]($style)\]'
[ hg_branch ]
format = '\[[$symbol$branch]($style)\]'
[ java ]
format = '\[[$symbol($version)]($style)\]'
[ julia ]
format = '\[[$symbol($version)]($style)\]'
[ kotlin ]
format = '\[[$symbol($version)]($style)\]'
[ kubernetes ]
format = '\[[$symbol$context( \($namespace\))]($style)\]'
[ lua ]
format = '\[[$symbol($version)]($style)\]'
[ memory_usage ]
format = '\[$symbol[$ram( | $swap)]($style)\]'
[ nim ]
format = '\[[$symbol($version)]($style)\]'
[ nix_shell ]
format = '\[[$symbol$state( \($name\))]($style)\]'
[ nodejs ]
format = '\[[$symbol($version)]($style)\]'
[ ocaml ]
format = '\[[$symbol($version)(\($switch_indicator$switch_name\))]($style)\]'
[ openstack ]
format = '\[[$symbol$cloud(\($project\))]($style)\]'
[ package ]
format = '\[[$symbol$version]($style)\]'
[ perl ]
format = '\[[$symbol($version)]($style)\]'
[ php ]
format = '\[[$symbol($version)]($style)\]'
[ purescript ]
format = '\[[$symbol($version)]($style)\]'
[ python ]
format = '\[[${symbol}${pyenv_prefix}(${version})(\($virtualenv\))]($style)\]'
[ red ]
format = '\[[$symbol($version)]($style)\]'
[ ruby ]
format = '\[[$symbol($version)]($style)\]'
[ rust ]
format = '\[[$symbol($version)]($style)\]'
[ scala ]
format = '\[[$symbol($version)]($style)\]'
[ swift ]
format = '\[[$symbol($version)]($style)\]'
[ terraform ]
format = '\[[$symbol$workspace]($style)\]'
[ time ]
format = '\[[$time]($style)\]'
[ username ]
format = '\[[$user]($style)\]'
[ vagrant ]
format = '\[[$symbol($version)]($style)\]'
[ vlang ]
format = '\[[$symbol($version)]($style)\]'
[ zig ]
format = '\[[$symbol($version)]($style)\]'
```
## Plain Text Symbols
This preset changes the symbols into plain text. If your terminal/font could not render the NerdFonts/emojis, maybe you could try this preset!
Before (default setting with Fixedsys font):

After (Plain Text Symbols):

### Configuration
``` toml
[ character ]
success_symbol = "[>](bold green)"
error_symbol = "[x](bold red)"
vicmd_symbol = "[<](bold green)"
[ git_commit ]
tag_symbol = " tag "
[ git_status ]
ahead = ">"
behind = "<"
diverged = "<>"
renamed = "r"
deleted = "x"
[ aws ]
symbol = "aws "
2021-09-21 09:36:29 -04:00
[ cobol ]
symbol = "cobol "
2021-06-20 14:10:36 -04:00
[ conda ]
symbol = "conda "
[ crystal ]
symbol = "cr "
[ cmake ]
symbol = "cmake "
[ dart ]
symbol = "dart "
[ deno ]
symbol = "deno "
[ dotnet ]
symbol = ".NET "
[ directory ]
read_only = " ro"
[ docker_context ]
symbol = "docker "
[ elixir ]
symbol = "exs "
[ elm ]
symbol = "elm "
[ git_branch ]
symbol = "git "
[ golang ]
symbol = "go "
[ hg_branch ]
symbol = "hg "
[ java ]
symbol = "java "
[ julia ]
symbol = "jl "
[ kotlin ]
symbol = "kt "
[ nodejs ]
symbol = "nodejs "
[ memory_usage ]
symbol = "memory "
[ nim ]
symbol = "nim "
[ nix_shell ]
symbol = "nix "
[ ocaml ]
symbol = "ml "
[ package ]
symbol = "pkg "
[ perl ]
symbol = "pl "
[ php ]
symbol = "php "
[ purescript ]
symbol = "purs "
[ python ]
symbol = "py "
[ ruby ]
symbol = "rb "
[ rust ]
symbol = "rs "
[ scala ]
symbol = "scala "
[ swift ]
symbol = "swift "
```
2021-08-14 09:24:51 -04:00
## Hide Runtime Versions
This preset hides the version of language runtimes. If you work in containers or virtualized environments, this one is for you!

### Configuration
``` toml
[ cmake ]
format = "via [$symbol]($style)"
2021-09-21 09:36:29 -04:00
[ cobol ]
format = "via [$symbol]($style)"
2021-08-14 09:24:51 -04:00
[ crystal ]
format = "via [$symbol]($style)"
[ dart ]
format = "via [$symbol]($style)"
[ deno ]
format = "via [$symbol]($style)"
[ dotnet ]
format = "[$symbol(🎯 $tfm )]($style)"
[ elixir ]
format = 'via [$symbol]($style)'
[ elm ]
format = 'via [$symbol]($style)'
[ erlang ]
format = 'via [$symbol]($style)'
[ golang ]
format = 'via [$symbol]($style)'
[ helm ]
format = 'via [$symbol]($style)'
[ julia ]
format = 'via [$symbol]($style)'
[ kotlin ]
format = 'via [$symbol]($style)'
[ lua ]
format = 'via [$symbol]($style)'
[ nim ]
format = 'via [$symbol]($style)'
[ nodejs ]
format = 'via [$symbol]($style)'
[ ocaml ]
format = 'via [$symbol(\($switch_indicator$switch_name\) )]($style)'
[ perl ]
format = 'via [$symbol]($style)'
[ php ]
format = 'via [$symbol]($style)'
[ purescript ]
format = 'via [$symbol]($style)'
[ red ]
format = 'via [$symbol]($style)'
[ rlang ]
format = 'via [$symbol]($style)'
[ ruby ]
format = 'via [$symbol]($style)'
[ rust ]
format = 'via [$symbol]($style)'
[ swift ]
format = 'via [$symbol]($style)'
[ vagrant ]
format = 'via [$symbol]($style)'
[ vlang ]
format = 'via [$symbol]($style)'
[ zig ]
format = 'via [$symbol]($style)'
```