Skip to content

GitWitAnish/ZenMod

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ZenMod - Nebula-Inspired Glass Theme

A beautiful glassmorphism-inspired theme for Zen Browser featuring blur effects, smooth animations, and modern styling inspired by the popular Zen Nebula theme.

✨ Features

🪟 Glassmorphism Effects

  • Glass backgrounds with customizable blur and saturation
  • Translucent UI elements with backdrop filters
  • Layered depth for a modern, floating appearance

🎨 Dynamic Theming

  • Multiple color themes: Blue, Purple, Green, Red, and Default
  • Adaptive colors that work with light and dark modes
  • Customizable glass opacity and blur effects

Smooth Animations

  • Tab hover gradients with flowing color animations
  • Active tab glow effects for better visual feedback
  • Smooth transitions throughout the interface
  • Interactive button animations

🎯 Enhanced Components

  • Glass URL bar with focus animations and blur effects
  • Enhanced tabs with glassmorphism styling
  • Floating status bar with glass design
  • Improved context menus with blur backgrounds
  • Workspace buttons with grayscale filters and hover effects
  • Essential tabs with glow effects and smooth interactions

📱 Responsive Design

  • Compact mode optimizations with glass effects
  • Responsive sizing for different window sizes
  • Customizable border radius and spacing

🚀 Installation

Method 1: JSON Import (Recommended)

  1. Download zenmod.json from this repository
  2. Open Zen Browser and navigate to the Mod Settings
  3. Click "Import Mod from JSON"
  4. Select your zenmod.json file
  5. The mod will be automatically installed and activated

Method 2: Manual Installation

  1. Download userChrome.css and config.css from this repository
  2. Open Zen Browser and navigate to about:support
  3. Click "Open Profile Folder"
  4. Create a chrome folder if it doesn't exist
  5. Copy both CSS files to the chrome folder
  6. Enable developer tools in about:config:
    • Set devtools.debugger.remote-enabled to true
    • Set devtools.chrome.enabled to true
    • Set toolkit.legacyUserProfileCustomizations.stylesheets to true
  7. Restart Zen Browser

⚙️ Configuration

This theme includes extensive customization options through the config.css file:

🎨 Visual Options

Edit the variables in config.css to customize:

  • Glass Blur Amount: --var-zenmod-glass-blur (default: 32px)
  • Glass Saturation: --var-zenmod-glass-saturation (default: 140%)
  • Border Radius: --var-zenmod-border-radius (default: 13px)
  • Workspace Grayscale: --var-zenmod-workspace-grayscale (default: 100%)

Theme Colors

Customize colors for both light and dark modes:

  • Glass Colors: Background opacity and styling
  • UI Colors: Hover, selected, and base colors
  • Shadow Colors: Drop shadow and glow effects
  • Tint Colors: UI and website overlay tints

🎛️ Quick Theme Presets

The config.css includes several pre-made color schemes:

  • Default Glass: Balanced transparency
  • High Contrast: Enhanced visibility
  • Subtle Glass: Minimal transparency
  • Vibrant: Saturated colors with strong effects

📋 Requirements

  • Zen Browser version 1.0.0 or higher
  • Developer tools enabled (see installation instructions)
  • Modern system capable of handling backdrop-filter effects

🎨 Inspiration

This theme is inspired by the beautiful Zen Nebula theme by JustAdumbPrsn, reimagined with additional customization options and enhancements.

🐛 Troubleshooting

Common Issues:

  1. Styles not applying: Ensure toolkit.legacyUserProfileCustomizations.stylesheets is set to true in about:config
  2. Performance issues: Reduce blur amount or disable some animation features
  3. Colors not showing: Check that your system supports backdrop-filter CSS property

Performance Optimization:

  • Disable unnecessary animations if experiencing lag
  • Reduce blur amount on older hardware
  • Use compact mode for better performance

🤝 Contributing

Feel free to:

  • Report bugs and issues
  • Suggest new features or improvements
  • Submit pull requests with enhancements
  • Share screenshots of your customizations

📄 License

MIT License - feel free to modify and distribute.

🙏 Credits

About

Why browse on someone else’s vibe when you can craft your own?

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages