A fast and full-featured tribal looking shell theme available for PowerShell and ZSH running on Windows, Linux and MacOS.

Caption: River Dreams running on MacOS (ZSH). Terminal theme is river-dreams. Font is Hack (patched by the Nerd Fonts project).

These are the descriptions of each prompt feature from left to right, top to bottom, respectively:

• Your local IPV4 address or "No Address" if no address can be found.
• If you are using a laptop, its battery charge and if it is being currently charged.
• Your disk usage.
• A calendar showing the week day, month and day.
• A 24-hours clock with a symbol that changes depending on the day time: dawn (between 00h00m to 06h00m), morning (between 06h00m and 12h00m), afternoon (between 12h00m and 18h00m) and night (between 18h00m and 00h00m).
• A hash symbol when you have administrator privileges, on Windows, or is the root user on MacOS and Linux.
• The exit code of the last command ran.
• The active Python virtual environment, if you have sourced one.
• The current active directory path, shorting it when inside of a Git repository.
• When inside of a Git repository, the active branch name or the reference hash if its under rebase.

• The total of each entry type in the current active directory: block devices, character devices, directories, fifos, files, hidden entries, sockets, symlinks and temporary entries. Symlinks are followed. Types availability and interpretation are subject to the operating system you are using.

The following dependencies must be installed before it:

• Visual Studio 2022 with the "Desktop development with C " workload: it provides all the tools required to build this software.
• Git: it will be used to clone this repository.
• A font patched by the Nerd Fonts project: it provides the pretty symbols used by the software.

• GCC, CMake: they will be used to build this software.
• Git: it will be used to clone this repository.
• A font patched by the Nerd Fonts project: it provides the pretty symbols used by the software.

• Apple Command Line Tools, cmake: they will be used to build this software.
• Git: it will be used to clone this repository.
• A font patched by the Nerd Fonts project: it provides the pretty symbols used by the software.

• If you are using Windows, open PowerShell with administrator privileges and set your PowerShell execution policy to Unrestricted. When prompted, type y to accept the changes. For non-Windows systems this is already the default option. For more information, access the PowerShell Execution Policy documentation page:

Set-ExecutionPolicy Unrestricted;

• Open/Reopen PowerShell without administrator privileges.
• Clone this repository using git:

# For Linux/MacOS
git clone --depth 1 https://github.com/skippyr/river-dreams `
                    "${env:HOME}/.config/powershell/themes/river-dreams";

# For Windows
git clone --depth 1 https://github.com/skippyr/river-dreams `
          "${env:USERPROFILE}\Documents\WindowsPowerShell\themes\river-dreams";

• Add the PowerShell connector source command to your profile:

# For Linux/MacOS
Write-Output `n'. "${env:HOME}/.config/powershell/themes/river-dreams/src/connectors/river-dreams.ps1";' | `
Out-File -Append -Encoding UTF8 ${PROFILE};

# For Windows
Write-Output `n'. "${env:USERPROFILE}\Documents\WindowsPowerShell\themes\river-dreams\src\connectors\river-dreams.ps1";' | `
Out-File -Append -Encoding UTF8 ${PROFILE};

• Reopen PowerShell in order to initiate the theme.
• During its first execution, River Dreams will automatically check its dependencies and build its source code, a process that can take a moment. Once that is done, the theme will be loaded and will be ready for you to use.

• Open ZSH.
• Clone this repository using git:

git clone --depth 1 https://github.com/skippyr/river-dreams \
          ~/.config/zsh/themes/river-dreams;

• Add the ZSH connector source command to your profile:

echo "source ~/.config/zsh/themes/river-dreams/src/connectors/river-dreams.zsh;" >> ~/.zshrc;

• Reopen ZSH in order to initiate the theme.
• During its first execution, River Dreams will automatically check its dependencies and build its source code, a process that can take a moment. Once that is done, the theme will be loaded and will be ready for you to use.

If you need help related to this project, open a new issue in its issues pages or send me an e-mail describing what is going on.

This project is open to review and possibly accept contributions, specially fixes and suggestions. If you are interested, send your contribution to its pull requests page or to my e-mail.

In order to keep it open-source, by contributing to this project, you must agree to license your work under the same license that the project uses. For other intentions, prefer to create a fork.

This is free software licensed under the MIT License that comes WITH NO WARRANTY. Refer to the LICENSE file that comes in its source code for license and copyright details.

^{≥v≥v Here Be Dragons! ≥v≥
Made with love by skippyr <3}