Note that the default setting trades quality for speed

app.py

@@ -240,6 +240,8 @@ CSS = """
 #title {text-align: center; margin-bottom: 0;}
 #links {text-align: center;}
 #run_btn {font-size: 1.1rem;}
+#note {background: var(--color-accent-soft); border-left: 4px solid var(--color-accent);
+       border-radius: 6px; padding: 10px 14px;}
 """
 
 with gr.Blocks(title="VideoMaMa++ demo") as demo:
@@ -255,6 +257,13 @@ with gr.Blocks(title="VideoMaMa++ demo") as demo:
         "2. Click the object on the first frame (or type what it is, e.g. `person`). "
         "3. Press **Run matting**: SAM3 tracks the object and VideoMaMa++ turns the mask track into an alpha matte."
     )
+    gr.Markdown(
+        f"**Speed vs. quality:** to keep runs short, the demo starts with a reduced setting of "
+        f"**{DEFAULT_FRAMES} frames at {DEFAULT_SCALE} resolution**, so these results are lower in quality than "
+        "VideoMaMa++ can produce. For the best mattes, set **Processing resolution** to **100% (original)**. "
+        "That takes longer and uses more of your GPU quota.",
+        elem_id="note",
+    )
 
     state = gr.State(None)
     with gr.Row():