You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: pages/guides/external-tools/komf.mdx
+12-43Lines changed: 12 additions & 43 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ import { Steps } from 'nextra/components'
11
11
* Userscript for in-browser management.
12
12
13
13
<Callouttype="info">
14
-
komf does not have a webui. It's advised to use [the userscript](https://github.com/Snd-R/komf-userscript).
14
+
Komf has a webui that can be used for some configuration but it's advised to use the extension for [chrome](https://chromewebstore.google.com/detail/komf/bhppjldobkpocplgfcimljjhdjgbpdnh) or [firefox](https://addons.mozilla.org/en-US/firefox/addon/komf/).
15
15
</Callout>
16
16
17
17
## Setup
@@ -35,70 +35,39 @@ Fill out your `baseUri` to point to your Kavita install URL and put in your [Kav
35
35
The API key you use will be the user that Komf is logging in as. Make sure that the user has the correct permissions in Kavita to do what you're asking of it.
36
36
</Callout>
37
37
38
-
### Userscript
38
+
### Extension
39
39
40
-
Once you have Komf running with the minimum setup posted above, we need to set up the user script to connect to it.
40
+
Once you have Komf running with the minimum setup posted above, we need to set up the extension to connect to it.
41
41
42
42
<Steps>
43
43
44
44
### Step 1
45
45
46
-
If you don't already have a script manager add-on in your browser, set up [TamperMonkey](https://www.tampermonkey.net/). If you already running a script manager you *should* be able to use it without issue
47
-
but due to subtle differences between the programs it's not always guaranteed.
46
+
Install the extension following one of the links above. The chrome extension should work for chromium based browsers.
48
47
49
-
<Callout type="info">
50
-
Because of [ManifestV3](https://developer.chrome.com/docs/extensions/develop/migrate/what-is-mv3) chrome users need to run the script manager in [Dev Mode](https://www.tampermonkey.net/faq.php#Q209)
51
-
</Callout>
52
-
53
-
54
48
### Step 2
55
49
56
-
Once you have your script manager installed, visit the userscript's [releases page on github](https://github.com/Snd-R/komf-userscript/releases)
50
+
Click on the extension to get a dialogue box.
57
51
58
52
### Step 3
59
53
60
-
Click on `komf.user.js` for the latest release and your script manager should intercept the request.
61
-
62
-
### Step 4
63
-
64
-
Don't modify anything here. Click 'Install'
65
-
66
-
<Callout type="warning">
67
-
Modifying the script directly breaks the auto-update function and will require you to manually set up your includes every time. Just don't change anything here!
68
-
</Callout>
69
-
70
-
71
-
### Step 5
72
-
73
-
After installing the script, open up the script manager. It can usually be found in the top right of your browser where your other add-ons are.
74
-
75
-
### Step 6
76
-
77
-
Go to your script managers 'dashboard' and click on the newly added Komf script.
78
-
79
-
### Step 7
80
-
81
-
Go to the 'Settings' tab of the Komf script. In the `Includes/Excludes` section find `User Includes` and click Add.
82
-
83
-
### Step 8
84
-
85
-
Type in the IP / hostname of your Kavita install. You NEED to include `/*` at the end for the script manager to detect the site.
54
+
Type in the IP / hostname of your Kavita install in Add new Origin.
86
55
87
56
Example:
88
57
```bash
89
-
http://192.168.0.100:5000/*
58
+
http://192.168.0.100:5000
90
59
```
91
-
### Step 9
60
+
### Step 4
92
61
93
-
Once the userscript is set up to recognize your Kavita you can close the script manager and open your Kavita instance.
62
+
Once the extension is set up open or refresh Kavita.
94
63
95
-
### Step 10
64
+
### Step 5
96
65
97
-
Inside your Kavita's browser window, you will now see a jigsaw puzzle piece in the top right corner next to your username. Click on it and put in your IP address of where komf is located. (This is NOT your kavita URL!)
66
+
Inside your Kavita's browser window, you will now see a jigsaw puzzle piece in the top right corner next to your username. Click on it and put in your IP address of where komf is located. (This is NOT your kavita URL!) (Do note that if you use a hostname with SSL you will need to configure komf to use SSL as well otherwise you will have issues with CORS)
98
67
99
68
Press 'Check Connection' to test if the userscript can talk to your Komf backend. If you see a `Connected ✔` then everything is working!
100
69
101
-
### Step 11
70
+
### Step 6
102
71
103
72
Now you can configure the rest of the settings for some directly from here. You can pick your providers, what libraries you want to apply against and any discord notifications to be sent.
0 commit comments