Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/skippyr/july
A simple theme for the ZSH shell
https://github.com/skippyr/july
cli command-line design oh-my-zsh-theme productivity prompt script shell shell-script theme zsh zsh-theme
Last synced: about 1 month ago
JSON representation
A simple theme for the ZSH shell
- Host: GitHub
- URL: https://github.com/skippyr/july
- Owner: skippyr
- License: mit
- Archived: true
- Created: 2023-06-09T03:11:46.000Z (12 months ago)
- Default Branch: root
- Last Pushed: 2023-08-29T18:15:54.000Z (9 months ago)
- Last Synced: 2024-01-27T12:11:00.937Z (4 months ago)
- Topics: cli, command-line, design, oh-my-zsh-theme, productivity, prompt, script, shell, shell-script, theme, zsh, zsh-theme
- Language: Shell
- Homepage:
- Size: 2.23 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-zsh-plugins - july - Minimalist prompt. Includes decorators for user, host and current directory. (Themes / ZSH on Windows)
- fucking-awesome-zsh-plugins - july - Minimalist prompt. Includes decorators for user, host and current directory. (Themes / ZSH on Windows)
README
# July
## About
This repository contains the source code of July, a simple theme for the ZSH shell.
Here is a preview that you can check it out:
> [!NOTE]
> This theme uses the terminal emulator's colors, so they may look different in your setup when compared to the preview.
### Features
This theme can show you:
- The name of sourced virtual environments.
- Your host and user name.
- The path of the directory you are in.
## Installation
### Dependencies
In order to install and run this software properly, the following dependencies must be installed:
- `ZSH`: this is the shell this themes applies on.
- `git`: it will be used to clone this repository.
### Stand-alone Procedures (recommended for most users)
These steps are intended for users that want to perform a stand-alone install of this theme. As it does not need any extra dependency, it is the recommended option for most users.
- Clone this repository using `git`.
```bash
git clone --depth 1 https://github.com/skippyr/july\
~/.local/share/zsh/themes/july
```
- Add the following source rule to your `~/.zshrc` file. Ensure to not source any other theme to avoid conflicts.
```bash
source ~/.local/share/zsh/themes/july/july.zsh-theme
```
- Open a new ZSH session. The theme should now be installed and running.
### OhMyZSH Procedures
These procedures are intended for users that want to use this theme within the OhMyZSH framework.
- Install [OhMyZSH](https://github.com/ohmyzsh/ohmyzsh).
- Clone this repository using `git` to OhMyZSH's custom themes directory.
```bash
git clone --depth 1 https://github.com/skippyr/july\
"${ZSH_CUSTOM:-${HOME}/.oh-my-zsh/custom}/themes/july"
```
- Change the value of the `ZSH_THEME` variable in your `~/.zshrc` file to use the theme.
```bash
ZSH_THEME=july/july
```
- Open a new ZSH session. The theme should now be installed and running.
## Support
If you need any kind of support, for instance: help with troubleshooting, have questions about it or want to give improvement suggestions, please report them by filing new issues in its [issues page](https://github.com/skippyr/july/issues).
## Copyright
This software is under the MIT license. A copy of the license is bundled with the source code.