Icône de Jamulus. Redirige vers la page d'accueil
Navigation ouverte

Manuel du logiciel Jamulus

Ce manuel documente l’application client Jamulus destinée aux musiciens et chanteurs qui utilisent le logiciel pour se connecter à un serveur.

Table of contents

Fenêtre principale

Image de la fenêtre principale de Jamulus
Votre mixage local lorsqu'il est connecté à un serveur

Ping, Délai et Gigue

Ping indique la latence de votre réseau en millisecondes, le plus bas étant le mieux. Le temps de ping contribue au délai global (voir ci-dessous). La cause la plus probable d’un ping élevé est que votre distance au serveur est trop grande.

Le délai global est calculé à partir du temps de ping actuel et du délai introduit par les paramètres actuels de la mémoire tampon.

Image d'un symbole diode verte

Vert - Le délai est parfait pour une session de boeuf

Image d'un symbole diode jaune

Jaune - Une session est toujours possible mais elle peut être plus difficile à jouer

Image d'un symbole diode rouge

Rouge - Le délai est trop important pour une session

Gigue indique l’état actuel du flux audio/de la diffusion en continu. Si le voyant est rouge, le flux audio est interrompu. Cela est dû à l’un des problèmes suivants :

  • Le tampon de gigue du réseau n’est pas assez grand pour la gigue actuelle de l’interface réseau/audio.
  • Le délai de la mémoire tampon de la carte son (taille de la mémoire tampon) est trop faible (voir la fenêtre Paramètres).
  • Le débit du flux en amont ou en aval est trop élevé pour votre bande passante Internet.
  • Le CPU du client ou du serveur est à 100%.

Niveau d’entrée

Ceci indique le niveau des deux canaux stéréo de votre entrée audio. Veillez à ne pas écrêter le signal d’entrée afin d’éviter toute distorsion du signal audio (les diodes indiquent l’écrêtage lorsqu’il se produit).

Bouton me silencer

Coupe votre flux audio vers le serveur afin que vous puissiez vous entendre et voir vos propres niveaux d’entrée, mais pas les autres musiciens. Sachez que les autres musiciens ne sauront pas si vous avez coupé votre son.

Effet réverbération

La réverbération peut être appliquée à un canal audio mono local ou aux deux canaux en mode stéréo. La sélection du canal mono et le niveau de réverbération peuvent être modifiés. Par exemple, si un signal de microphone est envoyé sur le canal audio droit de la carte son et qu’un effet de réverbération doit être appliqué, réglez le sélecteur de canal sur la droite et déplacez le chariot vers la droite et déplacez le chariot vers le haut jusqu’à ce que le niveau de réverbération souhaité soit atteint.

Bouton tchate

Le texte saisi dans cette boîte de dialogue est envoyé à tous les clients connectés. Si un nouveau message de tchate arrive et que la boîte de dialogue tchate n’est pas déjà ouverte, elle s’ouvre automatiquement pour tous les clients.

Bouton connecter/déconnecter

Ouvre une boîte de dialogue dans laquelle vous pouvez sélectionner un serveur auquel vous connecter. Si vous êtes connecté, appuyez sur ce bouton pour mettre fin à la session.

Image d'une fenêtre de connexion au serveurs

La fenêtre de configuration de la connexion affiche une liste des serveurs disponibles ainsi que le nombre d’occupants et le nombre maximum supporté. Les opérateurs de serveurs enregistrent leurs serveurs sur des listes (la plupart du temps définies par genre, bien que certaines puissent être spécifiques à un lieu ou pour tous les genres). Utilisez le menu déroulant Liste pour sélectionner un genre, cliquez sur le serveur que vous souhaitez rejoindre et appuyez sur le bouton Connecter pour vous y connecter. Vous pouvez également double-cliquer sur le nom du serveur. Les serveurs permanents (ceux qui sont répertoriés depuis plus de 24 heures) sont affichés en gras.

Vous pouvez filtrer la liste par nom de serveur ou par emplacement. Pour ne répertorier que les serveurs occupés, saisissez le caractère “#”.

Si vous connaissez l’adresse IP ou l’URL d’un serveur privé, vous pouvez vous y connecter en remplissant le champ Nom/adresse du serveur. Un numéro de port facultatif peut être ajouté après l’adresse IP ou l’URL en utilisant deux points comme séparateur, par exemple jamulus.example.com:22124. Le champ affichera également une liste des adresses de serveur les plus récemment utilisées.

