Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

SHRI-Tools

Build & Push Docker Image Build & Release

Node.js Electron Docker Image Release License: SHRITPL v1.0

Applicazione desktop (Electron) per la gestione completa delle release su tracker Unit3D: rinomina file/cartelle secondo le rules del tracker, generazione BBCode, upload integrato e analisi di torrent gia` pubblicati.


Installazione (utente finale)

Scarica l'ultima versione dalla pagina Releases e lancia il file .exe — nessuna installazione richiesta, e` un eseguibile portabile.


Funzioni principali

1. Rinomina file/cartelle

  • Auto-detect di titolo, anno, stagione, episodio dal nome file e dai metadata.
  • Parsing MediaInfo/BDInfo per codec, audio, HDR e sorgente.
  • Rilevamento automatico del tag servizio streaming dal nome originale (NF, AMZN, HMAX, ATVP, DSNP, Paramount+, TIMvision, Rakuten TV, Pluto TV, MUBI, ecc.) — il tag viene sempre preservato nel nome rinominato anche se non selezionato manualmente.
  • Popup disambiguazione formato: quando il formato non è rilevabile dal nome file o da MediaInfo, compare un popup che chiede di selezionare il formato corretto (WEB-DL, WEBRip, Encode, Remux, Full Disc). Se si seleziona Encode viene chiesta anche la sorgente (BluRay, UHD BluRay, WEBRip, DVD, HDTV). Il popup compare anche per contenuti rilevati come Encode che potrebbero essere WEB-DL (es. NF/HMAX).
  • Full Disc Blu-ray/DVD: naming dedicato, regione obbligatoria, gestione della traccia audio italiana e rilevamento del tag gruppo dal nome cartella. Distinzione automatica della sorgente DVD5/DVD9.
  • Tag UHD applicato nel titolo solo per i formati da disco in 2160p.
  • Ordinamento dei tag lingua audio in base alla qualità della traccia.
  • Rinomina automatica dei singoli episodi all'interno delle cartelle di stagioni serie TV.
  • Rilevamento release Scene (srrdb + predb): riconosce automaticamente le release Scene.
  • Correzione automatica di titolo/anno quando il titolo inizia con un anno.
  • Gestione multi-episode (es. S01E01-E02).
  • Anteprima del piano di rinomina prima di applicare.
  • Regole di naming allineate al tracker (vedi docs/RULES.txt).

