Configuring Shoko Server Settings

You've got Shoko Server installed and have done the minimal setup required to get it properly running. Now it's time to learn everything Shoko Server can do for you and if you want, further fine-tune it.


What Are Actions?

By default, all tasks related to maintaining and updating your collection are done automatically. By default, every task runs on a timer, these timers determine how often certain data sets are updated which in most cases, works just fine. However, for various reasons you may need to run one of these tasks manually which is made possible by using an Action. Most actions are comprised of multiple related tasks with the action name relating to the task or tasks it performs.

While manually running task provides a finer control over your collection, there are a few things to remember.

  • Actions are stackable and are added to your queue.
  • The time required to finish a task depends on your collection size and the task itself.
  • Its not possible to cancel a single task, clicking the cancel button will cancel all remaining tasks.
  • The Commands Toolbar at the bottom keeps track of your remaining tasks while showing the tasks being executed.
Shoko Server - Actions Tab

Available Actions

Below are the available Actions that can be run manually along with their description.

Available Actions Description
Run Import Scans your Local and Cloud import folders and adds any new files that are discovered to your collection. If new files are found, all associated tasks are also executed.
Remove Missing Files Scans your Currently Available import folders and will remove all entries in the database that do not have a physical file match. If you have import folders that are shared network drives or external drives, make sure they are accessible by Shoko Server before running this command.
Sync MyList Syncs your collection metadata with your AniDB MyList.
Sync Trakt Collection Syncs your collection metadata with your Trakt account.
Sync Hashes Syncs your files hashes (ED2k, CRC32, MD5, SHA1) with the Web Cache.
Upload Local Votes To AniDB Syncs your votes with AniDB.
Sync Plex Watch Status Syncs your local watch states with your Plex account.
Update All AniDB Series Info Updates all AniDB series information in your collection.
Update All TvDB Info Updates all series TvDB information in your collection.
Update All Trakt Info Updates all Trakt series information in your collection.
Update All Stats Updates all series stats such as watched state and missing files with.
Update All Media Info Updates all technical details about the files in your collection.
Update Images Checks current image settings and updates series images to match. Currently this action will only increase the amount of available images, not decrease them.

What Are Import Folders?

Import Folders are the physical locations of where your files are. This means two things, they must be accessible by Shoko Server and they are always online. If using removable media, make sure its connected before running any import functions or file checking functions to avoid Shoko removing the entries from your collection database.

There are two different Import Folder Systems you can use. The first is Single Folderwhich has Shoko add the contents of the folder to your collection. The second is Drop Source/Destinationwhich has Shoko move files from the Drop Source into the Drop Destination. You can use both of these systems at the same time and/or use them both for the same import folder.

There are two options available for managing Import Folders.

Option Description
Remove Will remove the selected import folder. This will not physically delete the files but will remove them from your collection.
New Folder Allows you to add a new Import Folder for use with Shoko Server.
Shoko Server - Import Folders Tab

How Long Will Importing Take?

This is no simple answer to this question as the time required to import a file varies based on multiple criteria such as the file size, the series it belongs to and the metadata associated with the series. However there is a process every imported file goes through which is detailed below.

1. Hashing The File

The file is first hashed, the amount of time this takes depends on a couple different factors such as the file size, your CPU and the HDD read/write speed that contains the file.

2. Comparing Hash On AniDB

Once the file has been hashed, the hash is sent to AniDB for comparison. If the hash is found on AniDB then the file is associated with the episode the hash belongs to and the series the episode belongs to is added to your collection. If this is a new series, then additional commands are added to the General Worker to pull the needed data for the series from AniDB.

3. Downloading Additional Metadata

If the file belongs to a new series, information related to the series and each episode in the series is downloaded from The TvDB. If additional community sites are enabled, such as Trakt.TV then additional commands are added to the General Worker to update the metadata on your profile on those sites.

Adding A New Import Folder

Click New Folder to add a import folder for your collection.

A new window will open allowing you to specify the import folder's settings. To make things easier and reduce the chance of making a mistake, we recommend clicking the Folder Icon to select the location of the import folder. If your import folders are external hard drives, network drives or hosted on the cloud, make sure to update their locations if they happen to change. Otherwise you'll start to receive errors and depending on the actions you run, the entries for those files in your database could be deleted.

Each Import Folder you add has its own setting that can be configured depending on your setup.