Mélangeur audio du serveur

Image d'une paire de commandes de mélangeur de serveur

L’écran du mélangeur audio affiche chaque utilisateur connecté au serveur (y compris vous-même). Les chariots vous permettent de régler le niveau de ce que vous entendez sans affecter ce que les autres entendent.

Le VU-mètre indique le niveau d’entrée sur le serveur, c’est-à-dire le son envoyé.

Si vous avez réglé votre canal audio sur Stéréo ou Sortie stéréo dans vos paramètres, vous verrez également un contrôle de panoramique (shift-cliquer pour le réinitialiser).

Si vous voyez une icône “silencé” au-dessus d’un utilisateur, cela signifie que cette personne ne peut pas vous entendre. Soit il a coupé votre son, soit il a mis en solo un ou plusieurs utilisateurs dont vous ne faites pas parti, soit il a mis votre chariot à zéro dans son mixage.

Bouton grp

Définit un groupe de canaux audio. Déplacer le chariot d’un membre du groupe déplace les chariots de tous les autres. Jusqu’à 8 groupes peuvent être définis.

Bouton MUET

L’utilisation du bouton muet empêche les utilisateurs d’être entendus dans votre mixage local. Sachez que lorsque vous mettez quelqu’un en sourdine, une icône “sourdine” apparaît au-dessus de votre chariot pour indiquer que vous ne pouvez pas l’entendre. Notez également que vous continuerez à voir leurs VU-mètres bouger si le son de l’utilisateur mis en sourdine atteint le serveur. La position de votre chariot pour eux n’est pas affectée non plus.

Notez que le fait de mettre votre propre canal en sourdine signifie simplement que vous n’entendrez pas votre signal du serveur (et n’est pas conseillé car cela peut vous conduire à être en décalage avec les autres musiciens). Ce n’est donc pas la même chose que d’utiliser “Me silencer”.

Bouton solo

Le bouton Solo vous permet d’entendre un ou plusieurs utilisateurs seuls. Ceux qui ne sont pas en solo seront mis en sourdine. Notez également que les personnes qui ne sont pas en solo verront une icône “sourdine” au-dessus de votre chariot.

Les utilisateurs sont répertoriés de gauche à droite dans l’ordre de leur connexion. Vous pouvez modifier l’ordre de tri en utilisant l’option Editer dans le menu de l’application.

Vous pouvez regrouper des utilisateurs à l’aide du bouton “group”. Si vous déplacez le chariot d’un membre du groupe, les autres chariots de ce groupe seront déplacés de la même manière. Vous pouvez isoler temporairement un canal du groupe avec shift-clic-glisser.

Si l’opérateur du serveur a activé l’enregistrement, vous verrez un message au-dessus de la table de mélange indiquant que vous êtes enregistré.

Paramètres

Mon profil

Dans le menu Paramètres, sélectionnez “Mon profil…” pour définir votre alias/nom qui s’affiche sous votre chariot dans la carte de mixage audio du serveur.

Image de la fenêtre de profil

Si un instrument et/ou un pays est défini, les icônes de ces sélections s’affichent également sous votre chariot. Le paramètre de compétence change la couleur de fond de l’étiquette du fader et le nom de la ville s’affiche dans l’info-bulle de l’étiquette du chariot :

Image d'une infobulle montrant les informations du profil

Habillage

Ceci applique un habillage à la fenêtre principale, dont certains sont conçus pour accueillir des ensembles plus importants.

Rangées du mixeur

Ce paramètre définit le nombre de rangées affichées dans le mixeur audio du serveur, pour une utilisation avec de plus grands ensembles.

Configuration audio/réseau

Image de la fenêtre des paramètres audio/réseau

Périphérique

Sous le système d’exploitation Windows, le pilote ASIO (carte son) peut être sélectionné à l’aide de Jamulus. Si le pilote ASIO sélectionné n’est pas valide, un message d’erreur s’affiche et le pilote valide précédent est sélectionné. Sous macOS, le matériel d’entrée et de sortie peut être sélectionné. Sous Linux, Jack est sélectionné automatiquement.

Mappage des canaux d’entrée/sortie

Image du mappage des canaux d'entrée et de sortie