2. Modalita` Integrata (Upload Wizard)

  • Workflow guidato a step con suggerimento titolo automatico.
  • Generazione BBCode per la descrizione del torrent con footer Generated by SHRI-Tools vX.X.X.
  • Creazione .torrent (tramite create-torrent o mkbrr).
  • Dupe check automatico sul tracker con filtri dedicati.
  • Upload diretto al tracker + invio al client torrent (qBittorrent / Transmission).
  • Compatibile con qBittorrent 5.2.0+ (gestione cookie QBT_SID_<porta>, header CSRF, risposta HTTP 204).
  • Seed immediato: SHRI-Tools rileva la versione WebAPI di qBittorrent e usa skip_checking fino alla WebAPI 2.15.x oppure seedMode dalla WebAPI 2.16.0 (qBittorrent 5.3+). In questo modo i torrent creati da file già presenti possono partire in seeding senza un nuovo controllo hash.
  • Flag upload avanzati nella schermata di conferma: Upload anonimo, Personal release, Coda moderazione, Internal, Refundable, Free (%), Double Upload.
  • Mapping percorsi multipli locale/remoto quando il client gira su un'altra macchina.
  • BBCode con link tracker: la sezione LINKS include IMDb, TMDb e — per le serie TV — TheTVDB.
  • Sezioni Extra Encode: per le release Encode (x264/x265) il wizard chiede se inserire nel BBCode la sorgente (--- SORGENTE ---), la comparazione screen (--- COMPARAZIONE ---, es. link slow.pics) e il log dell'encode (--- ENCODE NOTES ---). Le sezioni compaiono tra RELEASE NOTES e SHOUTOUTS solo quando compilate.
  • La sezione BBCode resta aperta durante la modifica della descrizione.
  • Cartella job: al termine del flusso viene creata automaticamente una cartella <OutputDir>/<Titolo>/ con file a nome fisso:
    • BASE.torrent — torrent generato localmente
    • MEDIAINFO.txt — output MediaInfo completo
    • DEBUG.txt — log diagnostico
    • [SHRI]DESCRIPTION.txt — BBCode della descrizione
    • image_data.json — dati screenshot per ripristino automatico
    • image_urls.txt — URL degli screenshot caricati, uno per riga

3. Analisi Tracker

  • Inserisci un link Unit3D e ottieni:
    • titolo suggerito secondo le rules,
    • MediaInfo sintetico,
    • badge ID meta copiabili,
    • segnalazione mismatch ID,
    • BBCode generato automaticamente dai metadati del torrent analizzato.
  • Al termine dell'analisi si apre il modal BBCode con i tasti:
    • Modifica — abilita la modifica diretta del testo
    • Anteprima — rendering visivo del BBCode
    • Copia — copia negli appunti
  • Il footer del BBCode generato da analisi riporta Edited by SHRI-Tools vX.X.X per distinguerlo da una descrizione creata ex novo.
  • Il pulsante Anteprima BBCode nell'area azioni principali apre lo stesso modal in qualsiasi momento, anche senza passare dall'analisi tracker.

4. Generazione Screenshot

  • Cattura automatica dei frame tramite FFmpeg con tempi ottimizzati.
  • Generazione automatica in background alla selezione del file/cartella, senza attendere l'ultimo step del wizard.
  • Supporto HDR con tonemapping HDR → SDR (abilitabile/disabilitabile dalle Impostazioni) e fallback senza tonemap se necessario.
  • Upload su imgBB o PTScreens con fallback automatico.
  • I file screenshot vengono nominati automaticamente con il titolo e l'anno del contenuto (es. Cast_Away_1996_01.png, The_Flash_2022_01.png).
  • Pannello log diagnostico (Impostazioni -> Apri log) per analizzare ogni fase: durata rilevata, calcolo tempi, esito cattura e upload per ogni screen.

Modalita` operative

Modalita` Descrizione
File/Cartella Analisi locale e rinomina
Upload Wizard Integrata Upload completo gestito da SHRI-Tools
Analisi Tracker Analisi torrent gia` presenti sul tracker

Impostazioni (panoramica)

Dalla versione 5.0 le impostazioni sono riorganizzate in sezioni tematiche che seguono il flusso di lavoro.

Generale

  • Lingua preferita: influenza titoli/descrizioni recuperate (es. it-IT).
  • Cartella output job: destinazione di torrent, screenshot e BBCode.

Tracker & Upload (Shareisland / Unit3D)

  • PID announce: passkey per la generazione del .torrent.
  • Base URL: URL del tracker di destinazione.
  • API key: necessaria per upload, analisi e dupe check.
  • Upload anonimo / Personal release / Coda moderazione: flag upload.

Metadata API

  • TMDb key: auto-matching e metadata film/serie.
  • TVDb key: auto-matching per serie/episodi.
  • OMDb key: fallback metadata via IMDb.

Impostazioni di rinomina

  • Lingua nei nomi cartella / file: include o omette il tag lingua.
  • Ometti NoGroup in file/cartelle: non scrive NoGroup nei nomi (resta valido nei titoli).

Screenshot & Image Host

  • Numero screenshot: quanti frame catturare.
  • Tonemapping screenshot HDR → SDR: abilita/disabilita la conversione tonemap sugli screen HDR.
  • Host immagini primario / fallback: imgBB o PTScreens.
  • imgBB key / PTScreens key: API key per l'upload degli screenshot.

Creazione torrent

  • mkbrr path / mkbrr workers: eseguibile e parallelismo per l'hashing.
  • Torrent privato: flag private nel .torrent.

