Comandi

Tutti i comandi si digitano nel campo di testo di una finestra preceduti da /, oppure si possono usare dentro uno script (alias, evento, popup) senza la barra. Sono gli stessi comandi, con lo stesso comportamento, in entrambi i contesti.

Connessione

Messaggi

CTCP

Il CTCP (Client-To-Client Protocol) è il meccanismo standard IRC con cui due client si scambiano richieste "di servizio" fuori dalla chat normale (versione del client, ping, ora, ecc.). Yoake lo implementa su IRC e, in aggiunta, anche su Telegram e WhatsApp quando ENTRAMBE le parti usano Yoake.

Yoake risponde anche da solo alle richieste CTCP VERSION, PING, TIME e CLIENTINFO che riceve (funzione standard del protocollo IRC client-to-client, lo stesso che fa il vero mIRC) - su IRC la risposta parte come NOTICE, mai mostrata nella finestra del canale/query (esattamente come nel vero mIRC), con solo una riga di log in Status.

Away / ignore

Chiamate in arrivo

Nostra aggiunta - il vero mIRC non ha chiamate. Yoake rileva quando arriva una chiamata (audio o video, sia Telegram sia WhatsApp) e la mostra come un messaggio di sistema, ma è solo segnalazione: GramJS/Baileys non implementano affatto l'audio/video vero, non è possibile rispondere per davvero da qui - vedi Scripting per la spiegazione completa.

Twitch

Twitch è una rete a parte, con lo stesso spirito multi-account/multi-canale di IRC (più account Twitch insieme, più canali insieme per ciascun account) ma di natura diversa: non è un protocollo testuale come IRC, quindi Yoake non ci parla con un socket ma apre un vero browser incorporato (una finestra Chromium nascosta, una per canale joinato) che replica quello che farebbe una persona vera sul sito twitch.tv. Login, chat, nicklist ed elenco canali dipendono quindi dal sito reale di Twitch, non da un server dedicato - vedi Connessione per come funziona il login.

Stato / Storie

Nostra aggiunta - il vero mIRC non ha nulla di equivalente (non esiste un concetto di "stato" su IRC).

Salvataggio foto/video

Tasto destro su una foto o un video aperti nel visualizzatore: due opzioni, "Salva con nome..." (apre la scelta file, decidi tu dove) o "Salva nella cartella predefinita" (salva subito, senza chiedere nulla, come fa il vero mIRC con i file DCC ricevuti). Non c'è rischio di sovrascrivere un file con lo stesso nome: se esiste già, viene aggiunto un numero tra parentesi.

Sticker salvati

Nostra aggiunta - il vero mIRC non ha un concetto di sticker. Nel visualizzatore, tasto destro su un'immagine o uno sticker in arrivo e "Salva come sticker": funziona su qualunque immagine, non solo su un vero sticker ricevuto (come "converti in sticker" dei client ufficiali). Ctrl+K per gli sticker è Ctrl+S: apre l'elenco di quelli salvati direttamente sopra la casella di testo di qualunque finestra (stesso posto del selettore emoji) - un click ne manda subito uno alla chat aperta (non lo inserisce nel testo, come cliccare uno sticker nei client ufficiali), la crocetta in alto a destra di ognuno lo elimina dall'elenco.

Scarica tutto il set (solo Telegram) - stesso tasto destro nel visualizzatore, ma solo su un vero sticker in arrivo appartenente a un pacchetto: scarica e salva in un colpo solo tutti gli sticker di quel set (come fa il vero client Telegram), pronti nell'elenco Ctrl+S. Su uno sticker "sciolto" (senza un vero pacchetto) o su una foto normale la voce non compare nemmeno.

Playlist video (script)

Nostra aggiunta - il vero mIRC non ha mai avuto video, quindi non ha nulla di equivalente. Pensata per uno script che vuole scorrere un canale/gruppo cercando i video (es. un canale con le puntate di una serie) e riprodurli in sequenza, passando al successivo da solo quando uno finisce.

Vedi $msg() in Identificatori e funzioni per scorrere i messaggi di un canale, e l'evento on videoend in Scripting (scatta da solo quando un video finisce di riprodursi) per un esempio completo di playlist automatica.

Condividi / Inoltra

Nostra aggiunta - il vero mIRC manda i file DCC sempre a un singolo nick scelto a mano nel comando, non ha un vero "inoltra". Ogni foto/video/audio/documento in chat ha un bottone 🔁 Condividi proprio sotto (in modalità testo compare solo dopo averlo aperto almeno una volta, visto che lì non c'è un'anteprima) - apre una finestra con un campo di ricerca e l'elenco di contatti (con numero di telefono, se disponibile) e gruppi/canali di entrambe le reti connesse in questo momento, non solo quella di origine: click su uno per condividere subito.

