Getting started
Install S.O.K, take a tour of the interface and organize your first folder.
S.O.K (Storage Organisation Kit) identifies your media files using online databases, then renames and moves them into a clean library that works with Plex, Jellyfin and Kodi.
Installation
S.O.K is available for Windows 10 and 11 (64-bit), macOS on Apple Silicon (M1 or later) and Linux (64-bit, Intel/AMD or ARM).
Windows
- Go to the Download page and download the installer (
SOK_Setup_vX.Y.Z.exe). - Run the installer. You can tick Create a desktop shortcut if you want one.
- Launch S.O.K from the Start menu or from your desktop.
Windows SmartScreen may show a warning the first time you run the installer. Click More info, then Run anyway.
macOS
- Go to the Download page and download the disk image (
SOK_macOS_vX.Y.Z.dmg). - Open the disk image and drag S.O.K onto the Applications folder.
- Launch S.O.K from the Applications folder or from Launchpad.
The first time you open S.O.K, macOS says it cannot verify the developer. Click Done, then open System Settings → Privacy & Security, scroll down and click Open Anyway next to the S.O.K message. Confirm with your password. You only need to do this once.
Linux
S.O.K comes as an AppImage: a single file that runs on most distributions, with nothing to install.
-
Go to the Download page and download the AppImage for your processor:
- Intel/AMD (
SOK_Linux_vX.Y.Z_x86_64.AppImage) for most PCs. - ARM (
SOK_Linux_vX.Y.Z_aarch64.AppImage) for ARM PCs.
Not sure? Run
uname -min a terminal: it printsx86_64oraarch64. - Intel/AMD (
-
Allow the file to run: right-click it in your file manager, open Properties and turn on Allow executing file as program (the wording depends on your desktop). In a terminal:
chmod +x SOK_Linux_*.AppImage. -
Double-click the file to launch S.O.K. It adds itself to your applications menu, so next time you can start it from there.
The Intel/AMD version needs Ubuntu 22.04, Debian 12, Fedora 35 or a more recent distribution. The ARM version needs Ubuntu 24.04, Debian 13, Fedora 40 or more recent.
S.O.K works without any setup: the main databases (TMDB, TVDB) come with a built-in key. You only need an internet connection.
The interface
The window has two areas:
- Sidebar (left): lets you move between pages. Click the menu icon at the top to collapse or expand it.
- Library: Home, TV Shows, Movies, Music, Books, Games
- General: History, Settings
- Main area (right): the page you selected.
Home page
- The drop zone: drop any files or folders on it. S.O.K sorts them by type (movies, TV shows, albums, tracks, books, games) and lists one group per series, per album and per type. Click Open to send a group to its page; when all the files are of one type, its page opens directly. Files whose type is a guess, such as a disc image that can be a game or a video, are listed under To check with the reason: choose their type and click Add.
- Drive monitors shows the free space left on each of your drives (on a Mac, the startup disk and the mounted volumes; on Linux, the system disk and the disks mounted in
/media,/run/mediaor/mnt). The icon turns green when more than 20% is free, orange below 20%, and red below 10%. - Quick access has one card for each media type. Click a card to open its page.
Your first organization
The quickest way to see S.O.K in action is a TV series:
- Open TV Shows in the sidebar.
- Drag and drop the folder with your episodes onto Source folders, or click it to browse.
- S.O.K guesses the series name from the first file and starts a search on its own. If the first result is wrong, type another name and click the right result.
- Drag and drop a folder onto Destination, or click it to browse. This is where your library will be built.
- Check the Preview on the right, then click Organize files and confirm.
A message then shows how many files were organized. On a Mac, it offers to show the destination in the Finder. Click Undo rename if something went wrong: the files go back where they were.
Important: by default, files are moved: they leave the source folder and go to the destination. Choose Hard link or Copy in Settings → Behavior to keep the originals. You can undo a rename from the History page, as long as the files were not moved since.
Next steps
- TV shows: series, seasons and episodes
- Movies: rename a whole folder of movies at once
- Music, books and games
- History and undo: put renamed files back
- Settings: theme, language, name formats, API keys
- FAQ and troubleshooting