docs/api-env-variables: add local processing & youtube audio envs

This commit is contained in:
wukko 2025-05-06 16:17:45 +06:00
parent 4d582798bf
commit c83ab63ade
No known key found for this signature in database
GPG Key ID: 3E30B3F26C7B4AA2

View File

@ -4,7 +4,7 @@ this document is not final and will expand over time. feel free to improve it!
### general vars ### general vars
| name | default | value example | | name | default | value example |
|:--------------------|:----------|:--------------------------------------| |:-----------------------|:----------|:--------------------------------------|
| API_URL | | `https://api.url.example/` | | API_URL | | `https://api.url.example/` |
| API_PORT | `9000` | `1337` | | API_PORT | `9000` | `1337` |
| COOKIE_PATH | | `/cookies.json` | | COOKIE_PATH | | `/cookies.json` |
@ -12,6 +12,7 @@ this document is not final and will expand over time. feel free to improve it!
| API_INSTANCE_COUNT | | `6` | | API_INSTANCE_COUNT | | `6` |
| API_REDIS_URL | | `redis://localhost:6379` | | API_REDIS_URL | | `redis://localhost:6379` |
| DISABLED_SERVICES | | `bilibili,youtube` | | DISABLED_SERVICES | | `bilibili,youtube` |
| FORCE_LOCAL_PROCESSING | | `always` |
[*view details*](#general) [*view details*](#general)
@ -56,6 +57,7 @@ this document is not final and will expand over time. feel free to improve it!
| CUSTOM_INNERTUBE_CLIENT | `IOS` | | CUSTOM_INNERTUBE_CLIENT | `IOS` |
| YOUTUBE_SESSION_SERVER | `http://localhost:8080/` | | YOUTUBE_SESSION_SERVER | `http://localhost:8080/` |
| YOUTUBE_SESSION_INNERTUBE_CLIENT | `WEB_EMBEDDED` | | YOUTUBE_SESSION_INNERTUBE_CLIENT | `WEB_EMBEDDED` |
| YOUTUBE_ALLOW_BETTER_AUDIO | `1` |
[*view details*](#service-specific) [*view details*](#service-specific)
@ -100,6 +102,13 @@ comma-separated list which disables certain services from being used.
the value is a string of cobalt-supported services. the value is a string of cobalt-supported services.
### FORCE_LOCAL_PROCESSING
the value is a string, either `always` or `session`.
when set to `always`, all requests will be forced to use on-device processing, no matter the preference.
when set to `session`, only requests from session (Bearer token) clients will be forced to use on-device processing.
## networking ## networking
[*jump to the table*](#networking-vars) [*jump to the table*](#networking-vars)
@ -226,3 +235,8 @@ the value is a URL.
innertube client that's compatible with botguard's (web) `poToken` and `visitor_data`. innertube client that's compatible with botguard's (web) `poToken` and `visitor_data`.
the value is a string. the value is a string.
### YOUTUBE_ALLOW_BETTER_AUDIO
when set to `1`, cobalt will try to use higher quality audio if user requests it via `youtubeBetterAudio`. will negatively affect youtube client rate limiting.
the value is a number.