shoko config - shyonae/selfhosted-anime GitHub Wiki
Before you set up Shoko Server, let's install Shoko Desktop, you can download it here (Download either Daily
or Stable
based on what version of Shoko Server you chose to use). Don't open it for now, we'll configure it later.
- Shoko Desktop is a native Windows application, but there is a way to run it on Linux. Join their discord and check this message.
- The people on the discord are very active and they will help, but be sure to read the pins and search in the support channel if your topic has been asked before.
NOTE: Shoko Desktop can also run on a different machine, as long as it can connect to Shoko Server, it will work.
Follow the steps on the Shoko website to run the first setup and STOP when you arrive at the Import Folders.
- For the
Community Sites
I suggest turning off anything related toThe TvDB
andThe Movie DB
. Also, these are the options I use:
Now let's create some important folders:
- You will have this kind of folder for both
movies-anime
andtv-anime
- Then you will create drop folders for
movies-anime
andtv-anime
In the end, it will look like this:
- Now, why did we have to create these drop folders? Well, you want them as a place to put the hardlinks from the torrent client. You want an intermediate folder because watching your entire anime folder for changes is really resource heavy and there are also kernel limits (RAM / I/O)
Now that you have Shoko opened, head into the Settings
and change the Other Options > Update Channel
to Unstable
and then click on the button above close to the WebUI Version
that says Update available.
- CLOSE the page, open a new one and connect to the server again, you should now have the new UI.
Go to the top right and click the gear icon to go into the Options
, then go to the Import
section and tick everything there so everything is enabled.
Under the AniDB
submenu, put the UDP API Key
found here (under Account
) in the AVDump Key
slot on Shoko, you will use this key to do AVDumps of unrecognized files. There's more info on the discord and on AniDB itself, I would advise you read it before doing anything with unrecognized files.
Before moving to Shoko Desktop, you need to install the LuaRenamer plugin. Just follow the installation steps on the page.
Make sure this plugin is present otherwise your files won't get renamed and moved to the right directories.
Once you open the application, you will need to connect to your Shoko Server instance.
Go to the Utilities
tab, then on the left go to File Renaming
.
In the script section, put the code found in the renamer.lua
file, present in the wiki's repo (thanks to the lovely people on the Shoko Discord server):
- This is where the name you've modified before matters, modify the
-- CUSTOM CONDITION HERE --
with the relevant names, same as the ones in Shoko.
Click on Run this script when importing files into collection
, make sure you've selected LuaRenamer
from the drop-down menu and DONT'T FORGET to click Save
. It should look like this:
And you should be set! Only Jellyfin is missing, at this point you could already try to download an anime and test if everything works thus far (with Autobrr too if you're lucky to catch a release).
- Don't forget to check if hardlinks are working.