Shoko Server - Add Import Folder
Option Description
Provider The Import Folder type, if you've added a Cloud Account you'll be able to select it otherwise Local File System will be selected by default. Please note, Import Folders are linked to a Single Provider and cannot be used with Import Folders from another Provider.
Import Folder Path The location of the Import Folder, if it's a Local Provider then you'll select the folder and if it's aCloud Provider then you'll select the folder from a list of available folders.
Drop Source An Import Folder marked as a Drop Source will have it's files moved to the folder marked as a Drop Destination. To have Shoko Server moves files automatically from a Drop Source once detected, make sure to enable Watch For New Files for the that Drop Source.
Drop Destination Used in conjunction with at lease one Drop Source. All files will be moved and sorted into the specified Drop Destination with files belonging to the same series automatically grouped up and placed in a new folder with the series named based on your Preferred Language Preference setting. You can only have one Drop Destination per Provider and cannot use Drop Sources from a different Provider.
Watch For New Files An Import Folder marked with Watch For New Files will have any files detected imported into your collection. Useful if use a custom sorting solution and don't want Shoko Server moving your files for you and don't want to have to manually execute Run Import each time you add files to your Import Folder.

Supported Cloud Hosts

We currently support the following cloud hosts. While we cannot guarantee we'll add your cloud host, if it's not listed below you can always request support for it by creating an issue on GitHub.

  • Amazon Cloud Drive
  • Google Drive
  • One Drive

Please make sure to keep the following in mind when using a cloud host.

  • You cannot mix Import Folders from two different cloud accounts.
  • You cannot mix Local Import Folders with Cloud Import Folders.
  • If you remove a Cloud Account, all associated import folders and files will be removed from your database.
  • If the Import Folder option Watch For New Files is selected, the import folder will be checked every 3 minutes for new files.
Shoko Server - Cloud Accounts Tab

Adding A Cloud Host

First click the Add Account button to open the Cloud Accounts window.

Select the Service Provider you'd like to add then assign a Name for the cloud account, you can name it whatever you'd like as it's just used as a reference for you. Once your'e done click the Connect button, you'll be taken to your selected Service Providers website where you'll be asked to login into your account. This is what allows Shoko access to your cloud account, we don't store your username or password nor do you have to input it each time Shoko access your cloud account. Read and follow all prompts, once done click the Save button to add your cloud account.

Shoko Server - Add Cloud Account

What Is An Integrity Check?

A Integrity Check allows you to scan your Import Folders for possible file corruption. Any Import Folders you add to a Integrity Check will have their files rehashed with the new value compared to the original value stored in your database from when the file was first imported. Files that have the same hash value pass and are not marked as corrupted, however files that do not have the same hash valueare marked as corrupted and displayed in the results panel below. With this utility you can replace corrupted files in your collection preventing playback errors from happening in the future.

Managing Previous Integrity Checks

You can view previous integrity checks by click the Drop-Down box and selecting the previous integrity check you'd like to view. You can also delete an integrity check by click the Red X button, you'll be prompted to confirm deletion.

Shoko Server - Integrity Tab

Adding An Integrity Check

Click the Add Integrity Check button to open the Select Import Folders window. Now select the import folders whose files you wish to have checked for possible corruption, once done click the OK button. The integrity check will already be loaded, to start it click the Green Arrow. Depending on how big the import folder is, the integrity check may take some time. You can see how many files are left below along with the status of the integrity check, if you'd like to pause the integrity clicking the Blue Pause button.

Shoko Server - Add Integrity Check

Available Settings

Only a handful of settings are available for configuration in Shoko Server. The rest can be configured either in the Shoko Server Web UI or Shoko Desktop.

Option Description
Server Port The port Shoko Server will use, by default it’s set to 8111.
Image Path The location where Shoko Server will download and store all images. Clicking Set Default will set the path to C:\ProgramData\ShokoServer while clicking Select Custom Folder will allow you to choose a custom location. If using a Custom Location, it cannot be a location where administrative rights are required.
Minimize On Startup If enabled, Shoko Server will start minimized.
Start With Windows If enabled, adds a RegKey that makes Shoko Server start with Windows.
Update AniDB Info Opens the AniDB account window allowing you to update your AniDB login.
Launch Web UI When clicked, will open the Shoko Server Web UI.
Shoko Server - Settings Tab

Shoko Server Web UI

The Shoko Server Web UI is the eventual replacement to the Shoko Server GUI. As its still in development, some functionality present in Shoko Server's GUI is not available in the Web UI. However we highly recommend all users become familiar with the Web UI as it contains additional functionality not available in Shoko Server's GUI.

Learn more about the Shoko Server Web UI.