Update SETTINGS.md
This commit is contained in:
WardPearce
+203
-104
@@ -2,54 +2,63 @@
|
|||||||
|
|
||||||
Materialious allows you to customize various settings by overwriting the default values using the environmental variable `VITE_DEFAULT_SETTINGS`.
|
Materialious allows you to customize various settings by overwriting the default values using the environmental variable `VITE_DEFAULT_SETTINGS`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## TOC
|
## TOC
|
||||||
|
|
||||||
- [Materialious Settings](#materialious-settings)
|
* [Materialious Settings](#materialious-settings)
|
||||||
* [Show warning](#Show-Warning)
|
|
||||||
* [Theme](#theme)
|
* [Show Warning](#show-warning)
|
||||||
+ [Dark mode / Light mode](#dark-mode-light-mode)
|
* [Theme](#theme)
|
||||||
+ [Color](#color)
|
* [Dark mode / Light mode](#dark-mode--light-mode)
|
||||||
+ [Amoled](#color)
|
* [Color](#color)
|
||||||
* [Interface](#interface)
|
* [Amoled](#amoled)
|
||||||
+ [Search suggestions](#search-suggestions)
|
* [Interface](#interface)
|
||||||
+ [Region](#region)
|
* [Search suggestions](#search-suggestions)
|
||||||
+ [Letter case for titles](#letter-case-for-titles)
|
* [Region](#region)
|
||||||
+ [Auto expand comments](#auto-expand-comments)
|
* [Letter case for titles](#letter-case-for-titles)
|
||||||
+ [Auto expand description](#auto-expand-desc)
|
* [Auto expand comments](#auto-expand-comments)
|
||||||
+ [Low bandwidth mode](#low-bandwidth-mode)
|
* [Auto expand description](#auto-expand-description)
|
||||||
* [Player](#player)
|
* [Auto expand chapters](#auto-expand-chapters)
|
||||||
+ [Autoplay video](#autoplay-video)
|
* [Low bandwidth mode](#low-bandwidth-mode)
|
||||||
+ [Always loop video](#always-loop-video)
|
* [Display thumbnail avatars](#display-thumbnail-avatars)
|
||||||
+ [Proxy videos](#proxy-videos)
|
* [Default page](#default-page)
|
||||||
+ [Save playback position](#save-playback-position)
|
* [Player](#player)
|
||||||
+ [Theatre mode by default](#theatre-mode-by-default)
|
* [Autoplay video](#autoplay-video)
|
||||||
+ [Autoplay next by default](#autoplay-next-by-default)
|
* [Always loop video](#always-loop-video)
|
||||||
+ [Default video quality](#default-video-quality)
|
* [Proxy videos](#proxy-videos)
|
||||||
* [Sponsorblock](#sponsorblock)
|
* [Save playback position](#save-playback-position)
|
||||||
+ [Sponsor](#sponsor)
|
* [Theatre mode by default](#theatre-mode-by-default)
|
||||||
+ [Unpaid/Self Promotion](#unpaidself-promotion)
|
* [Autoplay next by default](#autoplay-next-by-default)
|
||||||
- [Self Promotion](#self-promotion)
|
* [Default video quality](#default-video-quality)
|
||||||
- [Unpaid Promotion](#unpaid-promotion)
|
* [Default playback speed](#default-playback-speed)
|
||||||
+ [Interaction Reminder (Subscribe)](#interaction-reminder-subscribe)
|
* [Default language](#default-language)
|
||||||
+ [Intermission/Intro Animation](#intermissionintro-animation)
|
* [Captions enabled by default](#captions-enabled-by-default)
|
||||||
+ [Endcards/Credits](#endcardscredits)
|
* [Miniplayer enabled](#miniplayer-enabled)
|
||||||
+ [Preview/Recap/Hook](#previewrecaphook)
|
* [Return YouTube Dislikes](#return-youtube-dislikes)
|
||||||
+ [Filler Tangent/Jokes](#filler-tangentjokes)
|
* [SponsorBlock](#sponsorblock)
|
||||||
+ [Display Toast](#sponsorblockdisplaytoast)
|
* [SponsorBlock enabled](#sponsorblock-enabled)
|
||||||
* [DeArrow](#dearrow)
|
* [SponsorBlock instance](#sponsorblock-instance)
|
||||||
+ [DeArrow Enabled](#dearrow-enabled)
|
* [SponsorBlock categories](#sponsorblock-categories)
|
||||||
+ [DeArrow Instance](#dearrow-instance)
|
* [Display toast](#display-toast)
|
||||||
+ [DeArrow Thumbnail Instance](#dearrow-thumbnail-instance)
|
* [DeArrow](#dearrow)
|
||||||
+ [DeArrow Titles Only](#dearrow-titles-only)
|
* [DeArrow enabled](#dearrow-enabled)
|
||||||
|
* [DeArrow instance](#dearrow-instance)
|
||||||
|
* [DeArrow thumbnail instance](#dearrow-thumbnail-instance)
|
||||||
|
* [DeArrow titles only](#dearrow-titles-only)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Show Warning
|
## Show Warning
|
||||||
|
|
||||||
Show warning about Invidious being blocked.
|
Show a warning about Invidious being blocked.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"showWarning": true
|
"showWarning": true
|
||||||
```
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Theme
|
## Theme
|
||||||
|
|
||||||
### Dark mode / Light mode
|
### Dark mode / Light mode
|
||||||
@@ -68,14 +77,16 @@ Sets the theme color using a hexadecimal value.
|
|||||||
"themeColor": "#ff0000"
|
"themeColor": "#ff0000"
|
||||||
```
|
```
|
||||||
|
|
||||||
## Amoled
|
### Amoled
|
||||||
|
|
||||||
Use pure black theme for Materialious, Dark mode must be true.
|
Use a pure black theme. Dark mode must be enabled.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"amoledTheme": true
|
"amoledTheme": true
|
||||||
```
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Interface
|
## Interface
|
||||||
|
|
||||||
### Search suggestions
|
### Search suggestions
|
||||||
@@ -86,7 +97,6 @@ Enables or disables search suggestions.
|
|||||||
"searchSuggestions": true
|
"searchSuggestions": true
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
### Region
|
### Region
|
||||||
|
|
||||||
Specifies the region using an ISO 3166 country code.
|
Specifies the region using an ISO 3166 country code.
|
||||||
@@ -97,7 +107,14 @@ Specifies the region using an ISO 3166 country code.
|
|||||||
|
|
||||||
### Letter case for titles
|
### Letter case for titles
|
||||||
|
|
||||||
Controls the letter case for titles (e.g., uppercase, lowercase).
|
Controls the letter case for video titles.
|
||||||
|
|
||||||
|
Possible values:
|
||||||
|
|
||||||
|
* `uppercase`
|
||||||
|
* `lowercase`
|
||||||
|
* `sentence case`
|
||||||
|
* `title case`
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"forceCase": "uppercase"
|
"forceCase": "uppercase"
|
||||||
@@ -105,7 +122,7 @@ Controls the letter case for titles (e.g., uppercase, lowercase).
|
|||||||
|
|
||||||
### Auto expand comments
|
### Auto expand comments
|
||||||
|
|
||||||
Automatically expands comments section.
|
Automatically expands the comments section.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"autoExpandComments": true
|
"autoExpandComments": true
|
||||||
@@ -113,26 +130,48 @@ Automatically expands comments section.
|
|||||||
|
|
||||||
### Auto expand description
|
### Auto expand description
|
||||||
|
|
||||||
Automatically expands video descriptions.
|
Automatically expands the video description.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"autoExpandDesc": true
|
"autoExpandDesc": true
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Auto expand chapters
|
||||||
|
|
||||||
|
Automatically expands the chapters list.
|
||||||
|
|
||||||
|
```json
|
||||||
|
"autoExpandChapters": true
|
||||||
|
```
|
||||||
|
|
||||||
### Low bandwidth mode
|
### Low bandwidth mode
|
||||||
|
|
||||||
Avoids loading images.
|
Avoids loading images to reduce bandwidth usage.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"lowBandwidthMode": true
|
"lowBandwidthMode": true
|
||||||
```
|
```
|
||||||
|
|
||||||
### Default quality for videos.
|
### Display thumbnail avatars
|
||||||
|
|
||||||
|
Shows channel avatars on video thumbnails.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"defaultQuality": "1440"
|
"displayThumbnailAvatars": true
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Default page
|
||||||
|
|
||||||
|
Sets the default landing page when opening Materialious.
|
||||||
|
|
||||||
|
```json
|
||||||
|
"defaultPage": "home"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Player
|
||||||
|
|
||||||
### Autoplay video
|
### Autoplay video
|
||||||
|
|
||||||
Controls whether videos autoplay.
|
Controls whether videos autoplay.
|
||||||
@@ -165,116 +204,176 @@ Saves the playback position of videos.
|
|||||||
"savePlaybackPosition": true
|
"savePlaybackPosition": true
|
||||||
```
|
```
|
||||||
|
|
||||||
### Return YT Dislikes
|
### Theatre mode by default
|
||||||
Configures an open-source proxy for the Return YouTube Dislike API, with optional self-hosting.
|
|
||||||
|
Enables theatre mode automatically when starting a video.
|
||||||
|
|
||||||
|
```json
|
||||||
|
"theatreModeByDefault": true
|
||||||
|
```
|
||||||
|
|
||||||
|
### Autoplay next by default
|
||||||
|
|
||||||
|
Automatically plays the next video.
|
||||||
|
|
||||||
|
```json
|
||||||
|
"autoplayNextByDefault": true
|
||||||
|
```
|
||||||
|
|
||||||
|
### Default video quality
|
||||||
|
|
||||||
|
Sets the default video quality.
|
||||||
|
|
||||||
|
Available values include:
|
||||||
|
|
||||||
|
* `auto`
|
||||||
|
* `144`
|
||||||
|
* `240`
|
||||||
|
* `360`
|
||||||
|
* `480`
|
||||||
|
* `720`
|
||||||
|
* `1080`
|
||||||
|
* `1440`
|
||||||
|
* `2160`
|
||||||
|
|
||||||
|
```json
|
||||||
|
"defaultQuality": "1440"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Default playback speed
|
||||||
|
|
||||||
|
Sets the default playback speed.
|
||||||
|
|
||||||
|
```json
|
||||||
|
"defaultPlaybackSpeed": 1
|
||||||
|
```
|
||||||
|
|
||||||
|
### Default language
|
||||||
|
|
||||||
|
Sets the preferred audio language for videos.
|
||||||
|
|
||||||
|
```json
|
||||||
|
"defaultLanguage": true
|
||||||
|
```
|
||||||
|
|
||||||
|
### Captions enabled by default
|
||||||
|
|
||||||
|
Automatically enables captions when available.
|
||||||
|
|
||||||
|
```json
|
||||||
|
"CCByDefault": true
|
||||||
|
```
|
||||||
|
|
||||||
|
### Miniplayer enabled
|
||||||
|
|
||||||
|
Enables the miniplayer feature.
|
||||||
|
|
||||||
|
```json
|
||||||
|
"miniplayerEnabled": true
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Return YouTube Dislikes
|
||||||
|
|
||||||
|
Enables the Return YouTube Dislike integration.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"returnYtDislikes": true
|
"returnYtDislikes": true
|
||||||
```
|
```
|
||||||
|
|
||||||
## Sponsorblock
|
### Return YouTube Dislikes instance
|
||||||
|
|
||||||
Configures Sponsorblock categories for skipping unwanted video segments.
|
Specifies the API instance used for fetching dislike counts.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"sponsorBlockCategories": "sponsor,interaction,selfpromo"
|
"returnYTDislikesInstance": "https://ryd-proxy.materialio.us"
|
||||||
```
|
```
|
||||||
|
|
||||||
### Sponsor
|
---
|
||||||
|
|
||||||
Identifies promotional content within a video.
|
## SponsorBlock
|
||||||
|
|
||||||
|
### SponsorBlock enabled
|
||||||
|
|
||||||
|
Enables SponsorBlock integration.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"sponsorBlockCategories": "sponsor"
|
"sponsorBlock": false
|
||||||
```
|
```
|
||||||
|
|
||||||
### Unpaid/Self Promotion
|
### SponsorBlock instance
|
||||||
|
|
||||||
Includes categories for unpaid and self-promotion.
|
Specifies the SponsorBlock API instance.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"sponsorBlockCategories": "selfpromo"
|
"sponsorBlockUrl": "https://sponsor.ajay.app"
|
||||||
```
|
```
|
||||||
|
|
||||||
### Interaction Reminder (Subscribe)
|
<!--### SponsorBlock categories
|
||||||
|
|
||||||
Skips explicit reminders for interactions.
|
Defines which SponsorBlock categories should be skipped.
|
||||||
|
|
||||||
|
Available values include:
|
||||||
|
|
||||||
|
* `sponsor`
|
||||||
|
* `interaction`
|
||||||
|
* `intro`
|
||||||
|
* `outro`
|
||||||
|
* `preview`
|
||||||
|
* `filler`
|
||||||
|
* `selfpromo`
|
||||||
|
* `filler`
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"sponsorBlockCategories": "interaction"
|
"sponsorBlockCategories": [
|
||||||
```
|
"intro",
|
||||||
|
"outro",
|
||||||
|
"interaction"
|
||||||
|
]
|
||||||
|
```-->
|
||||||
|
|
||||||
### Intermission/Intro Animation
|
### Display toast
|
||||||
|
|
||||||
Skips intermission or intro animations.
|
Displays a toast notification when SponsorBlock skips a segment.
|
||||||
|
|
||||||
```json
|
|
||||||
"sponsorBlockCategories": "intro"
|
|
||||||
```
|
|
||||||
|
|
||||||
### Endcards/Credits
|
|
||||||
|
|
||||||
Skips endcards and credits.
|
|
||||||
|
|
||||||
```json
|
|
||||||
"sponsorBlockCategories": "outro"
|
|
||||||
```
|
|
||||||
|
|
||||||
### Preview/Recap/Hook
|
|
||||||
|
|
||||||
Skips previews, recaps, or hooks.
|
|
||||||
|
|
||||||
```json
|
|
||||||
"sponsorBlockCategories": "preview"
|
|
||||||
```
|
|
||||||
|
|
||||||
### Filler Tangent/Jokes
|
|
||||||
|
|
||||||
Skips filler, tangents, or jokes.
|
|
||||||
|
|
||||||
```json
|
|
||||||
"sponsorBlockCategories": "filler"
|
|
||||||
```
|
|
||||||
|
|
||||||
### Display Toast
|
|
||||||
|
|
||||||
Enables or disables displaying a toast notification when Sponsorblock actions occur.
|
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"sponsorBlockDisplayToast": true
|
"sponsorBlockDisplayToast": true
|
||||||
```
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## DeArrow
|
## DeArrow
|
||||||
|
|
||||||
Controls the DeArrow extension for removing sensational elements from YouTube titles and thumbnails.
|
Controls the DeArrow extension for removing sensational elements from YouTube titles and thumbnails.
|
||||||
|
|
||||||
### DeArrow Enabled
|
### DeArrow enabled
|
||||||
|
|
||||||
Enables or disables the DeArrow extension.
|
Enables or disables DeArrow.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"deArrowEnabled": true
|
"deArrowEnabled": true
|
||||||
```
|
```
|
||||||
|
|
||||||
### DeArrow Instance
|
### DeArrow instance
|
||||||
|
|
||||||
Specifies the URL for the DeArrow instance.
|
Specifies the DeArrow API instance.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"deArrowInstance": "https://sponsor.ajay.app"
|
"deArrowInstance": "https://sponsor.ajay.app"
|
||||||
```
|
```
|
||||||
|
|
||||||
### DeArrow Thumbnail Instance
|
### DeArrow thumbnail instance
|
||||||
|
|
||||||
Specifies the URL for the DeArrow thumbnail instance.
|
Specifies the DeArrow thumbnail instance.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"deArrowThumbnailInstance": "https://dearrow-thumb.ajay.app"
|
"deArrowThumbnailInstance": "https://dearrow-thumb.ajay.app"
|
||||||
```
|
```
|
||||||
|
|
||||||
### DeArrow Titles Only
|
### DeArrow titles only
|
||||||
|
|
||||||
Configures DeArrow to only modify titles without changing thumbnails.
|
Only modifies titles and leaves thumbnails unchanged.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
"deArrowTitlesOnly": true
|
"deArrowTitlesOnly": true
|
||||||
|
|||||||
Reference in New Issue
Block a user