Site
·
Instalação
·
Configuração
**O prompt minimalista, extremamente rápido e infinitamente personalizável para qualquer shell!**
- **Rápido:** É rápido – _muito muito_ rápido! 🚀
- **Personalizável:** Configure todos os detalhes do seu prompt.
- **Universal:** Funciona em qualquer shell, em qualquer sistema operacional.
- **Inteligente:** Mostra informações relevantes rapidamente.
- **Muitos recursos:** Suporte para todas as suas ferramentas favoritas.
- **Fácil:**Instalação rápida – comece a usar em minutos.
Consulte a documentação ▶
## 🚀 Instalação
### Pré-requisitos
- Uma [Nerd Font](https://www.nerdfonts.com/) instalada e ativa em seu terminal (por exemplo, tente a [ FiraCode Nerd Font](https://www.nerdfonts.com/font-downloads)).
### 1º passo. Instalar o Starship
Selecione seu sistema operacional na lista abaixo para ver as instruções de instalação:
Android
Instale o Starship usando qualquer um dos seguintes gerenciadores de pacotes:
| Repositório | Instruções |
| --------------------------------------------------------------------------------- | ---------------------- |
| [Termux](https://github.com/termux/termux-packages/tree/master/packages/starship) | `pkg install starship` |
BSD
Instale o Starship usando qualquer um dos seguintes gerenciadores de pacotes:
| Distribuição | Repositório | Instruções |
| -------------- | -------------------------------------------------------- | --------------------------------- |
| **_Qualquer_** | **[crates.io](https://crates.io/crates/starship)** | `cargo install starship --locked` |
| FreeBSD | [FreshPorts](https://www.freshports.org/shells/starship) | `pkg install starship` |
| NetBSD | [pkgsrc](https://pkgsrc.se/shells/starship) | `pkgin install starship` |
Linux
Instale a versão mais recente no seu sistema:
```sh
curl -sS https://starship.rs/install.sh | sh
```
Ou instale o Starship usando qualquer um dos seguintes gerenciadores de pacotes:
| Distribuição | Repositório | Instruções |
| ------------------ | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **_Qualquer_** | **[crates.io](https://crates.io/crates/starship)** | `cargo install starship --locked` |
| _Qualquer_ | [conda-forge](https://anaconda.org/conda-forge/starship) | `conda install -c conda-forge starship` |
| _Qualquer_ | [Linuxbrew](https://formulae.brew.sh/formula/starship) | `brew install starship` |
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship`
`dnf install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
macOS
Instale a versão mais recente no seu sistema:
```sh
curl -sS https://starship.rs/install.sh | sh
```
Ou instale o Starship usando qualquer um dos seguintes gerenciadores de pacotes:
| Repositório | Instruções |
| -------------------------------------------------------- | --------------------------------------- |
| **[crates.io](https://crates.io/crates/starship)** | `cargo install starship --locked` |
| [conda-forge](https://anaconda.org/conda-forge/starship) | `conda install -c conda-forge starship` |
| [Homebrew](https://formulae.brew.sh/formula/starship) | `brew install starship` |
| [MacPorts](https://ports.macports.org/port/starship) | `port install starship` |
Windows
Instale a ultima versão para o seu sistema usando MSI-installer a partir da [seção de lançamentos](https://github.com/starship/starship/releases/latest).
Instale o Starship usando qualquer um dos seguintes gerenciadores de pacotes:
| Repositório | Instruções |
| -------------------------------------------------------------------------------------------- | --------------------------------------- |
| **[crates.io](https://crates.io/crates/starship)** | `cargo install starship --locked` |
| [Chocolatey](https://community.chocolatey.org/packages/starship) | `choco install starship` |
| [conda-forge](https://anaconda.org/conda-forge/starship) | `conda install -c conda-forge starship` |
| [Scoop](https://github.com/ScoopInstaller/Main/blob/master/bucket/starship.json) | `scoop install starship` |
| [winget](https://github.com/microsoft/winget-pkgs/tree/master/manifests/s/Starship/Starship) | `winget install --id Starship.Starship` |
### 2º passo. Configure seu shell para usar Starship
Configure seu shell para inicializar o starship. Selecione o seu na lista abaixo:
Bash
Adicione o seguinte comando no final do arquivo `~/.bashrc`:
```sh
eval "$(starship init bash)"
```
Cmd
Você precisa do [Clink](https://chrisant996.github.io/clink/clink.html) (v1.2.30+) com Cmd. Crie um arquivo neste caminho `%LocalAppData%\clink\starship.lua` com o seguinte conteúdo:
```lua
load(io.popen('starship init cmd'):read("*a"))()
```
Elvish
Adicione o comando a seguir ao final do arquivo `~/.elvish/rc.elv`:
```sh
eval (starship init elvish)
```
Nota: Somente Elvish v0.18+ é suportado
Fish
Adicione o seguinte comando no final do arquivo `~/.config/fish/config.fish`:
```fish
starship init fish | source
```
Ion
Adicione o seguinte comando no final do arquivo `~/.config/ion/initrc`:
```sh
eval $(starship init ion)
```
Nushell
Adicione o seguinte ao final do seu arquivo env do Nushell (enconte-o rodando `$nu.env-path` no Nushell):
```sh
mkdir ~/.cache/starship
starship init nu | save -f ~/.cache/starship/init.nu
```
E adicione o seguinte ao final da sua configuração do Nushell (encontre-o executando `$nu.config-path`):
```sh
use ~/.cache/starship/init.nu
```
Nota: Somente o Nushell v0.78+ é suportado
PowerShell
Adicione o seguinte no final da sua configuração PowerShell (encontre executando `$PROFILE`):
```powershell
Invoke-Expression (&starship init powershell)
```
Tcsh
Adicione ao final do arquivo `~/.tcshrc`:
```sh
eval `starship init tcsh`
```
Xonsh
Adicione o seguinte ao final do arquivo `~/.xonshrc`:
```python
execx($(starship init xonsh))
```
Zsh
Adicione o seguinte comando no final do arquivo `~/.zshrc`:
```sh
eval "$(starship init zsh)"
```
### 3º passo. Configurar o Starship
Inicie uma nova instância de shell e você deverá ver seu belo novo prompt de shell. Se você estiver feliz com as configurações padrões, aproveite!
Se você estiver procurando personalizar ainda mais a Starship:
- **[Configuração](https://starship.rs/config/)** – saiba como configurar o Starship para ajustar seu prompt ao seu gosto
- **[Predefinições](https://starship.rs/presets/)** - seja inspirado nas configurações pré-construídas pelos outros
## 🤝 Contribuindo
Nós estamos sempre procurando contribuidores de **todos os níveis de conhecimento**! Se você deseja facilitar seu caminho para o projeto, experimente uma [good first issue](https://github.com/starship/starship/labels/🌱%20good%20first%20issue).
Se você é fluente em um idioma diferente do inglês, agradecemos qualquer ajuda para manter nossos documentos traduzidos e atualizados em outros idiomas. Se você quiser ajudar, as traduções podem ser contribuídas no [Crowdin do Starship](https://translate.starship.rs/).
Se você estiver interessado em ajudar a contribuir com starship, dê uma olhada em nosso [Guia de Contribuição](https://github.com/starship/starship/blob/master/CONTRIBUTING.md). Além disso, sinta-se à vontade para entrar no nosso [servidor do Discord](https://discord.gg/8Jzqu3T) e diga oi. 👋
## 💭 Inspirado por
Por favor, confira esses trabalhos anteriores que ajudaram a inspirar a criação do starship. 🙏
- **[denysdovhan/spaceship-prompt](https://github.com/denysdovhan/spaceship-prompt)** – Um prompt ZSH para astronautas.
- **[denysdovhan/robbyrussell-node](https://github.com/denysdovhan/robbyrussell-node)** – Tema robbyrussell para prompt em JavaScript.
- **[reujab/silver](https://github.com/reujab/silver)** – Um prompt personalizável com ícones do tipo powerline.
## ❤️ Patrocinadores
Apoie este projeto [tornando-se um patrocinador](https://github.com/sponsors/starship). O seu nome ou logotipo aparecerá aqui com um link para o seu site.
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
## 📝 Licença
Copyright © 2019-presente, [Colaboradores Starship](https://github.com/starship/starship/graphs/contributors).
Este projeto é licenciado pelo [ISC](https://github.com/starship/starship/blob/master/LICENSE).