---
title: "Plugin Stream Deck: installazione e connessione - DMXDesktop"
description: "Installa il plugin Stream Deck, attiva il server HTTP e collegalo alla consolle. Cosa significa ogni segno su un tasto e quali azioni richiedono una licenza."
canonical: https://www.dmxdesktop.com/it/knowledgebase/stream-deck-setup
lang: it
source: /it/knowledgebase/stream-deck-setup
---

# Plugin Stream Deck: Configurazione e Connessione

v1.0.52+

Il plugin Stream Deck di DMXDesktop mette a disposizione 34 azioni di illuminazione su un Elgato Stream Deck, così puoi eseguire blackout, effect cues, effect cue stacks, colori e QuickShow dai tasti invece che dal laptop. Questo articolo copre ciò di cui hai bisogno, come installarlo, l'unica impostazione di DMXDesktop da cui dipende e cosa fare quando un tasto o un menu a discesa non funzionano. Per sapere cosa fa ciascuna azione, consulta il [riferimento delle azioni](/it/knowledgebase/stream-deck-actions).

[Scarica DMXDesktop gratuitamente](/it/download) [Consulta i prezzi →](/it/pricing)

## [Cosa ti serve](#cosa-ti-serve)

- **DMXDesktop v1.0.52 o successivo**, in esecuzione, con il suo server HTTP attivato.
- **Stream Deck 7.1 o successivo**, su Windows 10 o successivo, o macOS 12 o successivo.
- Lo Stream Deck e DMXDesktop sulla **stessa rete**. Non devono essere sulla stessa macchina, il che è utile se gestisci il banco da un rack e tieni lo Stream Deck davanti al pubblico.

Il plugin stesso è gratuito. La maggior parte delle sue azioni funziona su qualsiasi licenza DMXDesktop, inclusa quella gratuita; consulta **Requisiti di licenza** qui sotto per i due gruppi che non lo fanno.

## [Attiva il server HTTP](#attiva-il-server-http)

Il plugin comunica con il server HTTP integrato di DMXDesktop, e nulla funziona senza di esso. In DMXDesktop, vai su **Impostazioni** e poi su **DMX I/O**, e attiva il server HTTP.

Questo è lo stesso server che alimenta l'[interfaccia web mobile](/it/mobile-control), quindi se già controlli le luci da un telefono o tablet, è quasi certamente già attivo.

## [Installa il plugin e aggiungi un tasto](#installa-il-plugin-e-aggiungi-un-tasto)

1. Installa il plugin DMXDesktop dal Marketplace Elgato.
2. Trascina qualsiasi azione DMXDesktop su un tasto.
3. Apri le sue impostazioni e scegli cosa dovrebbe controllare. I menu a discesa sono compilati dal tuo impianto, per nome, quindi scegli "Front Wash" invece del gruppo 294.

Solo i gruppi che possono effettivamente eseguire l'azione che hai scelto vengono offerti, quindi un tasto che puoi configurare è un tasto che funzionerà. Lascia il titolo vuoto e il tasto si nomina da solo in base a ciò che controlla; un titolo che digiti non verrà mai sovrascritto.

## [Come funziona la connessione](#come-funziona-la-connessione)

Non c'è nulla da configurare. Il plugin prova l'indirizzo utilizzato l'ultima volta, e se fallisce cerca DMXDesktop sulla rete da solo. Ricorda dove lo ha trovato.

Quando DMXDesktop non è disponibile, i tasti diventano neutrali invece di fingere. Quando torna, riprendono da soli senza essere premuti. Non è necessario riavviare lo Stream Deck o riconfigurare nulla dopo un riavvio del banco.

## [Leggere i segni su un tasto](#leggere-i-segni-su-un-tasto)

Il plugin distingue tre tipi di errore e li evidenzia in modo diverso così puoi capire a colpo d'occhio quale hai.

- **Cerchio e barra blu-grigio disattivato.** DMXDesktop non può essere raggiunto. Non è colpa di nessuno e premere più forte non aiuterà. Si cancella da solo quando il banco torna.
- **Triangolo di avviso rosso.** Il tasto è puntato su qualcosa che non esiste più, ad esempio un effect cue stack o un fader che hai eliminato. Un quadrante mostra MISSING sulla sua striscia. Si cancella da solo quando l'obiettivo torna.
- **Lucchetto.** Il tasto controlla una funzionalità che la tua licenza DMXDesktop non include. Il lucchetto indica la funzionalità e appare prima di premere il tasto piuttosto che dopo.

Un tasto è contrassegnato solo in base a prove positive. Se DMXDesktop non può essere interrogato, nulla è contrassegnato, perché non poter chiedere non è la stessa cosa che sapere che qualcosa è andato.

## [Requisiti di licenza](#requisiti-di-licenza)

La maggior parte del plugin funziona su qualsiasi licenza DMXDesktop, inclusa quella gratuita: controllo dal vivo, effetti speciali, effect cues, QuickShow, sovrascritture di colore e posizione, modifiche dal vivo, dimmer principale, fader macro e i tasti audio e BPM.

- **DJ Mode, DJ Deck e il DJ Crossfader** necessitano di **Standard o superiore**.
- **I tasti Programmatori e i tasti degli effect cue stack** necessitano di **Pro**. Questo copre Programmatori: Cue, Effect Cue Stack (GO), Effect Cue Stack Flash, Programmatori: Funzione, Programmatori: Fader e Effect Cue Stack Level.

Un'eccezione utile: il tasto DJ Mode può ancora *seguire* il banco su una licenza gratuita anche se non può attivarlo, quindi una fila di tasti di stato rimane onesta.

Consulta [i prezzi](/it/pricing) per sapere cosa include ciascun piano.

## [Un menu a discesa vuoto e cosa significa](#un-menu-a-discesa-vuoto-e-cosa-significa)

Se un menu a discesa nelle impostazioni di un tasto è vuoto, il pannello spiega il perché. Ci sono tre cause e non sono le stesse.

1. **DMXDesktop non è raggiungibile**, o il suo server HTTP è spento. Il pannello torna a un campo di testo semplice così puoi comunque configurare il tasto per id se lo conosci, e il tasto funzionerà una volta che il banco sarà tornato.
2. **La tua licenza non lo copre.** I pannelli Programmatori e DJ lo dicono e non offrono *non* un campo di testo, perché un tasto per una funzionalità che non possiedi non può essere fatto funzionare digitando correttamente il nome.
3. **Il tuo impianto non ne ha realmente.** Nessun effect cue stack significa nessun effect cue stack da elencare.

## [Quando qualcosa non funziona](#quando-qualcosa-non-funziona)

Procedi attraverso questi punti in ordine.

1. DMXDesktop è in esecuzione e il suo server HTTP è attivato sotto Impostazioni, DMX I/O?
2. La macchina dello Stream Deck e la macchina di DMXDesktop sono sulla stessa rete e sottorete?
3. Il tasto mostra un segno? Confrontalo con l'elenco sopra prima di presumere un guasto; un lucchetto è una risposta di licenza, non un bug.
4. Riavvia l'applicazione Stream Deck. Memorizza il manifesto del plugin, quindi un aggiornamento della versione a volte richiede questo.

Se non è ancora corretto, il registro del plugin è il modo più veloce per dire cosa è successo. Registra quale banco è stato trovato, se lo stato è stato semeato e quali funzionalità la tua licenza copre. [Contattaci](/it/contact) e ti diremo dove trovare il file di registro più recente per la tua piattaforma.