Tools

  • Percorso FFmpeg: necessario per la generazione degli screenshot.
  • Percorso BDInfo: eseguibile BDInfo (per dischi Blu-ray).
  • Percorso mkvpropedit: MKVToolNix per i tag MKV.

I pulsanti Sfoglia per mkbrr, FFmpeg, BDInfo e mkvpropedit mostrano tutti i file su macOS e Linux, inclusi gli eseguibili senza estensione. Su Windows resta predefinito il filtro .exe, con la possibilità di scegliere tutti i file. Su macOS e Linux seleziona il binario dello strumento e assicurati che abbia i permessi di esecuzione.

Client torrent

qBittorrent

  • Host / Porta / HTTPS, Username / Password.
  • Save path, Categoria (supporto categorie multiple separate da virgola), Auto-start.
  • Salta controllo hash (seed immediato): attivo di default; la compatibilità fra skip_checking e seedMode è automatica. Da usare solo quando i file sono già presenti e corrispondono esattamente al torrent (save path e nomi corretti).
  • Mapping percorsi multipli locale/remoto (quando il client e` su altra macchina).

Transmission

  • Host / Porta / HTTPS, Username / Password.
  • Save path, Auto-start.
  • Mapping percorsi multipli locale/remoto.

Impostazioni avanzate

  • Lista servizi: elenco personalizzato servizi streaming per il dropdown.
  • Lista tag gruppo: elenco personalizzato tag gruppo.
  • Auto-detect tag gruppo / Auto-NoGroup / Auto-apply suggerimenti.
  • Override ID Unit3D (category/type/resolution) se l'istanza ha ID diversi dagli standard SHRI.
  • Dettagli path mapping client remoto.

Test

npm test

I test includono la compatibilita` dei parametri di seed immediato con le versioni WebAPI di qBittorrent.


Avvio in modalita` sviluppo

Richiede Node.js 20+ e Git.

git clone https://github.com/tiberio87/SHRI-Tools.git
cd SHRI-Tools
npm install
npm start

Build dell'eseguibile (.exe portabile)

npm run dist

Il file viene generato in dist/SHRI-Tools <versione>.exe.

Le release ufficiali vengono compilate automaticamente da GitHub Actions ad ogni nuovo tag v*.*.* e allegate direttamente alla pagina Releases.


Esecuzione con Docker

Il repository include una configurazione Docker per eseguire l'app Electron in un container Ubuntu 22.04 con:

  • TigerVNC (Xtigervnc + fluxbox) — accesso GUI via client VNC sulla porta 5901;
  • noVNC — accesso GUI via browser sulla porta 6080 (nessuna installazione richiesta);
  • Fluxbox senza wallpaper — la configurazione background: unset viene impostata automaticamente in /data/.fluxbox/overlay, evitando i popup fbsetbg/xmessage anche quando il volume /data e' gia' esistente;
  • ffmpeg, mkvtoolnix installati via apt;
  • mkbrr e bdinfo scaricati automaticamente durante il build come binari di sistema;
  • percorsi degli strumenti preconfigurati automaticamente al primo avvio su Linux.

Build e avvio

Opzione consigliata — immagine pre-buildata (nessun build locale)

docker compose pull && docker compose up -d

L'immagine ufficiale viene pubblicata automaticamente su GitHub Container Registry ad ogni release: ghcr.io/tiberio87/shri-tools:latest.

Opzione alternativa — build locale

docker compose build && docker compose up -d

Per fermare il container:

docker compose down

Accesso alla GUI

Opzione 1 — Browser (consigliata, nessun client richiesto)

Apri http://localhost:6080/vnc.html e clicca Connect.

Opzione 2 — Client VNC

Connettiti a localhost:5901 (o <host>:5901 da un'altra macchina) con qualsiasi client VNC. Non è richiesta password.

Sicurezza: l'accesso VNC non è autenticato. Usare solo in rete locale o privata. Non esporre le porte 5901/6080 su Internet senza un layer di autenticazione (es. reverse proxy con auth, tunnel SSH).

Personalizzazione (volumi, porte, PUID/PGID)

Il file docker-compose.yml è tracciato da git: non modificarlo direttamente, altrimenti ogni git pull potrebbe generare conflitti.

Per personalizzare la configurazione usa il meccanismo di override nativo di Docker Compose:

cp docker-compose.override.yml.example docker-compose.override.yml

Poi modifica docker-compose.override.yml con le tue impostazioni. Il file è già in .gitignore quindi le tue modifiche non interferiranno mai con gli aggiornamenti futuri. Docker Compose lo fonde automaticamente con docker-compose.yml ad ogni docker compose up.

PUID / PGID

Per evitare che i file creati nei volumi siano di proprietà di root sull'host, imposta PUID e PGID con i tuoi UID/GID:

# Trova i tuoi ID
id -u && id -g

Nel file docker-compose.override.yml:

services:
  shri-tools:
    environment:
      - PUID=1000   # sostituisci con il tuo UID
      - PGID=1000   # sostituisci con il tuo GID

Timezone (TZ)

Per avere log e orari coerenti con il tuo fuso orario, imposta la variabile TZ nel file docker-compose.override.yml:

services:
  shri-tools:
    environment:
      - TZ=Europe/Rome

Volumi personalizzati

Host (default) Container Contenuto
./data /data impostazioni Electron e dati sensibili
./media /media file video sorgente da processare
./output /output directory output job (torrent, screenshot, ecc.)

Per usare percorsi diversi (es. NAS) nel file docker-compose.override.yml:

services:
  shri-tools:
    volumes:
      - ./data:/data
      - /mnt/nas/video:/media
      - /mnt/nas/output:/output

Configurazione percorsi nell'app

Al primo avvio i percorsi degli strumenti vengono precompilati automaticamente. In Impostazioni trovi:

Strumento Percorso
FFmpeg /usr/bin/ffmpeg
BDInfo /usr/local/bin/bdinfo
mkbrr /usr/local/bin/mkbrr
mkvpropedit /usr/bin/mkvpropedit

La cartella output torrent va impostata a /output (mappata sul volume host).

Persistenza dati

Le impostazioni Electron vengono salvate in /data (volume ./data), quindi sono persistenti tra i riavvii del container. Le API key e le password vengono archiviate in una store separata cifrata; se l'ambiente supporta safeStorage, Electron usa quello, altrimenti usa un fallback cifrato persistito nel volume.

I segreti non vengono richiesti a ogni avvio finché resta presente il volume ./data. Se vuoi ripartire da zero basta svuotare la cartella ./data sull'host.

Se preferisci controllare esplicitamente la chiave di cifratura del fallback, puoi impostare SHRI_TOOLS_SECRET_KEY nel container.

Nota sul sandbox Electron

Nel container l'app viene avviata con --no-sandbox --disable-gpu, perché il processo Electron gira come utente root nell'immagine Docker e il rendering GPU non è disponibile in ambiente VNC. Questo è normale per un deployment containerizzato.


Diagnostica

In caso di problemi aprire Impostazioni -> Apri log per visualizzare il pannello di debug.


Licenza

Questo progetto e` distribuito sotto la SHRI - Tools Public License (SHRITPL) v1.0.

Testo completo: LICENSE Per gli screenshot, il log riporta in dettaglio: durata video, framerate, calcolo tempi, esito FFmpeg per ogni frame, host e URL di upload.


Documentazione tecnica

  • docs/DEVELOPMENT.md — architettura, flussi e note sviluppo.
  • docs/RULES.txt — regole di naming del tracker.

Note

  • Le impostazioni sono salvate in localStorage del profilo Electron — un reset dei dati dell'app equivale a un reset delle impostazioni.
  • La qualita dei suggerimenti dipende dalla qualita dei nomi file e dei metadata disponibili.

Ringraziamenti

Questo progetto e` un fork di SHRI-Tools creato da @exus85. Grazie per aver sviluppato e condiviso il progetto originale su cui si basa tutto il lavoro qui presente.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages