bash-prompt-generator - GitLite

KO | EN

gitlite — search

#golang #go #android #rust #deep-learning #linux #macos #java #awesome #kubernetes #vue #security #pytorch #ios

bash-prompt-generator

(★ 860)

Customize your Bash Prompt by setting the PS1 variable.

File Explorer

Download Latest Version (.zip)

- - bug.yml
  - feature.yml
  - question.yml
- - lint.yml
  - vuedeploy.yml
- PULL_REQUEST_TEMPLATE.md
- bash_echo_ps1.png
- bash_prompt_example.png
- bash_prompt_generator_colors.png
- bash_prompt_generator_initial.png
- bash_prompt_generator_output.png
- bash_prompt_generator_properties.png
- bash_prompt_generator_selected.png
- bash_prompt_generator_your_prompt.png
- generate-your-prompt.svg
- bash_prompt_generator_og.png
- bash_prompt_generator_twitter.png
- favicon.png
- index.html
- - SiteHeader.vue
- - darkMode.ts
  - prompt.ts
  - promptElement.ts
  - promptElementProperties.ts
  - promptParser.ts
- App.vue
- main.ts
- shims-vue.d.ts
.browserslistrc
.editorconfig
.eslintrc.js
.gitignore
.prettierrc
babel.config.js
CONTRIBUTING.md
LICENSE
package-lock.json
package.json
README.md
tsconfig.json
vue.config.js

# Installation Guide

1. Get the code

git clone https://github.com/Scriptim/bash-prompt-generator

Downloads the entire project code from GitHub to your computer.

cd bash-prompt-generator

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install

Downloads and installs the libraries listed in package.json.

npm start

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Bash Prompt Generator

**Create a custom PS1 variable for your Bash.**

[![github-stars](https://img.shields.io/github/stars/Scriptim/bash-prompt-generator?style=social)](https://github.com/Scriptim/bash-prompt-generator/stargazers "Stargazers")
&emsp;
[![github-forks](https://img.shields.io/github/forks/Scriptim/bash-prompt-generator?style=social)](https://github.com/Scriptim/bash-prompt-generator/fork "Forks")

[![generate-your-prompt](https://raw.githubusercontent.com/Scriptim/bash-prompt-generator/master/docs/generate-your-prompt.svg)](https://bash-prompt-generator.org "Check it out")

## What is a Bash  Prompt?

The prompt is a short piece of text that is displayed in the Bash shell prompting you to enter a command.

![Bash Prompt Example](https://raw.githubusercontent.com/Scriptim/bash-prompt-generator/master/docs/bash_prompt_example.png)

It usually contains some useful information about the current user, the working directory, etc.

## Where is the Prompt Configured?

The `PS1` environment variable determines what information the prompt contains and how it is displayed.

![Echo $PS1](https://raw.githubusercontent.com/Scriptim/bash-prompt-generator/master/docs/bash_echo_ps1.png)

The default value may vary between different distributions and versions.

Setting the `PS1` variable yourself (e.&nbsp;g. by appending the line `PS1='[\u@\h \w]\$ '` to your `~/.bashrc` file) allows you to customize your prompt.

## How is the Prompt Configured?

The syntax of the `PS1` variable allows versatile customization options.
In addition to the information displayed, colors as well as other display attributes can be adjusted.

However, this syntax is difficult to read by humans and manual customization is therefore extremely tedious.

For this reason, this project provides a way to create a prompt via a GUI without having to modify the PS1 variable itself.

### See also

- [GNU Bash Manual: Controlling the Prompt](https://www.gnu.org/software/bash/manual/html_node/Controlling-the-Prompt.html)
- [ArchWiki: Bash/Prompt customization](https://wiki.archlinux.org/index.php/Bash/Prompt_customization)

## How to Use

### Getting Started

When you visit the [website](https://bash-prompt-generator.org) for the first time, you have the option to either create a new prompt from scratch or import your current prompt for adjustment.

![Website First View](https://raw.githubusercontent.com/Scriptim/bash-prompt-generator/master/docs/bash_prompt_generator_initial.png)

A prompt consists of multiple so-called *elements*.
You can click on one of the elements on the left (*Prompt Elements*) to add it to your prompt.
If you choose to import your existing prompt, paste the output of `echo $PS1` (e.&nbsp;g. `[\u@\h \w]\$ `) into the text field and the according elements will be automatically added to your prompt.

### Your Prompt

The *Your Prompt* section lists all elements that are currently part of your prompt.

![Your Prompt](https://raw.githubusercontent.com/Scriptim/bash-prompt-generator/master/docs/bash_prompt_generator_your_prompt.png)

You can always add more elements from the *Prompt Elements* section on the left, reorder the elements in your prompt using drag and drop or remove them.

The trash icon will remove all elements from your prompt, letting you start from scratch.

The command for setting the `PS1` variable is displayed in the *Output* section, along with an example preview of how your prompt might look like.

![Output](https://raw.githubusercontent.com/Scriptim/bash-prompt-generator/master/docs/bash_prompt_generator_output.png)

The clipboard icon will copy the full command to your clipboard.

If you run the generated command in your terminal, you will immediately see the changes to your prompt.
These changes will be lost when you close your terminal, however.
In order to make the changes permanent, you have to add the command to your `~/.bashrc` file.

Note that the preview will most likely differ from the actual prompt in your terminal because the environment (such as the current user, hostname, etc.) is different.

You can click on the lightbulb icon to toggle between a dark and a light background for the preview.

### Properties

All elements can be selected by clicking on them.

![Selected](https://raw.githubusercontent.com/Scriptim/bash-prompt-generator/master/docs/bash_prompt_generator_selected.png)

Depending on the type of the selected element, different properties can be adjusted.

![Properties](https://raw.githubusercontent.com/Scriptim/bash-prompt-generator/master/docs/bash_prompt_generator_properties.png)

Most elements support colors and various display attributes.

Look at the example preview to see how these properties affect the prompt.

Foreground and background colors can be choosen via a color picker.

![Color Picker](https://raw.githubusercontent.com/Scriptim/bash-prompt-generator/master/docs/bash_prompt_generator_colors.png)

The color picker provides a *no color* option for resetting to the default color, 16 4-bit colors (top row) and 256 8-bit colors (bottom rows).

Note that some terminals may not support all colors.
The same applies to display attributes.

Additionally, you can duplicate the selected element with the copy icon under *Actions*.

#### Special Elements

Some element types have special properties:

* *Date (formatted)* requires a string specifying the date format which will be passed to [`strftime(3)`](https://linux.die.net/man/3/strftime "man 3 strftime").
* *Command* requires a string specifying the command to be executed.
The prompt will contain the standard output of the command.
  * The *Git Branch* and *IP Address* elements are functionally equivalent to a *Command* element with the command already filled in.
* *Text* requires an arbitrary string that will be included as is in the prompt.
* *Environment Variable* requires the name of an environment variable and configuring the [parameter expansion](https://www.gnu.org/software/bash/manual/html_node/Shell-Parameter-Expansion.html "GNU Bash Manual: Shell Parameter Expansion").
* *Nerd Font Glyph* requires the class name of a [Nerd Font glyph](https://www.nerdfonts.com/cheat-sheet "Nerd Fonts Cheat Sheet").

## License

Copyright (C) 2017 - 2025 Scriptim

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a [copy of the GNU General Public License](./LICENSE) along with this program.  If not, see <https://www.gnu.org/licenses/>.