mirror of
https://github.com/yazanammar/obsidian-theme-engine.git
synced 2026-07-22 06:44:37 +00:00
127 lines
2 KiB
Markdown
127 lines
2 KiB
Markdown
|
# 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:
|
||
|
|
|
||
|
|
```text
|
||
|
|
Advanced Settings
|
||
|
|
```
|
||
|
|
|
||
|
|
2. Locate:
|
||
|
|
|
||
|
|
```text
|
||
|
|
Live Update FPS
|
||
|
|
```
|
||
|
|
|
||
|
|
3. 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:
|
||
|
|
|
||
|
|
```text
|
||
|
|
Settings → Appearance → Themes
|
||
|
|
```
|
||
|
|
|
||
|
|
2. Select:
|
||
|
|
|
||
|
|
```text
|
||
|
|
Default
|
||
|
|
```
|
||
|
|
|
||
|
|
3. Let Theme Engine control colors.
|
||
|
|
|
||
|
|
## Optimize Background Performance
|
||
|
|
|
||
|
|
Large images and videos can affect responsiveness.
|
||
|
|
|
||
|
|
Recommended practices:
|
||
|
|
|
||
|
|
### Images
|
||
|
|
|
||
|
|
Enable:
|
||
|
|
|
||
|
|
```text
|
||
|
|
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 →](./faq.md)
|
||
|
|
|
||
|
|
## 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
|
||
|
|
|
||
|
|
- [Usage Guide](./guide.md)
|
||
|
|
- [Variable Reference](./variables.md)
|
||
|
|
- [FAQ](./faq.md)
|
||
|
|
- [Main README](../README.md)
|