mirror of
https://github.com/wukko/cobalt.git
synced 2024-11-14 12:19:59 +00:00
docs: update links and firefox troubleshooting
added a message about firefox 125 supporting clipboard pasting by default. moved screenshots to their own subfolder in docs folder.
This commit is contained in:
parent
b50ad1e4f2
commit
5c4dbb7112
8 changed files with 14 additions and 10 deletions
|
@ -59,7 +59,7 @@ from a successful call to `/api/json`. however, the parameters passed to it are
|
||||||
and **unmodifiable** from your (the api client's) perspective, and can change between versions.
|
and **unmodifiable** from your (the api client's) perspective, and can change between versions.
|
||||||
|
|
||||||
therefore you don't need to worry about what they mean - but if you really want to know, you can
|
therefore you don't need to worry about what they mean - but if you really want to know, you can
|
||||||
[read the source code](../src/modules/stream/manage.js).
|
[read the source code](/src/modules/stream/manage.js).
|
||||||
|
|
||||||
## GET: `/api/serverInfo`
|
## GET: `/api/serverInfo`
|
||||||
returns current basic server info.
|
returns current basic server info.
|
||||||
|
|
BIN
docs/images/troubleshooting/clipboard/config.png
Normal file
BIN
docs/images/troubleshooting/clipboard/config.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 4.1 KiB |
BIN
docs/images/troubleshooting/clipboard/risk.png
Normal file
BIN
docs/images/troubleshooting/clipboard/risk.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 18 KiB |
BIN
docs/images/troubleshooting/clipboard/search.png
Normal file
BIN
docs/images/troubleshooting/clipboard/search.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 6.7 KiB |
BIN
docs/images/troubleshooting/clipboard/toggle.png
Normal file
BIN
docs/images/troubleshooting/clipboard/toggle.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 18 KiB |
BIN
docs/images/troubleshooting/clipboard/toggled.png
Normal file
BIN
docs/images/troubleshooting/clipboard/toggled.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 17 KiB |
|
@ -18,7 +18,7 @@ if you need help with installing docker, follow *only the first step* of these t
|
||||||
```
|
```
|
||||||
i'm using `nano` in this example, it may not be available in your distro. you can use any other text editor.
|
i'm using `nano` in this example, it may not be available in your distro. you can use any other text editor.
|
||||||
|
|
||||||
3. copy and paste the [sample config from here](https://github.com/wukko/cobalt/blob/current/docs/examples/docker-compose.example.yml) for either web or api instance (or both, if you wish) and edit it to your needs.
|
3. copy and paste the [sample config from here](examples/docker-compose.example.yml) for either web or api instance (or both, if you wish) and edit it to your needs.
|
||||||
make sure to replace default URLs with your own or cobalt won't work correctly.
|
make sure to replace default URLs with your own or cobalt won't work correctly.
|
||||||
|
|
||||||
4. finally, start the cobalt container (from cobalt directory):
|
4. finally, start the cobalt container (from cobalt directory):
|
||||||
|
@ -26,7 +26,7 @@ if you need help with installing docker, follow *only the first step* of these t
|
||||||
docker compose up -d
|
docker compose up -d
|
||||||
```
|
```
|
||||||
|
|
||||||
if you want your instance to support services that require authentication to view public content, create `cookies.json` file in the same directory as `docker-compose.yml`. example cookies file [can be found here](https://github.com/wukko/cobalt/blob/current/docs/examples/cookies.example.json).
|
if you want your instance to support services that require authentication to view public content, create `cookies.json` file in the same directory as `docker-compose.yml`. example cookies file [can be found here](examples/cookies.example.json).
|
||||||
|
|
||||||
cobalt package will update automatically thanks to watchtower.
|
cobalt package will update automatically thanks to watchtower.
|
||||||
|
|
||||||
|
|
|
@ -5,29 +5,33 @@
|
||||||
if any issues occur while using cobalt, you can fix many of them yourself. this document aims to provide guides on how to fix most complicated of them.
|
if any issues occur while using cobalt, you can fix many of them yourself. this document aims to provide guides on how to fix most complicated of them.
|
||||||
use wiki navigation on right to jump between solutions.
|
use wiki navigation on right to jump between solutions.
|
||||||
|
|
||||||
## how to fix clipboard pasting in firefox
|
## how to fix clipboard pasting in older versions of firefox
|
||||||
|
```
|
||||||
|
🎉 firefox finally supports pasting by default starting from version 125.
|
||||||
|
|
||||||
|
👍 you don't need to follow this tutorial if you're on the latest version of firefox.
|
||||||
|
```
|
||||||
you can fix this issue by changing a single preference in `about:config`.
|
you can fix this issue by changing a single preference in `about:config`.
|
||||||
|
|
||||||
### steps to enable clipboard functionality
|
### steps to enable clipboard functionality
|
||||||
1. go to `about:config`:
|
1. go to `about:config`:
|
||||||
|
![screenshot showing about:config entered into address bar](images/troubleshooting/clipboard/config.png)
|
||||||
![screenshot showing about:config entered into address bar](https://github.com/wukko/cobalt/assets/71202418/9ad78612-a372-4949-aeac-99dfc41e273c)
|
|
||||||
|
|
||||||
2. if asked, read what firefox has to say and press "accept the risk and continue".
|
2. if asked, read what firefox has to say and press "accept the risk and continue".
|
||||||
⚠ tinkering with other preferences may break your browser. **do not** edit them unless you know what you're doing.
|
⚠ tinkering with other preferences may break your browser. **do not** edit them unless you know what you're doing.
|
||||||
|
|
||||||
![screenshot showing about:config security warning that reads: "proceed with caution. changing advanced configuration preferences can impact firefox performance or security." lower there's a pre-checked checkbox that says: "warn me when i attempt to access these preferences". lowest element is a blue button that says "accept the risk and continue"](https://github.com/wukko/cobalt/assets/71202418/02328729-dbfe-4ea4-b2ca-7bcf1998c2ca)
|
![screenshot showing about:config security warning that reads: "proceed with caution. changing advanced configuration preferences can impact firefox performance or security." lower there's a pre-checked checkbox that says: "warn me when i attempt to access these preferences". lowest element is a blue button that says "accept the risk and continue"](images/troubleshooting/clipboard/risk.png)
|
||||||
|
|
||||||
3. search for `dom.events.asyncClipboard.readText`
|
3. search for `dom.events.asyncClipboard.readText`
|
||||||
|
|
||||||
![screenshot showing "dom.events.asyncclipboard.readtext" entered into search on about:config page](https://github.com/wukko/cobalt/assets/71202418/7c7f7e3c-6a6a-40df-8436-277489e72e0b)
|
![screenshot showing "dom.events.asyncclipboard.readtext" entered into search on about:config page](images/troubleshooting/clipboard/search.png)
|
||||||
|
|
||||||
4. press the toggle button on very right.
|
4. press the toggle button on very right.
|
||||||
|
|
||||||
![screenshot showing "dom.events.asyncclipboard.readtext" preference on about:config page with highlighted toggle button on very right](https://github.com/wukko/cobalt/assets/71202418/b45db18e-f4bf-4f1c-9a8c-f13a63a21335)
|
![screenshot showing "dom.events.asyncclipboard.readtext" preference on about:config page with highlighted toggle button on very right](images/troubleshooting/clipboard/toggle.png)
|
||||||
|
|
||||||
5. "false" should change to "true".
|
5. "false" should change to "true".
|
||||||
|
|
||||||
![screenshot showing "dom.events.asyncclipboard.readtext" preference on about:config page, this one with "true" text highlighted](https://github.com/wukko/cobalt/assets/71202418/4869b4ff-8385-4cd3-ae59-aa2e03a58b5f)
|
![screenshot showing "dom.events.asyncclipboard.readtext" preference on about:config page, this one with "true" text highlighted](images/troubleshooting/clipboard/toggled.png)
|
||||||
|
|
||||||
6. go back to cobalt, reload the page, press `paste and download` button again. this time it works! enjoy simpler downloading experience :)
|
6. go back to cobalt, reload the page, press `paste and download` button again. this time it works! enjoy simpler downloading experience :)
|
||||||
|
|
Loading…
Reference in a new issue