Si le périphérique de la carte son sélectionné offre plus d’un canal d’entrée ou de sortie, les paramètres Input Channel Mapping et Output Channel Mapping sont visibles. Pour chaque canal d’entrée/sortie Jamulus (canal gauche et droit) un canal réel différent de la carte son peut être sélectionné.

Canaux audio

Permet de sélectionner le nombre de canaux audio à utiliser pour la communication entre le client et le serveur.

Note : Il est préférable d’exécuter des instances de client séparées par voix/instrument, avec chaque client ayant son propre fichier ini, plutôt que d’utiliser ce mélangeur intégré de paire mono à stéréo.

Trois modes sont disponibles :

Les modes Mono et Stereo utilisent respectivement un et deux canaux audio.

Mono-in/Stereo-out : Le signal audio envoyé au serveur est mono mais le signal de retour est stéréo. Ceci est utile si la carte son capture un instrument sur un canal d’entrée et un microphone sur l’autre. Dans ce cas les deux signaux d’entrée peuvent être mixés sur un canal mono, mais le mixage du serveur est entendu en stéréo.

L’activation du mode stéréo augmente le débit de données de votre flux. Assurez-vous que votre taux de téléchargement ne dépasse pas la vitesse de téléchargement disponible de votre connexion Internet.

En mode de streaming stéréo, aucune sélection de canal audio pour l’effet de réverbération n’est disponible dans la fenêtre principale car l’effet est appliqué en mode stéréo.

Qualité audio

Plus la qualité audio est élevée, plus le débit de données de votre flux audio est élevé. Assurez-vous que votre taux de téléchargement ne dépasse pas la vitesse de téléchargement disponible de votre connexion Internet.

Délai de mise en mémoire tampon

Le paramètre de délai de mise en mémoire tampon est un paramètre fondamental du logiciel Jamulus. Ce paramètre a une influence sur de nombreuses propriétés de la connexion. Trois tailles de tampon sont prises en charge :

  • 64 échantillons Fournit la latence la plus faible mais ne fonctionne pas avec toutes les cartes son.
  • 128 échantillons Le paramètrage préféré. Devrait fonctionner avec la plupart des cartes son disponibles.
  • 256 échantillons Ne doit être utilisé que sur des ordinateurs très lents, ou avec une connexion Internet lente.

Certains pilotes de carte son ne permettent pas de modifier le délai de mise en mémoire tampon à partir du logiciel Jamulus. Dans ce cas, le réglage du délai de mise en mémoire tampon est désactivé et doit être modifié à l’aide du pilote de la carte son. Sous Windows, appuyez sur le bouton ASIO Setup pour ouvrir le panneau de configuration du pilote.

Sous Linux, utilisez l’outil de configuration JACK pour modifier la taille du tampon.

Le délai réel de la mémoire tampon a une influence sur l’état de la connexion, le taux de chargement actuel et le délai global. Plus la taille de la mémoire tampon est faible, plus la probabilité d’un voyant rouge dans l’indicateur d’état (abandons) est élevée et plus le débit de chargement est élevé et plus le délai global est faible.

Le réglage de la mémoire tampon est donc un compromis entre la qualité audio et le délai global.

Tampon de gigue

Le tampon de gigue compense les glissements de temps du réseau et de la carte son. La taille de la mémoire tampon. La taille de la mémoire tampon influe donc sur la qualité du flux audio (nombre d’interruptions) et sur le délai global (plus la mémoire tampon est longue, plus le délai est élevé).

Vous pouvez définir manuellement la taille du tampon de gigue pour votre client local et le serveur distant. Pour le tampon de gigue local, les interruptions du flux audio sont indiquées par le voyant situé sous les curseurs de taille de la mémoire tampon de gigue. Si le voyant passe au rouge, cela signifie qu’il y a eu dépassement de la mémoire tampon et que le flux audio est interrompu.

Le réglage de la mémoire tampon de gigue est donc un compromis entre la qualité audio et le délai global.

Si le paramètre Auto est activé, les mémoires tampon de gigue de votre client local et du serveur distant sont définis automatiquement en fonction des mesures de la gigue temporelle du réseau et de la carte son. Si le contrôle Auto est activé, les faders de taille de la mémoire tampon de gigue sont désactivés (ils ne peuvent pas être déplacés avec la souris).

Activer les petits tampons réseau

