Logo of the multimedia management software S.O.K

S.O.K

Personal

Active

Born from a simple need, ending digital chaos, S.O.K identifies movies, TV shows, music, books and video games, then renames and files them into a clean library, ready for Plex, Jellyfin and Kodi.

View Project →

Project Genesis

The S.O.K project was born from a mix of post-lockdown boredom and a personal challenge. At the time, a friend was using a multimedia file management software heavily (FileBot), which was becoming increasingly paid over versions. The idea then came to me to create a free alternative for him, taking up the essential features so that he could continue to organize his library without any constraints.

At that time, I was still very new to programming: it had only been a year since I started the NSI specialty in high school, and I only mastered Python. So I had to teach myself to make API requests, handle file processing, and create a graphical interface with Tkinter. S.O.K was one of my very first real projects, and it allowed me to put my first learnings into practice while meeting a concrete need.

Four years later, with much more solid experience in software development, I decided to completely take over the project. I replaced the Tkinter interface with a modern PyQt interface, rethought the software architecture to make it clean, maintainable, and scalable, and added more advanced features, while keeping the initial goal: to offer a free, accessible, and powerful solution for managing a multimedia library.

S.O.K has thus become much more than a simple exercise: it is a personal project that has evolved along with my skills, going from a first artisanal prototype to structured software designed to last.

Technical Choices

Language
Python 3.13, with uv for dependencies
Desktop app
PySide6 (Qt), on Windows, macOS and Linux
Data sources
TMDB, TVDB, Deezer, MusicBrainz, Spotify, Last.fm, Google Books, Open Library, RAWG and IGDB
S.O.K Server
FastAPI API and Svelte web interface, shipped as a Docker image
Packaging
Nuitka, with a Windows installer, a macOS disk image and a Linux AppImage
Publishing
releases generated automatically by GitHub Actions from conventional commits
Showcase site
Astro and TailwindCSS

Project Roadmap

  1. Prototype (2020)

    First version in Python and Tkinter, in high school.

    Completed
  2. First public release (v1.0.0)

    Complete rewrite in PySide6: TV shows, movies, music, books and games identified online, then renamed.

    Completed
  3. Movies in batches (v1.1.0)

    A dedicated movies page, to rename a whole folder at once.

    Completed
  4. Native macOS version (v1.2.0)

    System window, menu bar and appearance, updates through a disk image.

    Completed
  5. Linux version (v1.3.0)

    AppImage for x86-64 and arm64, updated in place.

    Completed
  6. The whole media library (v1.4.0)

    Dropped files sorted by type, books, games and tracks in batches, history with undo, posters for Plex, Jellyfin and Kodi.

    Completed
  7. S.O.K Server (v1.5.0)

    Docker image with a web interface for a NAS or a server, automatic sorting, notifications to Discord, Plex or Jellyfin.

    Completed
  8. A fuller S.O.K Server

    A new season joins its series even when the folder has another name, language of audio and subtitle tracks, lossless MKV conversion, metadata written into the videos.

    Planned
  9. Seedbox and mobile

    Fetching downloads from a seedbox over SFTP, and a mobile app for S.O.K Server.

    Planned