27 KiB
Site web
·
Installation
·
Configuration
Starship is the minimal, blazing fast, and extremely customizable prompt for any shell!
The prompt shows information you need while you're working, while staying sleek and out of the way.
🍬 Fonctionnalités
- Le symbole de prompt devient rouge si la dernière commande a retournée un code différent de zéro
- Affiche le nom de l'utilisateur courant s'il est différent de celui connecté
- Version actuelle de Java (
☕
) - Version actuelle de Node.js (
⬢
) - Version actuelle de Rust (
🦀
) - Version actuelle de Ruby (
💎
) - Version actuelle de Python (
🐍
) - Version actuelle de Go (
🐹
) - Détection de l'environnement Nix-shell
- Affiche une variable d'environnement
- Version actuelle du paquet dans le répertoire courant (
📦
)- npm (Node.js)
- cargo (Rust)
- poetry (Python)
- Niveau et état actuels de la batterie
- Branche Git actuelle et affichage "riche" du statut du dépôt:
=
— Conflits dans les changements⇡
— En avance sur la branche distante⇣
— En retard sur la branche distante⇕
— Changements divergeant?
— Changements non-suivis$
— Changements remisés!
— Fichiers modifiés+
— Fichiers ajoutés»
— Fichiers renommés✘
— Fichiers supprimés
- Temps d'exécution de la dernière commande si elle a excédée la limite
- Indicateur pour les tâches en arrière-plan (
✦
) - Cluster et namespace Kubernetes actuels (
☸
) - Current AWS profile (
☁️
)
🚀 Installation
Pré-requis
- Une police d'écriture Powerline installée et activée dans votre terminal (Par exemple, essayez Fira Code).
Getting Started
-
Install the starship binary:
Download archives of precompiled binaries if you don't use the platforms below.
Homebrew
$ brew install starship
Rust (v1.38 or higher)
$ cargo install starship
Arch Linux (AUR)
Starship is available on the AUR under the name
starship
. Install it withyay
or your favorite AUR helper.$ yay -S starship
Nix (unstable)
$ nix-env --install starship
Termux
$ pkg install starship
Other x86-64 Linux Platforms
Download a prebuilt binary and place in /usr/local/bin/
$ wget -q --show-progress https://github.com/starship/starship/releases/latest/download/starship-x86_64-unknown-linux-gnu.tar.gz $ tar xvf starship-x86_64-unknown-linux-gnu.tar.gz $ sudo mv starship /usr/local/bin/
-
Add the init script to your shell's config file:
Bash
Add the following to the end of
~/.bashrc
:# ~/.bashrc eval "$(starship init bash)"
Fish
Add the following to the end of
~/.config/fish/config.fish
:# ~/.config/fish/config.fish eval (starship init fish)
Zsh
Add the following to the end of
~/.zshrc
:# ~/.zshrc eval "$(starship init zsh)"
Powershell
Add the following to the end of
~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
(or~/.config/powershell/Microsoft.PowerShell_profile.ps1
on -Nix):# ~\Documents\PowerShell\Profile.ps1 Invoke-Expression (&starship init powershell)
🔧 Configuration
For details on how to configure Starship, check out our documentation.
🤝 Contributing
We are always looking for contributors of all skill levels! If you're looking to ease your way into the project, try out a good first issue.
High Priority Needs
- 👩💼 Product Manager
- We have a GitHub Project and many unorganized/unprioritized features, as well as ideas that haven't yet been made into issues. Starship needs someone to own the product direction!
- 👩🎨 Designer
- Like making eye-catching websites? Excellent! We are looking to create a beautiful landing page showing off Starship in all its glory. Helping design for Starship's brand is a great opportunity to try out new ideas!
- 👩💻 Rust Developer
- There is a lot of low-hanging fruit when it comes to writing idiomatic Rust, designing effective Rust architecture, performance optimizations, cross-platform build optimizations, and more! I (@matchai) am a beginner to Rust. Come point us in the right direction!
If you are interested in helping contribute to starship, please take a look at our Contributing Guide. Also, feel free to drop into our Discord server and say hi. 👋
Contributors
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
💭 Inspired By
Please check out these previous works that helped inspire the creation of starship. 🙏
-
denysdovhan/spaceship-prompt - A ZSH prompt for astronauts.
-
denysdovhan/robbyrussell-node - Cross-shell robbyrussell theme written in JavaScript.
-
reujab/silver - A cross-shell customizable powerline-like prompt with icons.
📝 License
Copyright © 2019-present, Starship Contributors.
This project is ISC licensed.