oh-my-theme 2.0.0

Terminal-based theme manager for Oh My Posh with preview, search, custom repositories, and theme customization

Oh My Theme

Theme manager for Oh My Posh that lets you browse, preview, install, activate, add custom and tweak themes directly inside your terminal.

Features

• 💻 Fast and simple: runs from terminal. Simple interface.
• 🔍 Real-time Search: Filter local and remote theme repo
• ⚡ Fast Installation: Single or multiple theme download
• 🔄 Easy Theme Switching: Theme activation (Bash/Zsh/Fish)
• 🗂️ Dual Panel Interface: Local and remote theme management
• 🎯 Custom Repositories: Add themes from Git repository (json has to be in root)
• 🎨 Theme Customization: Built-in color editor
• 🎨 Basic Previews: Sample prompt structure with basic metadata (Name, Version, Source, Color variation)
• 🚀 Performance Optimized: Smart caching and modular architecture

Prerequisites

Before using this tool, you need:

1. Oh My Posh installed - Visit ohmyposh.dev for installation instructions
2. Compatible shell: Bash, Zsh, or Fish
3. Python 3.6+ with standard libraries

Installation

Method 1: PyPI (Recommended)

pip install oh-my-theme

Method 2: AUR (Arch Linux)

yay -S oh-my-theme
# or
paru -S oh-my-theme

Method 3: Git Clone

git clone https://github.com/mikeisfree/oh-my-theme.git
pip install -e .

Usage After Installation

Once installed run with:

omt

Shell Config

The tool automatically updates your shell configuration:

• Bash: ~/.bashrc
• Zsh: ~/.zshrc
• Fish: ~/.config/fish/config.fish

Clean Theme Management:

• Removes all existing Oh My Posh theme lines when activating a new theme - If You want to keep existing oh-my-posh configuration commenting it out will not be enough - back it up to a separate file!
• Adds only the new active theme command
• Preserves all other shell configuration! (aliases, exports, functions)

After activating a theme, reload your shell:

source ~/.bashrc    # For Bash
source ~/.zshrc     # For Zsh

Usage Details

Interface Overview

The tool displays two panels:

• Left Panel: installed themes (local)
• Right Panel: Available themes from Oh My Posh main repository + custom repos added by user (remote)

Keyboard Shortcuts

Key	Action
TAB	Switch between panels
↑/↓	Navigate theme list
ENTER	Activate/Remove/Customize local theme or Select remote theme
SPACE	Toggle selection for remote themes
p	Preview selected theme
i	Install selected remote themes
/	NEW: Enter search mode for real-time theme filtering
+	NEW: Add custom Git repository
ESC	Exit search mode & cancel dialogs
q	Quit application

Local Theme Actions (ENTER)

When you press ENTER on a local theme, you'll see these options:

• A - Activate theme in shell
• R - Remove theme
• C - Customize theme colors

Getting Started

1. Browse Remote Themes: Use TAB to switch to the right panel and browse available themes
2. Search Themes: Press / to search and filter themes in real-time
3. Preview Themes: Press p to see previews with sample prompts and metadata
4. Select Themes: Use SPACE to select multiple themes for installation
5. Install Themes: Press i to download selected themes
6. Activate Theme: Switch to local panel (TAB) and press ENTER → A on your desired theme
7. Customize Theme: Press ENTER → C on local themes to edit colors
8. Add Custom Repos: Press + to add themes from custom Git repositories

Theme Previews

Preview feature shows:

• Sample prompt structure git status, paths, segments
• Essential metadata: Name, Version, Source (git repository), Color variation

Filter

• Press / to enter search mode
• Type to filter themes in real-time across both local and remote panels
• Search results highlight matching text
• Press ESC to exit search and process filtered items

Custom Repository Support

• Press + to add themes from custom Git repository
• Enter the Git repository URL when prompted
• The tool will fetch all .omp.json files from the repository root
• Custom themes are downloaded to your local themes directory
• repository address will be added to filter array

Theme Customization

• Select any local theme and press ENTER → C
• Visual color editor shows current segment colors
• Simple color picker interface for modifications
• Save as new theme (new json file) or overwrite original
• Preserve customizations across updates

Theme Storage

Downloaded themes are stored in ~/.poshthemes/ directory. The tool manages this directory automatically.

Troubleshooting

"Unsupported shell" Error

Make sure your SHELL environment variable is set correctly:

echo $SHELL

Safety measures:

Backup-friendly: Uses a clean replacement strategy that preserves non-Oh My Posh configurations

Atomic updates: Reads entire file, modifies in memory, then writes back

Error handling: Returns success/failure status

uses regex pattern to identify Oh My Posh lines:

init_pattern = re.compile(r"^\s*(eval.*oh-my-posh init.*|oh-my-posh init.*fish.*)")

User confirmation: Always asks for confirmation before activating themes

Theme Not Activating

1. Ensure Oh My Posh is properly installed and in your PATH
2. Check that your shell configuration file exists and is writable
3. Reload your shell after theme activation

Preview Not Working

• For remote themes: The tool will offer to download the theme for preview
• For local themes: Ensure the theme file exists in ~/.poshthemes/

Search Not Responding

• Make sure you're in search mode (press / first)
• Press ESC to exit search mode if stuck
• Search works across both local and remote theme panels

Custom Repository Issues

• Ensure the Git repository URL is valid and accessible
• Repository must contain .omp.json files in the root directory
• Check your internet connection for repository access

Theme Customization Problems

• Only local themes can be customized
• Ensure you have write permissions to the themes directory
• Invalid JSON themes cannot be edited safely

Performance Features

• Smart Caching: Theme metadata is cached to speed up repeated previews
• File Reuse: Existing downloaded themes are reused for previews
• Memory Management: Cache size is limited to prevent memory bloat
• Lazy Loading: Theme parsing only when needed

What's New in v2.0

• 🔍 Search: Filter themes instantly with / keybind
• 🎯 Custom Repositories: Add themes from Git repository with + keybind
• 🎨 Theme Customization: Built-in color editor for personalizing themes
• ✨ Enhanced Previews: sample prompts with essential metadata
• 🏗️ Modular Architecture: Improved code organization and maintainability

Contributing

⭐ Star on GitHub if you like it!
📦 Review the package on PyPI or AUR
🐛 Report issues on GitHub
🔧 Submit pull requests with updates/upgrades

License

This project is open source. Please check the license file for details.

Architecture

Oh My Theme v2.0 features a modular architecture:

• oh_my_theme/main.py: Core UI and application logic
• oh_my_theme/preview.py: Enhanced theme previews and sample generation
• oh_my_theme/search.py: Real-time search and filtering functionality
• oh_my_theme/repositories.py: Custom Git repository management
• oh_my_theme/editor.py: Theme color customization interface
• oh_my_theme/config.py: Configuration and settings management

Dependencies

• Python 3.6+: Core runtime requirement
• Standard libraries only: curses, json, os, subprocess, urllib
• No external dependencies required: Pure Python implementation

Related Links

• Oh My Posh Official Website
• Oh My Posh Documentation
• Oh My Posh Themes Repository (main)
• Project Repository
• PyPI Package

---

Note: This tool modifies your shell configuration files. It's recommended to backup your configuration before first use.