Oh My Zsh Theme Explorer

A lightweight, professional web application for filtering and discovering Oh My Zsh themes by features and colors.

Features

• Smart Filtering - Filter themes by features (Git, VirtualEnv, Ruby, Node.js, etc.)
• Color Search - Find themes by color palette
• Style Filters - Filter by Powerline and Multiline support
• Live Search - Real-time search by theme name
• Direct Preview - Quick links to official theme screenshots
• Minimalist Design - Clean, professional interface with intuitive controls

Quick Start

1. Clone the repository

   git clone <repository-url>
   cd othemes

2. Place theme files

   # Copy your Oh My Zsh themes to .themes/
   cp -r ~/.oh-my-zsh/themes .themes/

3. Analyze themes

   python3 analyze_themes.py

4. Start local server

   python3 -m http.server 8000

5. Open in browser

   http://localhost:8000
   

How It Works

Theme Analysis

The analyze_themes.py script parses all .zsh-theme files and extracts:

• Features: Git integration, virtualenv support, time display, etc.
• Colors: Color codes and ANSI escape sequences
• Style: Powerline support, multiline prompts
• Special Characters: Unicode symbols and indicators

The analysis generates themes_data.json containing structured metadata for all themes.

Filtering Logic

• Features: AND logic - selecting multiple features shows only themes that have ALL selected features
• Colors: OR logic - shows themes containing ANY of the selected colors
• Style: AND logic - themes must match ALL selected style filters
• Search: Real-time text filtering on theme names

Project Structure

othemes/
├── index.html              # Main web application
├── analyze_themes.py       # Theme analysis script
├── themes_data.json        # Generated theme metadata
├── .themes/                # Oh My Zsh theme files
└── README.md              # This file

Technology Stack

• Frontend: Pure HTML, CSS, JavaScript (no frameworks)
• Analysis: Python 3
• Data: JSON
• Styling: Modern CSS with flexbox/grid

Credits

• Zsh: https://www.zsh.org/
• Oh My Zsh: https://ohmyz.sh/
• Theme Repository: github.com/ohmyzsh/ohmyzsh

License

This project is a community tool for exploring Oh My Zsh themes. All themes are property of their respective creators and fall under Oh My Zsh's license.

Contributing

Contributions are welcome! Feel free to:

• Report bugs or issues
• Suggest new features
• Improve theme detection algorithms
• Enhance the UI/UX

Development

To modify the theme analysis:

1. Edit analyze_themes.py
2. Add new feature detection patterns
3. Run the script to regenerate themes_data.json
4. Refresh the browser to see changes

To modify the interface:

1. Edit index.html (contains HTML, CSS, and JavaScript)
2. Refresh the browser to see changes

Browser Support

• Chrome/Edge (latest)
• Firefox (latest)
• Safari (latest)

Performance

• Analyzes 143 themes in under 1 second
• Instant client-side filtering
• No server-side processing required
• Lightweight (~50KB total)