documentation/docs/url-parameters.md
MintMain21 4301bdaafd
Update with all but two URL Parameters (#360)
* Update with quality_dash preference

The documentation has been updated to include the quality_dash preference to enforce preferred quality using dash.

* Added Extend Description

As far as I know, only two URL parameters are missing from here now, VR Mode and Save Player Position. 

I have left these off intentionally because I do not know these option well enough to know what they do, how they work, or if they would be helpful parsed through extensions like Redirector or the URL Parameters Userscript. 

I shall leave these two to be added by an individual more knowledgeable.

* Added `dark_mode=auto` Parameter

* Moved _Player Style_ up to Player parameters

* Update url-parameters.md

How's this?

* Update url-parameters.md

Returned the video player parameters

* Update url-parameters.md
2024-07-01 17:04:44 +02:00

22 KiB
Raw Blame History

URL parameters

A list of URL parameters for Invidious, which can automatically toggle various UI and player settings.

This list is incomplete. You can help by expanding it.

Parameter Setting
Site-wide parameters
Dark mode Configure default theme without setting cookies
dark_mode=true Use dark theme
dark_mode=false Use light theme
dark_mode=auto Use system/browser theme
Thin mode Load HTML, CSS, JS and video elements (disables images)
thin_mode=true Enabled
thin_mode=false Disabled
UI Language Available locales are also listed here
hl=ar Arabic
hl=de German
hl=el Greek
hl=en-US English
hl=eo Esperanto
hl=es Spanish
hl=eu Basque
hl=fr French
hl=is Icelandic
hl=it Italian
hl=nb_NO Norwegian Bokmål
hl=nl Dutch
hl=pl Polish
hl=ru Russian
hl=uk Ukranian
hl=zh-CN Chinese (traditional)
Player parameters Available parameters also listed here
Annotations Show legacy annotations, provided by the Internet Archive
iv_load_policy=1 Show annotations
iv_load_policy=3 Hide annotations
Autoplay Automatically play video on load
autoplay=1 Enabled
autoplay=0 Disabled
Continue When video is done, automatically go to the next related video (similar to YouTubes Autoplay feature)
continue=1 Enabled
continue=0 Disabled
Listen Play only audio portion of video
listen=true Enabled
listen=false Disabled
Local Proxy video streams, equivalent to enabling Proxy videos? in preferences
local=true Enabled
local=false Disabled
Subtitles List of ISO 639-1 language codes (comma-separated)
subtitles=en English (will use auto-generated if native translation is unavailable)
Quality Default player quality
quality=dash DASH
quality=hd720 720p
quality=medium 480p
Quality_DASH Default player quality when using DASH (default is Auto)
quality_dash=auto Automatically change quality based on network conditions
quality_dash=best Automatically use the best quality avalible
quality_dash=### always use desired quality (480, 720, etc).
quality_dash=worst Automatically use the worst quality avalible
Related Videos Show "Related videos" tab on the right-hand side
related_videos=false Disabled
Comments Show comments below the video
comments=false Disabled
Extended Description Extend Video Description by default
extend_desc=true Enabled
Player Style Define how the Video Player looks asthetically
player_style=invidious Invidious, the default
player_style=youtube YouTube, using a centered play button and always visible video control bar
Speed Default player speed, can be any positive number
speed=0.5 Play at 0.5x speed
speed=2 Play at 2x speed
speed=9.34 Play at 9.34x speed
Loop Loop player by default
loop=1 Enabled
loop=0 Disabled
Volume Default player volume, can be any whole number between 0 and 100
volume=10 Play video at 10% volume
Region Provide "hint" (as ISO 3166 country code) for Invidious to load videos from the specified region
region=JP Attempt to load video as if the user were in Japan
region=DE Attempt to load video as if the user were in Germany
Controls Provide player controls
controls=1 Enabled
controls=0 Disabled
Raw Redirect to latest copy of video at the specified quality and optionally proxy video
raw=1 Enabled
raw=0 Disabled
Time controls Control when the player starts and stops playback. Providing loop=1 will only loop the specified section
start=TIME, t=TIME, time_continue=TIME Start playback at TIME seconds into the video. Supports TIME as either an integer specifying seconds or using 12h30m10s22ms syntax. For example, t=12m9s is equivalent to t=729
end=TIME Stop playback at either TIME seconds or using the above mentioned 12h56m10s22ms syntax.
Search parameters
Region Provide "hint" (as ISO 3166 country code) for Invidious to load search results from the specified region
region=JP Attempt to load search results as if the user were in Japan
region=DE Attempt to load search results as if the user were in Germany
Trending parameters
Trending type View trending videos only in a specific category
type=Default Default
type=Music Music
type=Gaming Gaming
type=Movies Movies
Region Provide "hint" (as ISO 3166 country code) for Invidious to load trending videos from the specified region
region=JP Load videos that are trending in Japan
region=DE Load videos that are trending in Germany