Se origine e destinatario sono sulla stessa rete, condividere usa l'inoltro nativo di quella rete (lo stesso meccanismo di "Inoltra" nel client ufficiale): il server copia/riusa il messaggio già suo, senza che il file passi di nuovo da qui - più veloce, e per chi riceve compare come un vero inoltro (su Telegram con l'etichetta "Inoltrato da"). Solo quando origine e destinazione sono su reti diverse (es. un video visto su Telegram, mandato a un contatto WhatsApp) si scarica il file e lo si rimanda come un invio nuovo dalla tua parte - l'unico modo possibile in quel caso, dato che nessuna delle due reti può inoltrare verso l'altra. Lo stesso percorso scarica-e-rimanda scatta anche sulla stessa rete se l'inoltro nativo non riesce (es. media troppo vecchio, il riferimento originale non è più disponibile).

Ogni media in modalità testo ha anche un numero univoco nell'etichetta stessa, es. [video33] - serve al comando share per condividerlo senza mouse:

Caricamento script (/load, /unload, /reload)

Documentazione ufficiale mIRC (mirc_commands.html). Sintassi identica al vero mIRC, con una differenza architetturale importante: nel vero mIRC puoi avere tanti file .mrc separati, ciascuno con una sua posizione in un elenco "Scripts"; qui invece alias/eventi/popup vivono già tutti in un unico spazio condiviso (lo stesso motivo per cui, come documentato altrove, un alias scritto in Remote funziona identico a uno scritto nella scheda Aliases). Di conseguenza:

• Il parametro di posizione (-a2, -rs3, ...) viene accettato per compatibilità di sintassi ma ignorato.
• Se il file caricato ridefinisce lo stesso nome di evento già attivo (es. due on start in due file diversi), l'ultimo caricato sovrascrive il precedente - stessa identica regola che vale già oggi dentro un singolo file.
• /load fa scattare on load ma non on start (il vero mIRC li fa scattare entrambi): on start è un evento globale unico, farlo ripartire ad ogni /load creerebbe una ricorsione infinita nel caso d'uso più naturale ("on start { load -rs extra.mrc }" per caricare qualcosa in più all'avvio) - scoperto proprio testando questa funzione.
• -ru (file utenti) non ha equivalente: non esiste un concetto di lista utenti/livelli d'accesso IRC in questa app.
• -pm (popup menu bar) carica correttamente i dati, ma il contesto "menubar" non è ancora collegato a un vero menu visibile nell'interfaccia (limitazione preesistente, non specifica di /load).

Caricare lo stesso file due volte con load lo aggiorna sul posto (come nel vero mIRC) invece di lasciare un doppione. I file caricati con /load restano caricati anche dopo un riavvio dell'app (rilette da Yoake.ini, come il vero mIRC ricorda la sua lista Script), /unload li rimuove anche da lì.

; carica un pacchetto di alias extra all'avvio
on start {
  load -rs C:\Yoake\scripts\extra.mrc
}
; ...più avanti, per toglierlo:
unload -rs C:\Yoake\scripts\extra.mrc

Finestre

Aggiornamenti

Comando specifico di Yoake, non del vero mIRC.

File e suoni

DCC: chat diretta, invio file su IRC, sticker nei canali

Oltre a dcc send qui sopra (invio file, documentazione ufficiale mIRC/DCC), Yoake supporta anche la vera DCC CHAT: una chat diretta su socket TCP fra due macchine, che una volta stabilita non passa più dal server. Su IRC è il protocollo storico vero, compatibile con qualunque altro client IRC reale (mIRC, HexChat, irssi...); su Telegram/WhatsApp la stessa identica socket viene riusata, ma l'invito viaggia "travestito" da messaggio normale (come già fa /ctcp qui sopra) con in più un token di sicurezza, dato che lì non esiste un modello di fiducia preesistente come su IRC - funziona quindi solo Yoake-a-Yoake, mai verso il client ufficiale di un contatto.

Una DCC chat accettata diventa una piccola finestra a sé, con la stessa interfaccia della chat normale (niente nicklist, è una connessione fra due soli interlocutori). Per l'indirizzo da usare nell'invito, Yoake preferisce di default un indirizzo IPv6 pubblico se la macchina ne ha uno (nessun NAT da forare - funziona ormai anche da molte connessioni mobili); se non c'è, ripiega su un indirizzo IPv4 locale, avvisando che probabilmente è raggiungibile solo sulla stessa rete locale, a meno di aver inoltrato una porta a mano sul router.

