obsidian-plugin/yazanammar_obsidian-theme-engine
1
0
Fork 0
mirror of https://github.com/yazanammar/obsidian-theme-engine.git synced 2026-07-22 06:44:37 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
yazanammar_obsidian-theme-e.../docs/tips.md

2 KiB
Raw Blame History

Theme Engine Tips & Performance Guide

This guide contains recommendations for better performance, smoother customization, and avoiding common issues.

Reduce Live Preview Updates

If color updates feel slow while dragging color pickers:

  1. Open:
Advanced Settings
  1. Locate:
Live Update FPS
  1. Reduce the value.

Recommendations:

Value Behavior
60 Maximum responsiveness
30 Balanced performance
15 Lower CPU usage
0 Disable live preview completely

At 0, updates apply only after releasing the picker.

Community Themes May Override Colors

Theme Engine modifies Obsidian variables, but Community Themes may override them.

Examples:

  • Minimal
  • Atom
  • Things
  • Prism

Recommended setup:

  1. Open:
Settings → Appearance → Themes
  1. Select:
Default
  1. Let Theme Engine control colors.

Optimize Background Performance

Large images and videos can affect responsiveness.

Recommended practices:

Images

Enable:

Convert Images to JPG

Benefits:

  • Smaller file sizes
  • Faster loading
  • Lower memory usage

Videos

Recommendations:

  • Prefer .mp4
  • Use lower resolutions where possible
  • Keep videos short

Avoid:

  • Very large files
  • High bitrate videos

Profile Cleanup

Large numbers of unused profiles and snippets can make management harder.

Recommended:

  • Delete old profiles
  • Remove unused snippets
  • Export backups periodically

Troubleshooting

If unexpected issues occur:

See: FAQ →

Recommended Workflow

For the best experience:

  1. Start with the Default profile
  2. Customize colors gradually
  3. Add snippets only when needed
  4. Export profiles regularly
  5. Use snapshots before major changes

Related Documentation