Permet la prise en charge de très petits paquets audio réseau. Ceux-ci ne sont utilisés que si le délai de la mémoire tampon de la carte son est inférieur à 128 échantillons. Plus les tampons réseau sont petits, plus la latence audio est faible. Mais dans le même temps, la charge du réseau augmente et la probabilité de pertes audio augmente également.

Débit du flux audio

Dépend de la taille actuelle des paquets audio et du paramètre de compression. Assurez-vous que le débit amont n’est pas supérieur à votre vitesse de téléchargement Internet disponible (vérifiez-le avec un service tel que librespeed.org).

Configuration avancée

Image de la fenêtre paramètres avancés

Adresse du serveur de répertoire personnalisé

Laissez ce champ vide, sauf si vous devez entrer l’adresse d’un serveur annuaire autre que celui par défaut.

Niveau des nouveaux clients

Ce paramètre définit le niveau du chariot d’un client nouvellement connecté en pourcentage. Si un nouvel utilisateur se connecte au serveur actuel, il obtiendra le niveau de chariot initial spécifié si aucun autre niveau de chariot d’une précédente connexion de cet utilisateur n’était déjà enregistré. Vous pouvez définir tous les utilisateurs d’un serveur occupé à ce niveau en utilisant Editer > “Régler tous les chariots sur le niveau d’un nouveau client”.

Amplification de l’entrée

Augmente le gain de votre appareil. Utilisez cette fonction si votre appareil délivre un gain trop faible pour Jamulus.

Protection contre le larsen

Tente de détecter les boucles de retour audio ou les bruits forts dans les trois premières secondes suivant votre connexion à un serveur. Une fois détectée, cette fonction affiche un message et active le bouton “Me silencer” pour vous mettre en sourdine dans votre propre mix.

Balance d’entrée

Contrôle les niveaux relatifs des canaux audio locaux gauche et droit. Pour un signal mono il agit comme un panoramique entre les deux canaux. Par exemple, si un microphone est connecté au canal d’entrée droit et qu’un instrument est connecté au canal d’entrée gauche, la balance d’entrée agit comme un panoramique entre les deux canaux. Un instrument est connecté au canal d’entrée gauche et est beaucoup plus fort que le microphone, déplacez le fader audio pour augmenter le volume relatif du microphone.

Menu commandes

Fichier > Charger/sauvegarder la configuration des canaux du mixeur

Vous pouvez sauvegarder et restaurer le mixage que vous avez pour les répétitions de votre groupe (fader, mute, pan, solo etc.) et le charger à tout moment (même pendant que vous jouez). Le chargement peut également se faire par glisser/déposer dans la fenêtre du mixeur.

Editer > Regler tous les chariots sur le niveau d’un nouveau client

Applique un réglage de chariot unique à chaque canal en fonction de son volume. Utile pour les grands ensembles afin d’obtenir un mixage global raisonnable, bien que des ajustements individuels puissent encore être nécessaires. A appliquer de préférence pendant un échauffement ou une partie uniforme du morceau de musique.

Sauvegarde de Jamulus

Une fois installé et en fonctionnement, vous voudrez peut-être conserver une copie de vos paramètres. Avoir une sauvegarde est toujours une bonne idée, et les fichiers de paramètres ne sont pas rétrocompatibles entre les versions de Jamulus. Ainsi, si vous souhaitez revenir à la version précédente, vous devrez restaurer les paramètres que vous aviez.

Pour trouver votre fichier de paramètres sous Windows, regardez dans le dossier %APPDATA%. Vous trouverez un ou plusieurs fichiers .ini dans un dossier nommé Jamulus.

Pour toutes les autres plateformes, exécutez la commande suivante à partir de la ligne de commande pour trouver leur emplacement :

find ~ -name Jamulus.ini -ls

Points à noter

  • Ne pas sauvegarder ou restaurer les fichiers de paramètres lorsque Jamulus est en cours d’exécution.
  • Il n’est pas recommandé de modifier les fichiers de paramètres à la main (ils ne sont pas conçus pour cela).
  • Vous pouvez rétablir tous les paramètres par défaut en supprimant simplement le fichier de paramètres (après avoir fermé Jamulus).

  • Vous pouvez sauvegarder et charger différents réglages du mélangeur en utilisant charger/sauvegarder la configuration des canaux du mixeur et stocker ces fichiers où vous voulez.

Note for macOS users: As of Jamulus 3.8.1, we have a signed installer. This will store the settings in

