
S.O.K
PersonalActive
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
Prototype (2020)
First version in Python and Tkinter, in high school.
CompletedFirst public release (v1.0.0)
Complete rewrite in PySide6: TV shows, movies, music, books and games identified online, then renamed.
CompletedMovies in batches (v1.1.0)
A dedicated movies page, to rename a whole folder at once.
CompletedNative macOS version (v1.2.0)
System window, menu bar and appearance, updates through a disk image.
CompletedLinux version (v1.3.0)
AppImage for x86-64 and arm64, updated in place.
CompletedThe 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.
CompletedS.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.
CompletedA 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.
PlannedSeedbox and mobile
Fetching downloads from a seedbox over SFTP, and a mobile app for S.O.K Server.
Planned