One source of truth
Every active value should come from one default/schema entry, with no redundant ghost variables.
Stable script names
#_VARIABLE=value commands stay literal forever so playlists remain portable.
Totally translatable
Labels, descriptions, and help text can localize without changing the script contract.
Control freak heaven
Everything visible, resettable, exportable, and understandable without wasting screen space.
Output
10 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
GRID_DESKTOP |
Grid Desktop | state | 3 |
Default state variable. Friendly label and description may be expanded in schema. | #_GRID_DESKTOP=3 |
||
GRID_PHONE |
Grid Phone | state | 2 |
Default state variable. Friendly label and description may be expanded in schema. | #_GRID_PHONE=2 |
||
GRID_PHONE_LANDSCAPE |
Grid Phone Landscape | state | 2 |
Default state variable. Friendly label and description may be expanded in schema. | #_GRID_PHONE_LANDSCAPE=2 |
||
GRID_PHONE_PORTRAIT |
Grid Phone Portrait | state | 1 |
Default state variable. Friendly label and description may be expanded in schema. | #_GRID_PHONE_PORTRAIT=1 |
||
GRID_TABLET |
Grid Tablet | state | 3 |
Default state variable. Friendly label and description may be expanded in schema. | #_GRID_TABLET=3 |
||
LETTERBOX_BG_ALPHA |
Letterbox Alpha | range | multiplier | 1 |
min: 0 · max: 1 · step: 0.01 | Opacity for letterbox/pillarbox background areas. | #_LETTERBOX_BG_ALPHA=1 |
LETTERBOX_BG_COLOR |
Letterbox Color | text | CSS color | #000000 |
Color used behind contained media when aspect ratios do not match. | #_LETTERBOX_BG_COLOR=#000000 |
|
LETTERBOX_MODE |
Letterbox Mode | select | choice | solid |
solid | transparent | blurred-edge | sampled-edge | Background mode for FIT letterbox/pillarbox areas. | #_LETTERBOX_MODE=solid |
Max_Grid_Columns |
Max Grid Columns | state | 9 |
Default state variable. Friendly label and description may be expanded in schema. | #_Max_Grid_Columns=9 |
||
Max_Visible_Panels |
Max Visible Panels | state | 9 |
Default state variable. Friendly label and description may be expanded in schema. | #_Max_Visible_Panels=9 |
Grid Geometry
3 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
GRID_OUTER_PADDING_PERCENT |
Grid Outer Padding | range | percent | 0.65 |
min: 0 · max: 6 · step: 0.05 | Percentage padding around the entire thumbnail grid. Proportional; never fixed pixels. | #_GRID_OUTER_PADDING_PERCENT=0.65 |
GRID_TILE_GAP_PERCENT |
Grid Tile Gap | range | percent | 0.55 |
min: 0 · max: 6 · step: 0.05 | Percentage gap between thumbnails. Proportional; never fixed pixels. | #_GRID_TILE_GAP_PERCENT=0.55 |
GRID_TILE_INNER_PADDING_PERCENT |
Tile Inner Padding | range | percent | 0 |
min: 0 · max: 6 · step: 0.05 | Percentage padding inside each thumbnail tile surface. Proportional; never fixed pixels. | #_GRID_TILE_INNER_PADDING_PERCENT=0 |
Corners
2 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
CORNER_RADIUS |
Corner Radius | range | percent | 1.15 |
min: 0 · max: 12 · step: 0.05 | Shared corner radius as a proportional percent. Ignored by square; minimum boosted by rounded; pill uses full rounding. | #_CORNER_RADIUS=1.15 |
CORNER_STYLE |
Corner Style | select | choice | slightly-rounded |
square | slightly-rounded | rounded | pill | Shared corner style for thumbnail/framework surfaces. Default is very slightly rounded. | #_CORNER_STYLE=slightly-rounded |
Export
7 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
EXPORT_BACKGROUND_ALPHA |
Export Background Alpha | range | multiplier | 1 |
min: 0 · max: 1 · step: 0.01 | Background alpha for export modes that support alpha. | #_EXPORT_BACKGROUND_ALPHA=1 |
EXPORT_BACKGROUND_COLOR |
Export Background Color | text | CSS color | #000000 |
Flattening/background color for JPG and solid-background export modes. | #_EXPORT_BACKGROUND_COLOR=#000000 |
|
EXPORT_BACKGROUND_MODE |
Export Background Mode | select | choice | solid |
solid | transparent | Controls whether export background is flattened or transparent when possible. | #_EXPORT_BACKGROUND_MODE=solid |
EXPORT_CONTENT_MODE |
Export Content Mode | select | choice | composite |
composite | media-only | overlay-only | qr-only | qr-only-overlay | Controls whether export renders the complete thumbnail, media only, overlays only, or QR-focused output. | #_EXPORT_CONTENT_MODE=composite |
PNG_TRANSPARENCY |
PNG Transparency | checkbox | boolean | false |
Allows PNG export background/letterbox transparency where export mode supports alpha. | #_PNG_TRANSPARENCY=false |
|
QR_EXPORT_INCLUDE_BACKGROUND |
QR Export Background | checkbox | boolean | true |
Include QR background/frame material in QR-focused export modes. | #_QR_EXPORT_INCLUDE_BACKGROUND=true |
|
QR_EXPORT_INCLUDE_FRAME |
QR Export Frame | checkbox | boolean | true |
Include QR border/frame in QR-focused export modes. | #_QR_EXPORT_INCLUDE_FRAME=true |
UI
11 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
AutoHideGear |
Autohidegear | state | false |
Default state variable. Friendly label and description may be expanded in schema. | #_AutoHideGear=false |
||
ShowControls |
Showcontrols | state | true |
Default state variable. Friendly label and description may be expanded in schema. | #_ShowControls=true |
||
ShowGear |
Showgear | state | true |
Default state variable. Friendly label and description may be expanded in schema. | #_ShowGear=true |
||
UI_CONTROL_CANONICAL_PADDING_EM |
Canonical Control Padding | range | em | 0.55 |
min: 0.25 · max: 1.5 · step: 0.05 | The single shared padding value used by all visible framework controls and dropdown list rows. | #_UI_CONTROL_CANONICAL_PADDING_EM=0.55 |
UI_CONTROL_MIN_TOUCH_HEIGHT_EM |
Control Min Touch Height | range | em | 2.15 |
min: 1.5 · max: 4 · step: 0.05 | Shared minimum touch height for teacher/student-friendly controls. | #_UI_CONTROL_MIN_TOUCH_HEIGHT_EM=2.15 |
UI_CONTROL_OPEN_LIST_FIT_MODE |
Dropdown Open List Fit Mode | select | choice | longest-option |
longest-option | selected-value | Shared rule for open dropdown list width. Default expands while open so list choices are not clipped. | #_UI_CONTROL_OPEN_LIST_FIT_MODE=longest-option |
UI_CORNER_STYLE |
Ui Corner Style | state | "slightly-rounded" |
Default state variable. Friendly label and description may be expanded in schema. | #_UI_CORNER_STYLE="slightly-rounded" |
||
UI_DENSITY |
Ui Density | state | "normal" |
Default state variable. Friendly label and description may be expanded in schema. | #_UI_DENSITY="normal" |
||
UI_DIRECTION |
Ui Direction | state | "auto" |
Default state variable. Friendly label and description may be expanded in schema. | #_UI_DIRECTION="auto" |
||
UI_DROPDOWN_RENDERER |
Dropdown Renderer | select | choice | custom-framework |
custom-framework | Dropdowns are rendered by the shared controllable framework, not native browser popup lists. | #_UI_DROPDOWN_RENDERER=custom-framework |
UI_LANGUAGE |
Ui Language | state | "en" |
Default state variable. Friendly label and description may be expanded in schema. | #_UI_LANGUAGE="en" |
Curation
9 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
CURATION_LANGUAGE |
Curation Language | state | "en" |
Default state variable. Friendly label and description may be expanded in schema. | #_CURATION_LANGUAGE="en" |
||
CURATION_TITLE |
Curation Title | state | "" |
Default state variable. Friendly label and description may be expanded in schema. | #_CURATION_TITLE="" |
||
CURATION_TYPE |
Curation Type | state | "independent nonprofit educational commentary" |
Default state variable. Friendly label and description may be expanded in schema. | #_CURATION_TYPE="independent nonprofit educational commentary" |
||
DISCLAIMER_PROFILE |
Disclaimer Profile | state | "independent-commentary" |
Default state variable. Friendly label and description may be expanded in schema. | #_DISCLAIMER_PROFILE="independent-commentary" |
||
MyAnythingList |
Myanythinglist | state | "" |
Default state variable. Friendly label and description may be expanded in schema. | #_MyAnythingList="" |
||
SOURCE_CHANNEL_HANDLE |
Source Channel Handle | state | "" |
Default state variable. Friendly label and description may be expanded in schema. | #_SOURCE_CHANNEL_HANDLE="" |
||
SOURCE_CHANNEL_NAME |
Source Channel Name | state | "" |
Default state variable. Friendly label and description may be expanded in schema. | #_SOURCE_CHANNEL_NAME="" |
||
SOURCE_CHANNEL_URL |
Source Channel Url | state | "" |
Default state variable. Friendly label and description may be expanded in schema. | #_SOURCE_CHANNEL_URL="" |
||
SOURCE_PLATFORM |
Source Platform | state | "" |
Default state variable. Friendly label and description may be expanded in schema. | #_SOURCE_PLATFORM="" |
Localization
6 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
CONTENT_LANGUAGE |
Content Language | state | "en" |
Default state variable. Friendly label and description may be expanded in schema. | #_CONTENT_LANGUAGE="en" |
||
DATE_FORMAT |
Date Format | state | "auto" |
Default state variable. Friendly label and description may be expanded in schema. | #_DATE_FORMAT="auto" |
||
FALLBACK_LANGUAGE |
Fallback Language | state | "en" |
Default state variable. Friendly label and description may be expanded in schema. | #_FALLBACK_LANGUAGE="en" |
||
NUMBER_FORMAT |
Number Format | state | "auto" |
Default state variable. Friendly label and description may be expanded in schema. | #_NUMBER_FORMAT="auto" |
||
TEXT_DIRECTION |
Text Direction | state | "auto" |
Default state variable. Friendly label and description may be expanded in schema. | #_TEXT_DIRECTION="auto" |
||
defaultLanguage |
Defaultlanguage | state | "en" |
Default state variable. Friendly label and description may be expanded in schema. | #_defaultLanguage="en" |
Visibility
5 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
ShowFooterText |
Footer Text | action | boolean | true |
Calls the same main toolbar button. | #_ShowFooterText=true |
|
ShowHeaderText |
Header Text | action | boolean | true |
Calls the same main toolbar button. | #_ShowHeaderText=true |
|
ShowQR |
QR Codes | action | boolean | true |
Calls the same main toolbar button. | #_ShowQR=true |
|
ShowTypes |
Type Pills | action | boolean | true |
Calls the same main toolbar button. | #_ShowTypes=true |
|
ShowURLs |
URLs | action | boolean | true |
Calls the same main toolbar button. | #_ShowURLs=true |
QR
3 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
QR_SIZE |
QR Size | range | percent | 30 |
min: 15 · max: 100 · step: 1 | QR size as proportional percent design value. | #_QR_SIZE=30 |
QR_X |
QR X | range | percent | 100 |
min: 0 · max: 100 · step: 1 | QR horizontal position as percent of final thumbnail/design surface. | #_QR_X=100 |
QR_Y |
QR Y | range | percent | 84 |
min: 0 · max: 100 · step: 1 | QR vertical position as percent of final thumbnail/design surface. | #_QR_Y=84 |
URL
7 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
URL_DIRECTION |
URL Direction | select | choice | auto |
auto | ltr | rtl | URL text direction for LTR/RTL/international scripts. | #_URL_DIRECTION=auto |
URL_OPACITY |
URL Opacity | range | multiplier | 0.92 |
min: 0 · max: 1 · step: 0.01 | URL opacity; export remains WYSIWYG. | #_URL_OPACITY=0.92 |
URL_SCALE |
URL Scale | range | multiplier | 1 |
min: 0.35 · max: 3 · step: 0.01 | URL text scale as proportional multiplier. | #_URL_SCALE=1 |
URL_TEXT_ALIGN |
URL Justify | select | choice | left |
left | center | right | URL text justification. | #_URL_TEXT_ALIGN=left |
URL_WIDTH |
URL Width | range | percent | 100 |
min: 20 · max: 100 · step: 1 | Maximum URL text lane width. | #_URL_WIDTH=100 |
URL_X |
URL X | range | percent | 0 |
min: 0 · max: 100 · step: 1 | URL lane horizontal anchor. | #_URL_X=0 |
URL_Y |
URL Y | range | percent | 100 |
min: 0 · max: 100 · step: 1 | URL lane vertical anchor. | #_URL_Y=100 |
Word Art
6 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
WORD_ART_DIRECTION |
Word Art Direction | select | choice | auto |
auto | ltr | rtl | Word-art text direction for international scripts. | #_WORD_ART_DIRECTION=auto |
WORD_ART_OPACITY |
Word Art Opacity | range | multiplier | 1 |
min: 0 · max: 1 · step: 0.01 | Word-art opacity. | #_WORD_ART_OPACITY=1 |
WORD_ART_SCALE |
Word Art Scale | range | multiplier | 1 |
min: 0.35 · max: 3 · step: 0.01 | Proportional URL word-art scale. | #_WORD_ART_SCALE=1 |
WORD_ART_TEXT_ALIGN |
Word Art Justify | select | choice | center |
left | center | right | Word-art text justification. | #_WORD_ART_TEXT_ALIGN=center |
WORD_ART_X |
Word Art X | range | percent | 50 |
min: 0 · max: 100 · step: 1 | Word-art horizontal anchor. | #_WORD_ART_X=50 |
WORD_ART_Y |
Word Art Y | range | percent | 50 |
min: 0 · max: 100 · step: 1 | Word-art vertical anchor. | #_WORD_ART_Y=50 |
Main
6 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
Download_Format |
Download Format | select | format | "JPG" |
Download image format. | #_Download_Format="JPG" |
|
GRID |
Grid Columns | range | columns | 3 |
min: 1 · max: 9 · step: 1 | Visible grid column count. | #_GRID=3 |
Output_Resolution |
Output Resolution | select | final pixels | "7680x4320" |
Final thumbnail/output design surface. Stable script variable for playlist/config internationalization. | #_Output_Resolution="7680x4320" |
|
SafeAreaProfile |
Safe Area | select | profile | "digital" |
Safe-area profile. Stable script variable; labels can be translated later. | #_SafeAreaProfile="digital" |
|
ShowScrollbar |
Show Scrollbar | checkbox | boolean | false |
Show or hide app-owned scrollbar. | #_ShowScrollbar=false |
|
ViewScaleMode |
Grid Fit | select | mode | "fitAuto" |
Main layout fit mode. Stable script variable; labels can be translated later. | #_ViewScaleMode="fitAuto" |
Pill
6 controllable parameters
| Script Variable | Friendly Label | Type | Unit | Default | Allowed / Limits | Description | Playlist Command |
|---|---|---|---|---|---|---|---|
TYPE_PILL_DIRECTION |
Pill Direction | select | choice | auto |
auto | ltr | rtl | Type pill text direction for international labels. | #_TYPE_PILL_DIRECTION=auto |
TYPE_PILL_JUSTIFY |
Pill Text Justify | select | choice | center |
left | center | right | Type pill text justification. | #_TYPE_PILL_JUSTIFY=center |
TYPE_PILL_OPACITY |
Pill Opacity | range | multiplier | 1 |
min: 0 · max: 1 · step: 0.01 | Type pill opacity. | #_TYPE_PILL_OPACITY=1 |
TYPE_PILL_SCALE |
Pill Scale | range | multiplier | 1 |
min: 0.35 · max: 3 · step: 0.01 | Type pill scale multiplier. | #_TYPE_PILL_SCALE=1 |
TYPE_PILL_X |
Pill X | range | percent | 0 |
min: 0 · max: 100 · step: 1 | Type pill horizontal anchor. | #_TYPE_PILL_X=0 |
TYPE_PILL_Y |
Pill Y | range | percent | 100 |
min: 0 · max: 100 · step: 1 | Type pill vertical anchor. | #_TYPE_PILL_Y=100 |