DeArrow

Metadata


Repo	https://github.com/firefox-extensions-declarative/DeArrow-declarative
Extension ID	`deArrow@ajay.app`

Building

Run npm install and then npm run build:firefox.

To create the XPI, run:

npx web-ext build -s dist -a web-ext-artifacts

The XPI will be located in web-ext-artifacts/.

Types

`Keybind`

Keyboard shortcut.

`key`

Key name.
Type: string | null

`code`

Keyboard code.
Type: string | null

`ctrl`

Whether Ctrl is required.
Type: boolean | null

`alt`

Whether Alt is required.
Type: boolean | null

`shift`

Whether Shift is required.
Type: boolean | null

`TitleFormatting`

Title formatting mode.

Type: -1 | 0 | 1 | 2 | 3 | 4

-1: disable
0: capitalize words
1: title case
2: sentence case
3: lower case
4: first letter uppercase

`ThumbnailCacheOption`

How thumbnail cache/server rendering is used.

Type: 0 | 1 | 2

0: disable
1: all pages except watch
2: all pages

`ThumbnailFallbackOption`

Fallback thumbnail source when no custom thumbnail exists.

Type: 0 | 1 | 2 | 3

0: random time
1: blank
2: original
3: auto-generated

`ThumbnailFallbackAutogeneratedOption`

Which YouTube auto-generated thumbnail to prefer.

Type: 0 | 1 | 2

0: start
1: middle
2: end

`CustomConfiguration`

Per-channel override profile.

`name`

Human-readable profile name.
Type: string

`replaceTitles`

Override title replacement behavior.
Type: boolean | null

`replaceThumbnails`

Override thumbnail replacement behavior.
Type: boolean | null

`defaultToCustom`

Override default custom/original display behavior.
Type: boolean | null

`useCrowdsourcedTitles`

Override whether crowdsourced titles are used.
Type: boolean | null

`titleFormatting`

Override title formatting mode.
Type: TitleFormatting | null

`shouldCleanEmojis`

Override emoji cleanup behavior.
Type: boolean | null

`thumbnailFallback`

Override thumbnail fallback mode.
Type: ThumbnailFallbackOption | null

`thumbnailFallbackAutogenerated`

Override auto-generated thumbnail preference.
Type: ThumbnailFallbackAutogeneratedOption | null

Options

`allowExpirements`

Enable experimental features.
Type: boolean
Default: true

Note: key name is misspelled upstream and must stay allowExpirements.

`showDonationLink`

Show donation link.
Type: boolean
Default: true

`showUpsells`

Show upsell UI.
Type: boolean
Default: true

`actAsVip`

When vip is true, submit actions without using VIP powers.
Type: boolean
Default: true

`darkMode`

Use dark mode in extension UI.
Type: boolean
Default: true

`invidiousInstances`

List of Invidious instances.
Type: Array<string>
Default: []

`keepUnsubmitted`

Keep unsubmitted title/thumbnail edits locally.
Type: boolean
Default: true

`keepUnsubmittedInPrivate`

Keep unsubmitted edits in private windows.
Type: boolean
Default: false

`thumbnailSaturationLevel`

Thumbnail saturation percentage.
Type: number
Default: 100

`titleFormatting`

Formatting mode for titles.
Type: TitleFormatting
Default: 1 for English UI, -1 otherwise

`formatCustomTitles`

Apply formatting to custom titles.
Type: boolean
Default: true

`formatOriginalTitles`

Apply formatting to original titles used as fallback.
Type: boolean
Default: true

`shouldCleanEmojis`

Remove decorative/fancy emoji-style text where supported.
Type: boolean
Default: true

`onlyTitleCaseInEnglish`

Restrict title case formatting to English.
Type: boolean
Default: false

`serverAddress`

DeArrow/SponsorBlock API server.
Type: string
Default: value from repo config.json

`thumbnailServerAddress`

Thumbnail cache/render server.
Type: string
Default: value from repo config.json

`fetchTimeout`

Network fetch timeout in milliseconds.
Type: number
Default: 7000

`startLocalRenderTimeout`

Delay before local thumbnail rendering starts, in milliseconds.
Type: number
Default: 2000

`renderTimeout`

Maximum local thumbnail render time in milliseconds.
Type: number
Default: 25000

`thumbnailCacheUse`

How thumbnail cache/server rendering is used.
Type: ThumbnailCacheOption
Default: 2

`showGuidelineHelp`

Show guideline/help UI.
Type: boolean
Default: true

`showInfoAboutRandomThumbnails`

Show onboarding/help UI for random thumbnail fallback behavior.
Type: boolean
Default: false

`thumbnailFallback`

Fallback thumbnail source.
Type: ThumbnailFallbackOption
Default: 0

`thumbnailFallbackAutogenerated`

Preferred auto-generated thumbnail slot.
Type: ThumbnailFallbackAutogeneratedOption
Default: 0

`showLiveCover`

Show live cover thumbnails when appropriate.
Type: boolean
Default: true

`extensionEnabled`

Master enable/disable switch.
Type: boolean
Default: true

`defaultToCustom`

Show custom branding by default.
Type: boolean
Default: true

`alwaysShowShowOriginalButton`

Always show the show-original toggle when branding UI is available.
Type: boolean
Default: false

`showOriginalOnHover`

Show original branding on hover.
Type: boolean
Default: false

`showOriginalOnHoverOfVideo`

Show original branding when hovering the video area.
Type: boolean
Default: false

`showCustomOnHoverIfCasual`

In casual mode, show custom branding on hover.
Type: boolean
Default: false

`replaceTitles`

Enable title replacement.
Type: boolean
Default: true

`replaceThumbnails`

Enable thumbnail replacement.
Type: boolean
Default: true

`useCrowdsourcedTitles`

Prefer crowdsourced titles when available.
Type: boolean
Default: true

`titleMaxLines`

Maximum displayed title lines.
Type: number
Default: 3

`casualMode`

Enable casual mode.
Type: boolean
Default: false

`casualModeSettings`

Minimum vote threshold per casual category.
Type: Record<string, number>
Default: { funny: 1, creative: 1, clever: 1, descriptive: 1, other: 1 }

`showOriginalThumbWhenCasual`

In casual mode, prefer original thumbnails when applicable.
Type: boolean
Default: false

`onlyShowCasualIconForCustom`

Show casual icon only for custom branding.
Type: boolean
Default: false

`formatCasualTitles`

Apply title formatting to casual titles.
Type: boolean
Default: true

`showInfoAboutCasualMode`

Show onboarding/help UI for casual mode.
Type: boolean
Default: true

`channelOverrides`

Map of channel IDs to configuration IDs.
Type: Record<string, string>
Default: {}

`customConfigurations`

Map of configuration IDs to per-channel override profiles.
Type: Record<string, CustomConfiguration>
Default: {}

`showIconForFormattedTitles`

Show indicator for formatted titles.
Type: boolean
Default: true

`countReplacements`

Count replaced titles/thumbnails in stats.
Type: boolean
Default: true

`ignoreAbThumbnails`

Ignore A/B tested thumbnails where detected.
Type: boolean
Default: true

`ignoreTranslatedTitles`

Ignore translated titles where detected.
Type: boolean
Default: false

`hideDetailsWhileFetching`

Hide branding details while fetching data.
Type: boolean
Default: true

`openMenuKey`

Open DeArrow menu keybind.
Type: Keybind
Default: { key: "d", shift: true }

`enableExtensionKey`

Toggle extension enabled/disabled keybind.
Type: Keybind
Default: { key: "e", ctrl: true, shift: true, alt: true }