materialious/docs/SETTINGS.md

Materialious Settings

Materialious allows you to customize various settings by overwriting the default values using the environmental variable VITE_DEFAULT_SETTINGS.

---

TOC

• Materialious Settings

  • Show Warning
  • Theme
    • Dark mode / Light mode
    • Color
    • Amoled
  • Interface
    • Search suggestions
    • Region
    • Letter case for titles
    • Auto expand comments
    • Auto expand description
    • Auto expand chapters
    • Low bandwidth mode
    • Display thumbnail avatars
    • Default page
  • Player
    • Autoplay video
    • Always loop video
    • Proxy videos
    • Save playback position
    • Theatre mode by default
    • Autoplay next by default
    • Default video quality
    • Default playback speed
    • Default language
    • Captions enabled by default
    • Miniplayer enabled
  • Return YouTube Dislikes
  • SponsorBlock
    • SponsorBlock enabled
    • SponsorBlock instance
    • SponsorBlock categories
    • Display toast
  • DeArrow
    • DeArrow enabled
    • DeArrow instance
    • DeArrow thumbnail instance
    • DeArrow titles only

---

Show Warning

Show a warning about Invidious being blocked.

"showWarning": true

---

Theme

Dark mode / Light mode

Controls the background mode of the application.

"darkMode": true

Color

Sets the theme color using a hexadecimal value.

"themeColor": "#ff0000"

Amoled

Use a pure black theme. Dark mode must be enabled.

"amoledTheme": true

---

Interface

Search suggestions

Enables or disables search suggestions.

"searchSuggestions": true

Region

Specifies the region using an ISO 3166 country code.

"region": "US"

Letter case for titles

Controls the letter case for video titles.

Possible values:

• uppercase
• lowercase
• sentence case
• title case

"forceCase": "uppercase"

Auto expand comments

Automatically expands the comments section.

"autoExpandComments": true

Auto expand description

Automatically expands the video description.

"autoExpandDesc": true

Auto expand chapters

Automatically expands the chapters list.

"autoExpandChapters": true

Low bandwidth mode

Avoids loading images to reduce bandwidth usage.

"lowBandwidthMode": true

Display thumbnail avatars

Shows channel avatars on video thumbnails.

"displayThumbnailAvatars": true

Default page

Sets the default landing page when opening Materialious.

"defaultPage": "home"

---

Player

Autoplay video

Controls whether videos autoplay.

"autoPlay": false

Always loop video

Determines if videos should loop automatically.

"alwaysLoop": false

Proxy videos

Enables video proxying to avoid rate limiting by rotating IPs.

"proxyVideos": true

Save playback position

Saves the playback position of videos.

"savePlaybackPosition": true

Theatre mode by default

Enables theatre mode automatically when starting a video.

"theatreModeByDefault": true

Autoplay next by default

Automatically plays the next video.

"autoplayNextByDefault": true

Default video quality

Sets the default video quality.

Available values include:

• auto
• 144
• 240
• 360
• 480
• 720
• 1080
• 1440
• 2160

"defaultQuality": "1440"

Default playback speed

Sets the default playback speed.

"defaultPlaybackSpeed": 1

Default language

Sets the preferred audio language for videos.

"defaultLanguage": true

Captions enabled by default

Automatically enables captions when available.

"CCByDefault": true

Miniplayer enabled

Enables the miniplayer feature.

"miniplayerEnabled": true

---

Return YouTube Dislikes

Enables the Return YouTube Dislike integration.

"returnYtDislikes": true

Return YouTube Dislikes instance

Specifies the API instance used for fetching dislike counts.

"returnYTDislikesInstance": "https://ryd-proxy.materialio.us"

---

SponsorBlock

SponsorBlock enabled

Enables SponsorBlock integration.

"sponsorBlock": false

SponsorBlock instance

Specifies the SponsorBlock API instance.

"sponsorBlockUrl": "https://sponsor.ajay.app"

Display toast

Displays a toast notification when SponsorBlock skips a segment.

"sponsorBlockDisplayToast": true

---

DeArrow

Controls the DeArrow extension for removing sensational elements from YouTube titles and thumbnails.

DeArrow enabled

Enables or disables DeArrow.

"deArrowEnabled": true

DeArrow instance

Specifies the DeArrow API instance.

"deArrowInstance": "https://sponsor.ajay.app"

DeArrow thumbnail instance

Specifies the DeArrow thumbnail instance.

"deArrowThumbnailInstance": "https://dearrow-thumb.ajay.app"

DeArrow titles only

Only modifies titles and leaves thumbnails unchanged.

"deArrowTitlesOnly": true