DCC SEND su IRC. dcc send (vedi tabella "File e suoni" più sopra) ora funziona anche su IRC - prima non era disponibile per niente su questa rete. Stessa sintassi e stessa finestra di avanzamento già usate per Telegram/WhatsApp, ma con una percentuale reale, byte per byte (vera DCC, socket diretta): a differenza di WhatsApp, la cui barra di avanzamento è un'animazione indeterminata perché Baileys non espone un progresso incrementale dell'upload, su IRC il numero mostrato è quindi più preciso. Stessa scelta IPv6/IPv4 e stesso avviso NAT della DCC chat qui sopra.

Sticker e immagini nei canali IRC. Mandare uno sticker/immagine salvata mentre è attiva una finestra di CANALE (non una query privata, che usa invece la dcc send normale) passa da un meccanismo diverso, apposta: la vera DCC è sempre 1-a-1, non può "trasmettersi" a un intero canale - non lo fa nemmeno il vero mIRC, è un limite del protocollo, non una mancanza di Yoake. Qui invece Yoake manda un solo CTCP di annuncio (invenzione nostra, non un sottotipo DCC reale) al canale, con un id di sessione, indirizzo, porta, nome file e dimensione: il server IRC lo ritrasmette da solo a tutti dentro, gratis, come un normale messaggio al canale. Un client IRC vero che non è Yoake lo ignora in silenzio, come qualunque altro CTCP che non riconosce - non vede mai l'immagine. Ogni Yoake nel canale che invece lo riconosce si collega DIRETTAMENTE al mittente (i byte dell'immagine non passano mai dal server) e la scarica da solo, senza bisogno di un "accetta": compare nel canale come un normale sticker, esattamente come su Telegram/WhatsApp. Limite di dimensione: 200KB - oltre viene rifiutata con un avviso invece di mandarla comunque o floodare il canale.

Gestione file (File Handling)

Come nel vero mIRC, servono per leggere/scrivere file di testo dentro gli script (alias, eventi) - non sono comandi pensati per l'uso interattivo in chat, un po' come timer. A ogni file aperto si dà un nome a scelta (<handle>), usato poi per riferirsi a quel file finché non lo chiudi.

Vedi anche Identificatori e funzioni per $fread(), $fgetc(), $feof e $ferr, che servono a leggere il contenuto di un handle aperto.

File binari (Binary Files)

Come nel vero mIRC, lavorano byte per byte invece che per righe di testo (a differenza di fopen/ fwrite sopra). I dati vivono in variabili binarie &nome (array di byte 0-255), distinte dalle normali %variabili di testo - restano finché non fai bunset.

Vedi anche Identificatori e funzioni per $bvar() e $bfind(), che leggono il contenuto di una variabile binaria.

Socket (Sockets)

Come nel vero mIRC, permettono a uno script di parlare direttamente con un server TCP esterno (o riceverne dati), indipendentemente da Telegram/WhatsApp - non sono comandi pensati per l'uso interattivo in chat, come fopen sopra. A ogni connessione si dà un nome a scelta (<name>), usato poi per riferirsi a quel socket.

Vedi anche Identificatori e funzioni per $sock(), e Eventi disponibili per on sockopen/on sockread/on sockclose/on socklisten.

Programmi esterni

Timer e segnali

Variabili e controllo di flusso

Controllo di flusso come nel vero mIRC - niente "for" (non esiste nemmeno lì), solo if/elseif/ else/while/goto. if ed elseif accettano sia il classico blocco su più righe con le graffe, sia un singolo comando su una riga sola senza graffe (stile mIRC classico):

if (a == b) { ... }
elseif (a == c) { ... }
else { ... }

if (%nick == $null) goto done        ; senza graffe: un solo comando, tutta la riga
if (a == b) { ... } elseif (a == c) { ... } else { ... }   ; "} elseif (...) {" sulla stessa riga va bene

while (a < b) { ... }   (max 10000 iterazioni, poi si interrompe da solo)
:etichetta ... goto etichetta

Operatori (documentazione ufficiale mIRC, sezione "If-then-else statements"):

Come nel vero mIRC, ogni operatore a parola (isin, isnum, isop, ecc.) si può negare mettendogli davanti un !, es. if (%x !isin %lista).

Vedi anche Identificatori e funzioni per $nick, $chan, $1-$9 e le funzioni $len()/$calc()/ecc. usabili dentro qualunque comando, e Dialogs per /dialog e /did (finestre personalizzate con bottoni, caselle di testo, liste, tab e menu).