Plantillas de nombrado

Cada preset de renombrado en CineRename tiene un idioma: el histórico motor de tokens (sencillo y legible) o un evaluador JavaScript en un entorno aislado (sandbox) para patrones avanzados.

Ajustes → Plantillas de nombrado → botón Tokens / JavaScript encima del editor.

Modo Tokens (por defecto)

Sustitución simple {token} → valor. Cubre la gran mayoría de los casos.

{title} ({year})
{title} - S{season}E{episode} - {episode_title}
{title} - {absolute_episode} - {episode_title}
{title} [{resolution} {video_codec}]

Variables disponibles: {title}, {year}, {season}, {episode}, {absolute_episode}, {episode_title}, {resolution}, {source}, {video_codec}, {audio_codec}, {dynamic_range}, {bit_depth}.

Importar un formato de FileBot

Si vienes de FileBot, el botón Import FileBot format convierte token por token un patrón clásico de Groovy ({n} ({y})/{n} - {s00e00} - {t}) en un patrón de CineRename. Los bloques ${...} o condicionales de Groovy se marcan para que los revises manualmente — o los adaptes al modo JavaScript (ver a continuación).

Modo JavaScript

El patrón se evalúa como una expresión JavaScript en un sandbox integrado de QuickJS:

• Sin acceso al sistema de archivos, red, temporizadores o variables globales peligrosas
• ES2020 completo: ternarios, regex, closures, arrow functions, métodos de cadena, template literals
• El contexto de renombrado se expone como variables globales
• El valor devuelto por la expresión se convierte en el nombre de archivo
• Ultra-rápido: Ejecución inmediata de los scripts sin la sobrecarga de una máquina virtual de Java (a diferencia de FileBot)

Variables expuestas

title, year, season, episode, absolute_episode,
episode_title, resolution, source, video_codec,
audio_codec, dynamic_range, bit_depth, media_kind

Los valores numéricos (year, season, episode, absolute_episode, bit_depth) son números. Los demás son cadenas de texto (strings) o null si no se proporcionan.

Valores típicos de las variables

Para ayudarte a escribir tus condiciones if / else en JavaScript, aquí tienes los valores típicos que devuelve el analizador interno:

Variable	Valores posibles (ejemplos)
resolution	2160p, 1080p, 720p, 480p
video_codec	x264, x265, AV1, MPEG-2
audio_codec	AAC, AC3, EAC3, DTS, DTS-HD MA, TrueHD, FLAC
dynamic_range	SDR, HDR10, HDR10+, Dolby Vision
source	BluRay, WEBRip, WEB-DL, HDTV, DVD

Helpers proporcionados

Helper	Efecto
pad(value, width)	Rellena con ceros un número (ej. pad(2, 3) → "002")
s00e00(season, episode)	Formato "S01E02"
nonEmpty(...args)	Devuelve el primer argumento no vacío
joinNonEmpty(separator, ...args)	Concatena los argumentos no vacíos con un separador

Ejemplos

Concatenación condicional en el rango dinámico:

title + ' (' + year + ')' + (dynamic_range === 'HDR10' ? ' [HDR]' : '')

Reordenamiento "The Wire" → "Wire, The":

title.replace(/^The\s+/, '') + ', The - ' + s00e00(season, episode)

Limpieza de caracteres prohibidos:

title.replace(/[:?]/g, '').trim() + ' (' + year + ')'

Sufijo HD/SD según la resolución:

title + ' [' + (parseInt(resolution) >= 1080 ? 'HD' : 'SD') + ']'

Compatible con Plex y con fallback al título del episodio:

title + ' - ' + s00e00(season, episode) +
  (episode_title ? ' - ' + episode_title : '')

Anime con episodio absoluto y fallback:

title + ' - ' + pad(absolute_episode, 3) +
  joinNonEmpty(' - ', episode_title, resolution)

Seguridad

El sandbox de QuickJS no expone ninguna API de I/O: sin fetch, sin require, sin process, sin Deno, sin setTimeout. El único "efecto secundario" posible es devolver una cadena (o lanzar una excepción, lo que marca la línea para revisión).

Los errores de sintaxis se detectan al guardar: el botón Guardar (Save) valida analizando la expresión antes de persistirla en la base de datos.

Límites

• Sin recursión infinita: QuickJS detiene los bucles demasiado largos, pero en la práctica una plantilla debería ejecutarse en unos pocos µs.
• Sin estado entre llamadas: cada renderizado es un sandbox nuevo — no puedes memorizar un contador entre dos archivos.
• Sin acceso a los demás archivos del lote: una plantilla solo ve su propio contexto.

Para transformaciones que requieran un contexto global (numeración secuencial en todo un lote, etc.), utiliza la CLI envuelta en un script de shell.

Cómo migrar un patrón Groovy de FileBot

FileBot (Groovy)	CineRename (JavaScript)
{n}	title
{y}	year
{s00e00}	s00e00(season, episode)
{t}	episode_title
{vf}	resolution
{vc}	video_codec
{ac}	audio_codec
${audio.lang == 'fr' ? 'VF' : 'VO'}	(audio_codec === 'fr' ? 'VF' : 'VO') ⚠️ Nota: audio_codec es el códec, no el idioma — el idioma de audio no está expuesto por el momento
{n.replaceAll(/X/, 'Y')}	title.replace(/X/g, 'Y')
{n.startsWith('The ') ? n.replaceFirst('^The ', '') + ', The' : n}	title.startsWith('The ') ? title.replace(/^The /, '') + ', The' : title

Símbolos no expuestos

Algunos campos de FileBot (idioma de audio, bitrate, framerate, canales de audio) aún no están expuestos al sandbox de JS en CineRename. Si los necesitas, contáctanos por correo electrónico — podemos añadirlos fácilmente a RenameTemplateContext.