IlanCosman/tide
1
1
Fork 0
mirror of https://github.com/IlanCosman/tide.git synced 2024-11-24 01:13:13 +03:00
Code Issues Projects Releases Wiki Activity
6fecf14570
tide/README.md
Ilan Cosman 19fbf54c81 Rename media folder to resources
2020-06-17 13:43:54 -07:00

185 lines
9.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🌊 Tide [![release_shield]][releases] [![fish_version_shield]](#System-Requirements) [![license_shield]][license]
Tide is a [Fish] theme inspired by [Powerlevel10k]. It aims to provide a powerful, flexible, and out-of-the-box experience.
![Prompt_Connection]
## Installation
1. Install the [recommended font](#Fonts). _Optional but highly recommended_
2. Source and run the install function:
```fish
curl -sL git.io/tide-fish | source; and tide_install
```
### System Requirements
- [fish] ≥3.1
- [git]
## Features
### Configuration Wizard
Type `tide configure` to open the the wizard in your terminal.
![Configuration_Wizard]
### Multi-Line Right Prompt
> Fish can't do _that_ yet can it?
![Multi-Line_Right_Prompt]
### Pure Compatibility
Tide can produce the same prompt as [Pure]. Type `tide configure` and select the Pure style.
![Pure_Compatibility]
Tide doesn't recognize Pure configuration parameters, so you'll need to use `set tide_cmd_duration_threshold 3000` instead of `set pure_threshold_command_duration 3`, etc.
Pure style is an exact replication of the Pure fish theme and therefore displays less information than Lean. It exists only to ease the migration for users of that theme. Unless you are one of them, choose Lean style over Pure.
### Extensible
If there isn't a prompt item that fits your needs, make your own!
![Extensible]
## Contributing
If you're interested in helping contribute to Tide, please take a look at the [Contributing Guide][contributing_guide].
## Configuration
Tide variables that users are encouraged to modify begin with the string `tide_`. Thus, variables in this section will be denoted as `example_variable` but will actually be `tide_example_variable`.
## General Variables
| Variable | Description | Default |
| ------------------ | ------------------------------------------ | ------------------------------------------ |
| newline | add empty line before each prompt | true |
| left_prompt_items | order of the left prompt items to display | 'pwd' 'git_prompt' 'newline' 'prompt_char' |
| right_prompt_items | order of the right prompt items to display | 'status' 'cmd_duration' 'context' 'jobs' |
### prompt_connection
| Variable | Description | Default |
| ----------------------- | --------------------------------------------------------------------- | ------- |
| prompt_connection_color | color of prompt connection | 6C6C6C |
| prompt_connection_icon | repeated symbol that spans gap between left and right sides of prompt | ' ' |
## Prompt Items
| Item | Description |
| ----------------------------- | -------------------------------- |
| [cmd_duration](#cmd_duration) | duration of the last run command |
| [context](#context) | user@hostname in ssh or root |
| [git_prompt](#git_prompt) | git repository status |
| [jobs](#jobs) | presence of background jobs |
| [prompt_char](#prompt_char) | prompt symbol;turns red on error |
| [pwd](#pwd) | current directory |
| [status](#status) | exit code of the last command |
| [time](#time) | current time |
### cmd_duration
| Variable | Description | Default |
| ---------------------- | ------------------------------------------------------------------ | ------- |
| cmd_duration_color | color of cmd_duration output | 87875F |
| cmd_duration_decimals | number of decimals to display after seconds place | 0 |
| cmd_duration_threshold | number of milliseconds that duration must exceed to produce output | 3000 |
### context
| Variable | Description | Default |
| ------------------ | ------------------------------- | ------- |
| context_root_color | color of context when root user | D7AF00 |
| context_ssh_color | color of context when in SSH | D7AF87 |
### git_prompt
Tide's git capabilities are inherited from fish's built-in [fish_git_prompt]. Modify those variables to configure tide's git prompt.
### jobs
| Variable | Description | Default |
| ---------- | ------------------------------------------------ | ------- |
| jobs_color | color of jobs icon | D7AF00 |
| jobs_icon | symbol to display when there are background jobs | D7AF87 |
### prompt_char
| Variable | Description | Default |
| ------------------------- | ----------------------------------------------------- | ------- |
| prompt_char_icon | prompt char symbol | '❯' |
| prompt_char_success_color | color of prompt char when last command was successful | 5FD700 |
| prompt_char_failure_color | color of prompt char when last command failed | FF0000 |
### pwd
| Variable | Description | Default |
| ------------------------ | ------------------------------------------------------------------------ | -------------------- |
| pwd_anchors | Directories displayed in bold and immune to truncation | 'first' 'last' 'git' |
| pwd_color_anchors | color of anchors | 00AFFF |
| pwd_truncate_margin | start truncating when pwd is this many columns from terminal edge | 10 |
| pwd_color_truncated_dirs | color of truncated directories | 8787AF |
| pwd_max_dirs | max number of directories to display, 0 or less equals unlimited | 0 |
| pwd_color_dirs | color of normal directories | 0087AF |
| pwd_unwritable_icon | symbol to display when the current directory is not writable by the user | '' #Lock icon |
### status
| Variable | Description | Default |
| -------------------- | -------------------------------------------------------------- | ------- |
| status_success_icon | symbol to display when the last command in a pipeline succeeds | '✔' |
| status_success_color | color of successful pipeline's status | 5FAF00 |
| status_failure_icon | symbol to display when the last command in a pipeline fails | '✘' |
| status_failure_color | color of failed pipeline's status | D70000 |
### time
| Variable | Description | Default |
| ----------- | ---------------------- | ------- |
| time_color | color of time display | 5F8787 |
| time_format | format of time display | '%T' |
## Fonts
`Sauce Code Pro`—a nerd-fonts patched version of the legendary Source Code Pro—is the recommended font for Tide.
### Font Installation
Download these four ttf files:
- [Sauce Code Pro Regular.ttf][sauce_code_pro_regular.ttf]
- [Sauce Code Pro Bold.ttf][sauce_code_pro_bold.ttf]
- [Sauce Code Pro Italic.ttf][sauce_code_pro_italic.ttf]
- [Sauce Code Pro Bold-Italic.ttf][sauce_code_pro_bold-italic.ttf]
Open each file and click "Install". This will make the `Sauce Code Pro` font available to all applications on your system. Configure your terminal to use this font.
[release_shield]: https://img.shields.io/github/v/release/IlanCosman/tide?label=%20
[releases]: https://github.com/IlanCosman/tide/releases
[fish_version_shield]: https://img.shields.io/badge/fish-3.1.0%2B-blue
[license_shield]: https://img.shields.io/github/license/IlanCosman/tide
[license]: https://github.com/IlanCosman/tide/blob/master/LICENSE
[fish]: https://github.com/fish-shell/fish-shell
[powerlevel10k]: https://github.com/romkatv/powerlevel10k/
[prompt_connection]: /resources/images/Prompt_Connection.png
[git]: https://github.com/git/git
[configuration_wizard]: /resources/svgs/Configuration_Wizard.svg
[multi-line_right_prompt]: /resources/images/Multi-Line_Right_Prompt.png
[pure]: https://github.com/rafaelrinaldi/pure
[pure_compatibility]: /resources/svgs/Pure_Compatibility.svg
[extensible]: /resources/images/Extensible.png
[contributing_guide]: https://github.com/IlanCosman/tide/blob/master/CONTRIBUTING.md
[fish_git_prompt]: https://fishshell.com/docs/current/cmds/fish_git_prompt.html
[sauce_code_pro_regular.ttf]: https://github.com/ryanoasis/nerd-fonts/raw/master/patched-fonts/SourceCodePro/Regular/complete/Sauce%20Code%20Pro%20Nerd%20Font%20Complete.ttf
[sauce_code_pro_bold.ttf]: https://github.com/ryanoasis/nerd-fonts/raw/master/patched-fonts/SourceCodePro/Bold/complete/Sauce%20Code%20Pro%20Bold%20Nerd%20Font%20Complete.ttf
[sauce_code_pro_italic.ttf]: https://github.com/ryanoasis/nerd-fonts/raw/master/patched-fonts/SourceCodePro/Italic/complete/Sauce%20Code%20Pro%20Italic%20Nerd%20Font%20Complete.ttf
[sauce_code_pro_bold-italic.ttf]: https://github.com/ryanoasis/nerd-fonts/raw/master/patched-fonts/SourceCodePro/Bold-Italic/complete/Sauce%20Code%20Pro%20Bold%20Italic%20Nerd%20Font%20Complete.ttf
Reference in New Issue View Git Blame Copy Permalink