bhilburn/powerlevel9kArchived
Powerlevel9k
Powerlevel10k is a customizable Zsh theme framework and command line prompt customizer designed to create a visual shell status dashboard. It provides a toolkit for defining the layout, colors, and segments of a terminal prompt to improve the command line user experience.
The project distinguishes itself through a flexible configuration system for prompt appearance and layout, allowing users to organize information segments across multiple lines and visually merge adjacent blocks. It supports extensive visual customization, including the use of custom font codepoints for icons and state-based color mapping to indicate changes such as root access or modified files.
The framework integrates real-time tracking for version control status, cloud infrastructure profiles, and development environment runtimes. It also monitors system metrics, including command execution times, exit status reporting, and hardware data like battery level and disk usage.
The theme is implemented as a set of shell-scripted prompt generation functions for the Zsh shell.
Features
- Prompt Customization Toolkits - Provides a comprehensive toolkit for defining the layout, colors, and segments of a terminal prompt.
- Prompt Layout Engines - Provides a sophisticated engine for organizing prompt segments across multiple lines and controlling vertical spacing.
- Version Control Systems - Provides real-time tracking of repository information, active branches, and changeset status for various version control systems.
- Version Control Integrations - Surfaces git branch names and repository status changes within the terminal interface for faster navigation.
- Prompt State Polling - Gathers system metrics and version control status by querying the OS and filesystem before each prompt redraw.
- Prompt Generation Functions - Constructs the command line interface by executing shell functions that output escaped sequences and text.
- Shell Prompt Themes - Implements a customizable Zsh theme framework that displays system status, version control, and execution metrics.
- Shell Themes - Provides a customizable visual interface for Zsh with personalized layouts and themed colors.
- Terminal Prompt Configuration - Allows users to select and position information segments on the left or right sides of the prompt layout.
- Terminal Layout Engines - Features a layout engine that organizes prompt components across multiple vertical lines using shell escape sequences.
- Prompt Segments - Provides a system for creating dynamic segments that execute commands to inject real-time data into the prompt.
- Terminal Interface Enhancements - Enhances terminal readability and utility using custom icons and organized information segments.
- Execution Duration Trackers - Calculates and displays the duration of the previous command when it exceeds a defined time threshold.
- Development Environment Integrations - Displays active version managers, virtual environments, and language runtimes directly in the shell interface.
- Environment Activation - Visualizes active programming language runtimes and virtual environments to provide project context.
- Shell Context Visualizers - Visualizes current shell environment metadata, including username and hostname based on superuser status.
- Container Context Monitors - Tracks and displays active profiles and environments for cloud platforms and container orchestration tools.
- State-Based Color Mapping - Assigns colors to prompt segments based on current status to indicate changes such as root access or modified files.
- Visual Segment Merging - Allows merging adjacent segments visually so they appear as a single continuous block in the terminal.
- Exit Code Trackers - Displays the return code of the last executed command and includes signal names for errors.
- Real Time Process Monitors - Displays real-time system metrics, command execution times, and process exit codes directly in the prompt.
- Status Monitors - Integrates real-time machine metrics such as battery level, disk usage, and memory directly into the prompt.
- Icon Glyph Mapping - Supports replacing default icons with custom font codepoints to customize visual symbols in the interface.
- Shell Glyph Libraries - Utilizes shell glyph libraries to render complex icons and symbols using patched fonts in the terminal.
- Prompt Color Styling - Provides mechanisms for setting precise foreground and background colors for individual prompt segments.
- Conditional Color Logic - Implements logic to dynamically resolve prompt colors based on the current session state or environment variables.
- Shell Environments - Flexible and visually rich Zsh theme.
- Terminal Prompts - Legacy Zsh theme focused on extensive customization.
