S.O.K Server
Instale S.O.K en un NAS o un servidor doméstico con Docker y ordene sus descargas desde una página web.
S.O.K Server es el mismo motor que la app, en una imagen Docker con interfaz web. Instálelo en un NAS o un servidor doméstico, indíquele sus carpetas de descargas y ordénelas desde cualquier navegador: identifica cada archivo, muestra los nuevos nombres en una tabla y lo renombra todo de una vez o fila por fila. O deje que ordene las nuevas descargas por sí solo y avise a Discord, Jellyfin o Plex.
Usa enlaces duros por defecto: el archivo renombrado y la descarga son el mismo archivo en el disco, así sus torrents siguen compartiéndose sin ocupar más espacio.
Probar la demo: la interfaz real en su navegador, con una biblioteca de ejemplo. Nada que instalar, y no se renombra ningún archivo.
Instalarlo
S.O.K Server funciona en cualquier equipo con Docker, en Intel/AMD y ARM (amd64, arm64). Cree un docker-compose.yml:
services:
sok-server:
image: ghcr.io/sokteam/sok-server:latest
container_name: sok-server
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/Madrid
volumes:
- /srv/sok/config:/config
- /mnt/storage:/data
ports:
- 8080:8080
restart: unless-stopped
Luego inícielo con docker compose up -d y abra http://<su-servidor>:8080.
| Ajuste | Para qué sirve |
|---|---|
/config |
Los ajustes, la base de datos, el historial y los registros. Guárdelo en un disco con copia de seguridad. |
/data (o la carpeta que quiera) |
Sus descargas y su biblioteca, tal como las ve el servidor. |
PUID, PGID |
El usuario y el grupo con los que se ejecuta el servidor: los archivos que crea les pertenecen. Use los de su usuario del NAS (id en un terminal). |
TZ |
Su zona horaria, para las fechas que se muestran. |
8080:8080 |
El puerto de la interfaz. Cambie el primer número para usar otro. |
Monte una sola carpeta padre, para los enlaces duros
Un enlace duro solo funciona dentro de un mismo montaje. Si sus descargas están en /mnt/storage/downloads y su biblioteca en /mnt/storage/media, monte /mnt/storage una sola vez (/mnt/storage:/data) y use después /data/downloads y /data/media en los ajustes.
Montarlas por separado (/mnt/storage/downloads:/downloads y /mnt/storage/media:/media) crea dos montajes: los enlaces duros fallan entre ellos, incluso en el mismo disco. Los ajustes se lo indican antes de cualquier renombrado.
Primera visita
La primera página le pide crear su cuenta: un nombre de usuario y una contraseña de 8 caracteres o más. La interfaz toma el idioma de su navegador; cámbielo en Ajustes → Apariencia.
Su sesión se mantiene 30 días en ese navegador. Tras 5 contraseñas incorrectas, los siguientes intentos esperan 30 segundos.
¿Ha olvidado la contraseña? Añada SOK_RESET_PASSWORD=1 y su nueva contraseña en SOK_PASSWORD al environment del archivo compose, y reinicie el contenedor (docker compose up -d). Inicie sesión con la nueva contraseña y luego quite las dos líneas. Sus ajustes, su historial y sus elecciones se conservan.
Ajustes
Abra Ajustes en la parte inferior de la barra lateral. Tienen cinco pestañas, y cada cambio se guarda al instante.
- Carpetas: sus carpetas de origen (las descargas) y las carpetas de destino de cada tipo (películas, series, música, libros, juegos). Haga clic en Añadir una carpeta… y escriba la ruta tal como la ve el servidor (
/data/downloads, no la ruta de su NAS), o haga clic en Examinar… para elegirla entre las carpetas del servidor. Con varios destinos para un tipo, cada fila de su pestaña puede elegir uno. Debajo, el modo de archivo: Enlace duro (por defecto), Copiar o Mover. En modo enlace duro, si una carpeta que añade (o el propio modo) hace imposible un enlace duro, una ventana explica por qué y qué cambiar, con un botón para pasar a Copiar; una línea bajo las opciones la vuelve a abrir mientras el problema siga. - Automatización: la clasificación automática y las notificaciones.
- Renombrado: el comportamiento y los formatos de salida, los mismos que en la app (vea Ajustes).
- Claves API: a diferencia de la app, la imagen no tiene clave integrada. TMDB (películas y series) necesita su propia clave, gratuita en themoviedb.org. Deezer, MusicBrainz y Open Library funcionan sin ella. Pegue una clave, haga clic en Guardar y luego en Probar. Las claves se guardan cifradas y no se vuelven a mostrar. Cada tipo tiene su API preferida en la parte superior de su grupo.
- Apariencia: el idioma y el tema: Claro (blanco, como en macOS), Naranja (como en Windows y Linux) u Oscuro. El tema se guarda en cada navegador; Sistema (por defecto) sigue el modo claro u oscuro de su dispositivo, en blanco en Mac y en naranja en los demás.
También puede dar las claves con variables de entorno, como API_KEY_TMDB_V4: aparecen entonces como Definida por una variable de entorno y no se pueden cambiar desde la interfaz.
Analizar sus descargas
En la página Análisis, haga clic en Analizar. S.O.K clasifica los archivos de sus carpetas de origen por tipo y luego busca cada uno; el progreso se muestra en directo, y puede cerrar la página mientras tanto.
Arriba, una franja muestra sus carpetas de origen, el último análisis y la clasificación automática; un problema (una clave que falta, una cuota agotada, una carpeta no encontrada) aparece justo debajo. Después, una tabla da para cada tipo sus archivos y cuántos están Listos, Por elegir y Faltantes: Abrir lleva a su pestaña. Los Archivos por revisar son archivos cuyo tipo es una suposición (una imagen de disco, un vídeo entre episodios…): confirme el tipo o elija otro: el archivo pasa a su pestaña y se busca al momento, y los siguientes análisis lo recuerdan.
Cada nuevo análisis conserva sus elecciones: el resultado, el texto de búsqueda y el destino de una fila que vuelve a encontrar.
Revisar y renombrar
Cada tipo tiene su pestaña, con su modo de archivo y su destino bajo el título. Las filas forman una tabla: el póster, el título y el archivo, el nuevo nombre (en verde cuando está Listo) y el estado. Una fila es una película, una canción, un libro o un juego, o bien toda una serie o todo un álbum con sus archivos; las pestañas sobre la tabla muestran las filas de un estado.
| Estado | Significado |
|---|---|
| Listo | Un único resultado seguro: el título y el año (o el autor, el artista) coinciden. |
| Elige uno | Varios resultados podrían encajar. Haga clic en la fila para verlos, con su póster y su resumen, y elija el correcto. |
| Falta | No se encontró nada. Haga clic en el icono de búsqueda y escriba otro título. |
Bajo el nuevo nombre aparece su carpeta; despliegue una serie para ver cada episodio con su nuevo nombre.
Haga clic en Renombrar los listos, arriba, o marque algunas filas (la casilla del encabezado las marca todas) y haga clic en Renombrar la selección, bajo la tabla. Una confirmación indica el número de archivos y el modo de archivo. Las filas renombradas salen de la tabla; un archivo que no se pudo renombrar se queda en su fila con el motivo.
Los subtítulos siguen a su vídeo (Película.es.srt pasa a Dune (2021).es.srt), como en la app.
Clasificación automática
S.O.K Server puede hacer todo esto por sí solo. En Ajustes → Automatización, active Clasificar automáticamente los archivos nuevos: pide confirmación antes, porque las filas Listo se renombrarán sin usted, también las que ya están en las pestañas.
- Cada 5 minutos (puede cambiarlo, de 1 a 1440), el servidor mira sus carpetas de origen.
- Un archivo se toma una vez terminada su descarga: cuando tiene el mismo tamaño que en la comprobación anterior. Los archivos que aún se están descargando (
.part,.!qB,.crdownload…) se omiten. - Los nuevos archivos terminados lanzan un análisis y luego se renombran las filas Listo. Las filas por elegir, las que faltan y los archivos por revisar le esperan en las pestañas, como tras un clic en Analizar.
- La franja de la página Análisis muestra que está activada y su última clasificación (los archivos renombrados; su última comprobación al pasar el ratón), y lo que la detuvo aparece debajo (un tipo sin carpeta de destino, una clave que falta…).
Todo lo que renombra está en el Historial, marcado como automático, y se puede deshacer como lo demás.
Notificaciones
Tras cada renombrado, manual o automático, S.O.K Server puede avisar a sus otras apps. Configúrelas en Ajustes → Automatización, bajo la clasificación automática, y haga clic en Probar:
| Destino | Qué indicar | Qué hace |
|---|---|---|
| Discord | La dirección de un webhook de un canal (ajustes del canal → Integraciones → Webhooks) | Publica los archivos renombrados |
| Jellyfin | Su dirección (http://jellyfin:8096) y una clave API (Panel de control → Claves de API) |
Actualiza las bibliotecas |
| Plex | Su dirección (http://plex:32400) y su token de Plex |
Actualiza las bibliotecas |
| Webhook | Cualquier dirección | Envía el renombrado en JSON (Home Assistant, n8n…) |
Las direcciones de los webhooks, la clave y el token no se vuelven a mostrar una vez guardados.
Un script también puede ejecutarse tras cada renombrado, con el renombrado en JSON en su entrada y SOK_MEDIA_TYPE, SOK_RENAMED y SOK_AUTO en su entorno. Por seguridad, no se puede configurar desde la página web: ponga el script en una carpeta montada e indique su ruta en el environment del contenedor, por ejemplo SOK_AFTER_RENAME=/config/after-rename.sh.
Historial y deshacer
El Historial lista sus renombrados por día, con su hora, su tipo, sus archivos y su modo de archivo. Deshacer devuelve todos los archivos de un renombrado; abra un renombrado para ver cada archivo con su nuevo nombre, y haga clic en Devolver para devolver un solo archivo (con sus subtítulos).
- Un enlace duro o una copia se elimina: el original nunca se movió.
- Un archivo movido vuelve a su carpeta anterior.
Deshacer nunca sustituye un archivo, como en la app (vea Historial y deshacer).
Archivos ya procesados
Con los enlaces duros, un archivo renombrado se queda en sus descargas. S.O.K lo recuerda y lo excluye de los siguientes análisis, mientras no cambie. La pestaña Ya procesados de la página Historial los lista; marque uno y haga clic en Volver a analizar la selección para renombrarlo otra vez. Un archivo cuyo renombrado se deshizo también se vuelve a analizar.
Actualizar
docker compose pull
docker compose up -d
Sus ajustes, su historial y sus elecciones se conservan en /config.
Detrás de un proxy inverso
S.O.K Server funciona detrás de Nginx, Traefik o Caddy. Si su proxy ya pide un inicio de sesión (Authelia, Authentik…), puede desactivar el inicio de sesión de S.O.K con SOK_AUTH=none: un aviso recuerda entonces que el proxy protege el servidor.