n1ghtfall (v3.0.1)

oh-my-zsh-inspired zsh terminal theme!

note: these previews are with some terminal settings modified to make it look better

other note: "n1ghtfall" in "[your_username@n1ghtfall]" will be replaced with your computer's hostname, that was just for visuals

If you want the best visual experience, you can download the font i use in previews (choose bold)

Table of Contents

• Main stuff
• Requirements
• Installation
• Updating
• Uninstalling
• Troubleshooting
• Note
• Contributing

Main stuff

Features:

• 40+ useful command aliases
• Cool look
• fzf and zsh-autosuggestions support
• (Soon) Banner animation
• Auto-updates every 1 hour (configurable)
• Backups your original Zsh config
• Easily Uninstallable
• All in Zsh

.zshrc code can now be found in the wiki!

(Recommended) If you want to remove the "last login (...) at ttys(...)", you can just create a file:

touch ~/.hushlogin

The Zsh config is a dotfile that is stored in your home directory named .zshrc, which n1ghtfall backs up at ~/.n1ghtfall-backups

You can modify the new n1ghtfall Zsh config with this command:

nano ~/.zshrc

(nano is a usually builtin text editor for terminal)

When you download, your backup zsh will stored in zshbackup in your home directory

When you want to uninstall, you can run nf-uninstall to uninstall n1ghtfall

Requirements

• macOS (other platforms are untested — see the Note below)
• Zsh (macOS ships with Zsh by default since Catalina)
• oh-my-zsh recommended for the best experience
• A Nerd Font (like the one linked above) so icons render correctly
• git and curl installed

Installation

First Option (Quickest Way)

Open your terminal and run this command:

curl -fsSL 'raw.githubusercontent.com/reorientate/n1ghtfall/refs/heads/main/install.sh' | bash

This runs the installer script

Second Option (for the people that dont like curling and piping to shell)

(make sure you are in home directory)

(recommended, but optional) backup your original .zshrc:

mkdir -p zshbackup

mv ~/.zshrc zshbackup 

now clone this repo:

git clone https://github.com/reorientate/n1ghtfall n1ghtfall

then move n1ghtfall .zshrc to home directory

mv n1ghtfall/.zshrc ~

One-liner for it all:

mkdir -p zshbackup && mv ~/.zshrc zshbackup && git clone https://github.com/reorientate/n1ghtfall n1ghtfall && mv n1ghtfall/.zshrc ~ && clear && source ~/.zshrc

Restart terminal or source ~/.zshrc to load!

Updating

n1ghtfall auto-updates every 1 hour by default (configurable). If you want to check for updates manually, you can re-run the installer or pull the latest changes if you cloned the repo directly.

Uninstalling

Run:

nf-uninstall

This restores your original .zshrc from ~/.n1ghtfall-backups (or zshbackup, depending on how you installed).

Troubleshooting

• Icons look like boxes or question marks: install a Nerd Font and set it as your terminal font.
• Colors look washed out: double check the macOS Terminal setting shown in the screenshot above is enabled.
• "Last login" message won't go away: run touch ~/.hushlogin as noted above.
• Something looks broken on Linux/Windows: see the Note below — other platforms aren't officially supported yet.

NOTE

this theme might not work or might not look that good on other platforms because im too lazy (and dont have that much storage space) to make virtual machines

Contributing

Issues and pull requests are welcome! If you run into a bug or have an idea for a new alias or feature, feel free to open an issue on GitHub.