QL-Win / QL-Win/QuickLook

Add an UI for Managing Plugins & Settings

Open
#1,916 1 comment 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
C#
Stars
24.7k
Forks
1.3k
Avg merge
4d 7h
Merged PRs (30d)
1

Description

Summary

QuickLook currently runs with no visible UI, exposing only a tray icon and a context menu. While this minimal design aligns with the app’s philosophy, it makes plugin management and configuration difficult for users who are not comfortable navigating the file system or manually editing folders. An optional, lightweight UI would improve usability without compromising QuickLook’s core simplicity.

Problem

Managing plugins requires several manual steps:

  • Installing plugins requires selecting a .qlplugin file and pressing Space, then restarting QuickLook.
  • Removing or upgrading plugins requires quitting QuickLook, navigating to the data directory, and manually deleting or replacing plugin folders.
  • There is no built‑in way to:
    • View which plugins are installed
    • Check plugin versions
    • Enable/disable plugins
    • Update plugins
    • Change QuickLook settings (startup behavior, hotkeys, etc.)

For many users, this workflow is unintuitive and error‑prone.

Proposed Solution

Introduce a minimal, optional UI panel accessible from the tray icon (e.g., “Open QuickLook Settings…”). This panel could include:

1. Plugin Manager
  • List installed plugins
  • Show plugin name, version, and description
  • Buttons to:
    • Enable/disable
    • Update
    • Remove
    • Install new plugin (drag‑and‑drop or file picker)
2. Basic Settings
  • Toggle “Run at Startup”
  • Configure hotkeys
  • Choose preview behavior (e.g., auto‑play videos, default zoom)
  • View data folder location
3. About / Diagnostics
  • QuickLook version
  • Plugin folder path
  • Log viewer (optional)

Why This Matters

  • Reduces friction for new users
  • Eliminates manual file operations
  • Makes plugin discovery and maintenance easier
  • Improves transparency (users can see what’s installed and running)
  • Aligns QuickLook with modern Windows UX expectations while keeping the preview experience lightweight

Non‑Goals

  • Not requesting a full application window or heavy UI
  • Not changing the core preview behavior
  • Not replacing the tray menu, only extending it

Additional Context

QuickLook’s plugin system is powerful but currently hidden behind manual steps. A small UI would make the feature more accessible and help the project scale as more plugins are created.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing the existing tray icon and context menu, then inspect how plugins and QuickLook settings are stored in the data directory. Before implementation, define the panel's scope and acceptance criteria for plugin listing, enable/disable, installation, updates, removal, and basic settings.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
desktop
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.