Skip to content

Commit ea46dbe

Browse files
committed
Add some information on the setup page about the different methods.
1 parent dc4b69a commit ea46dbe

File tree

1 file changed

+66
-0
lines changed

1 file changed

+66
-0
lines changed

docs/setup/index.md

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,71 @@
11
# Setup
22

3+
## How the hell do I add a theme to my app?
4+
5+
There are a lot of different ways you can add a theme to an app. Some methods works for all apps and others only work for specific apps.
6+
7+
The different categories are:
8+
9+
### Subfiltering
10+
11+
This modifies a webserver response by replacing one specified string by another. This means we can inject a style sheet at the edge and override the CSS that way. This is supported by nginx, caddy and træfik.
12+
13+
Read more [here](#subfilter-method)
14+
15+
This method should always work for all apps.
16+
17+
!!! info
18+
Some apps require a special way to inject the css. This is marked with the ⚠️ icon.
19+
20+
!!! note
21+
If the theme does not have one of the 3 icons (🐳🔥⚙️), this is the method to use.
22+
23+
### ⚙️ Built in CSS support
24+
25+
If the app has the cog icon, the app has native support for changing the CSS. Details on how will be different for each app, and should be described in detail on the app page.
26+
27+
### 🐳 Linuxserver Docker Mods
28+
29+
This is by far the best and simplest way of changing the CSS. Unfortunately not all apps have a linuxserver container so only a handful of apps supports this method. And even if there is a linuxserver container available, it does not mean it supports injecting the CSS.
30+
31+
For example the `linuxserver/overseerr` image does not support it as there are no HTML files to edit. This is a limitation of how the app is built, and not something I can change.
32+
33+
Read more [here](#docker-mods)
34+
35+
### 🔥 Hotio/S6-Overlay Images (V3)
36+
37+
Hotio images do not support docker mods like linuxserver does, but we can mount scripts to the container so they run at startup of the container. and inject the css.
38+
39+
Read more [here](#hotio-containers-s6-overlay-v3-images)
40+
41+
### Stylus Browser Extension
42+
43+
This uses a browser extension to inject the CSS on the client. This means it will only work for for that specific browser session.
44+
45+
Read more [here](#stylus-method)
46+
47+
### Blackberry Theme Installer for Organizr
48+
49+
This provides an easy to use method of using JS to theme your Organizr tabs. This will only work if your Organizr tab is on a subdirectory (does not work with subdomains). These themes will only be applied when viewed within Organizr.
50+
51+
Read more [here](#blackberry-theme-installer-method)
52+
53+
## Selfhosting
54+
55+
You can selfhost all the CSS files instead of loading them from `theme-park.dev`.
56+
57+
Read more [here](#selfhosting)
58+
59+
## Manual download
60+
61+
Click [here](#manually-download) if you want to manually download the css files used in this project.
62+
63+
## More theme options
64+
65+
Community themes are theme options that have been added by community members.
66+
67+
Check them out [here!](/community-themes/)
68+
369
## Methods
470

571
<ul>

0 commit comments

Comments
 (0)