$HOME/Library/Containers/io.jamulus.Jamulus/Data/.config/Jamulus/

Options de la ligne de commande

La plupart des fonctions courantes de Jamulus peuvent être définies à l’aide de l’interface graphique, mais ces fonctions et d’autres peuvent également être définies à l’aide d’options données dans une fenêtre de terminal. La manière exacte de procéder dépend de votre système d’exploitation.

Par exemple, sous Windows, pour utiliser un fichier de paramètres spécifique, faites un clic droit sur le raccourci de Jamulus et choisissez “Propriétés” > Cible. Ajoutez les arguments nécessaires à Jamulus.exe :

 "C:\Program Files\Jamulus\Jamulus.exe" --inifile "C:\path\to\myinifile.ini"

Pour macOS, démarrez une fenêtre Terminal et exécutez Jamulus avec les options souhaitées comme ceci :

 /Applications/Jamulus.app/Contents/MacOS/Jamulus --inifile "/path/to/myinifile.ini"
  • -M or --mutestream Démarre Jamulus en mode sourdine
  • --mutemyown Me silencer dans mon mixage personnel (mode “headless” seulement)
  • -c or --connect Se connecter à l’adresse du serveur donné au démarrage, format adresse[:port]
  • -j or --nojackconnect Disactive l’auto-connection de JACK
  • --ctrlmidich Canal du contrôleur MIDI à écouter, décalage du numéro de contrôle et numéros CC consécutifs (canaux). Format : canal[;f*][;p*][;s*][;m*] Voir Trucs et astuces
  • --clientname Titre de la fenêtre et nom du client JACK
  • -h ou --help Afficher le texte d’aide
  • -i ou --inifile Définit l’emplacement du fichier d’initialisation (remplace la valeur par défaut)
  • -n ou --nogui Désactiver l’interface graphique (pour une utilisation en mode sans interface graphique)
  • -p ou --port Définit le numéro du port UDP local. La valeur par défaut est 22124
  • -Q ou –qos` Définit la valeur DSCP de la qualité de service. La valeur par défaut est 128. Désactiver avec 0. QoS est ignoré par Windows. Pour l’activer, voir la section ci-dessous
  • -t ou --notranslation Désactiver les traductions de langue de l’interface utilisateur
  • -6 ou --enableipv6 Active l’adressage IPv6 (IPv4 est toujours activé)
  • -v ou --version Affiche les informations sur la version et quitte le système

Qualité de service (QoS)

Jamulus utilise DSCP/CS4 de manière opportuniste pour gérer le gonflement de la mémoire tampon, et utilise une valeur DSCP/CS4 par défaut de 128 (ou 0x80). Cette valeur est compatible avec IPv4 et IPv6. D’autres valeurs peuvent être définies en utilisant l’option -Q, par exemple -Q [0..255] (où 0 désactive la QoS). Cependant, la plupart des gens n’auront pas besoin de le faire.

Utiliser QoS sous Windows

Les paramètres de QoS de Jamulus (y compris la valeur par défaut) n’ont aucun effet sur Windows car le système d’exploitation les ignore. Pour l’activer, vous devez suivre ces instructions. Notez également que vous devrez peut-être répéter cette procédure à chaque mise à jour de Jamulus.

Dans la boîte de recherche à côté du menu Démarrer, tapez : Local Group Policy Editor (entrer)
Dans la nouvelle fenêtre, (cliquer) sur l’icône du menu pour afficher le troisième panneau Actions.
Regardez le premier panneau de l’éditeur de stratégie du groupe local.
 Stratégie de l’ordinateur local
  Configuration
   fenêtres paramètres
    QoS basée sur la stratégie (cliquer)
Regarder le troisieme panneau (Actions) de l’éditeur de stratégie de groupe local
 QoS basée sur la stratégie
  Plus d’actions
   créer une nouvelle stratégie (cliquer)
    nom : Jamulus
    Specifier la valeur DSCP : 32
    suivant
    Cette stratégie QoS s’applique seulement au programme Jamulus.exe
    Suivant
    Suivant
    UDP
    Fin

(Avis : La stratégie de Jamulus dans le panneau central peut être modifiée)

Dites-nous ce que vous pensez de Jamulus - répondez à notre enquête anonyme !

Cette documentation est placée sous Licence Creative Commons. Vous voulez vous impliquer ?