Manuel utilisateur

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

Fenêtre principale

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.

Délai affiche la latence globale calculée à partir du temps de ping actuel et du retard introduit par les paramètres actuels du tampon audio. Les diodes lumineuses indiquent l’état de cette situation comme suit :

Vert - Le délai est parfait pour une session de bœuf

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

Rouge - Le délai est trop important pour bœuffer

Gigue indique l’état actuel du flux/diffusion audio 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 montant ou descendant est trop élevé pour votre bande passante Internet.
• Le processeur du client ou du serveur est à 100%.

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 de votre son (les diodes lumineuses 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

Ajoute de la réverbération à votre 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 le haut jusqu’à ce que le niveau de réverbération souhaité soit atteint.

Tchate

Ouvre la fenêtre de tchate. Le texte saisi est envoyé à tous les clients connectés. Si un nouveau message de tchate arrive et que la fenêtre de tchate n’est pas déjà ouverte, elle s’ouvrira automatiquement pour tous les clients. Voir dans les paramètres pour activer optionnellement une alerte sonore lorsqu’un nouveau message de tchate arrive.

Bouton se 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. Vous pouvez également ouvrir la boîte de dialogue en utilisant “Fichier>Configuration de la connexion…”. Vous resterez alors connecté à la session en cours jusqu’à ce que vous en rejoigniez une autre.

La fenêtre de configuration de la connexion affiche une liste des serveurs disponibles avec leurs “distances” (en terme de temps de ping), le nombre d’occupants et le nombre maximum supporté, l’emplacement donné du serveur, et la version du serveur. Les serveurs permanents (ceux qui sont répertoriés depuis plus de 24 heures) sont affichés en gras.

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 opérateurs de serveurs enregistrent leurs serveurs dans des annuaires. Ceux-ci sont soit spécifiques à un genre, soit pour n’importe quel genre, soit des entrées personnalisées supplémentaires. Utilisez le menu déroulant Annuaire pour sélectionner un genre. Vous pouvez filtrer la liste par nom de serveur ou par emplacement. Pour lister uniquement les serveurs occupés, saisissez le caractère “#”. Si vous choisissez “Afficher tous les musiciens”, les occupants actuels seront affichés.

Si vous connaissez le nom d’hôte ou l’adresse IP d’un serveur privé, vous pouvez vous y connecter en remplissant le champ “adresse du serveur”. Un numéro de port facultatif peut être ajouté après l’adresse en utilisant deux points comme séparateur, par exemple jamulus.example.com:22124. (Notez que les adresses IPv6 doivent être entièrement placées entre crochets, par exemple [::1]:22124.) Le champ affichera également une liste des adresses de serveur les plus récemment utilisées. Le bouton qui suit le champ permet de supprimer l’entrée actuelle de la liste.

Mélangeur audio du 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 (MAJ-clic 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 partie, soit il a mis votre chariot à zéro dans son mixage.

Les utilisateurs apparaissent généralement de gauche à droite dans l’ordre où ils se connectent. Lorsque vous rejoignez un serveur qui a déjà des participants, l’ordre par défaut dépend des versions de Jamulus du client et du serveur. Avec une version du client antérieure à 3.12.0 ou une version du serveur antérieure à 3.5.5, les participants existants seront affichés avant votre propre canal. Avec un client de la version 3.12.0 ou ultérieure connecté à un serveur de la version 3.5.5 ou plus récente, votre propre chariot sera affiché en premier, les autres participants existants étant affichés à droite. Dans les deux cas, les participants qui se joindront ultérieurement à la réunion apparaîtront par défaut à droite de tous les participants existants.

Vous pouvez sur-écrire cet ordre et trier par nom, instrument, groupe, ville ou numéro de canal à la place à l’aide du menu Affichage. Voir les commandes de menu ci-dessous.

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

Bouton grp

Vous pouvez regrouper des utilisateurs à l’aide du bouton “groupe”. 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 MàJ-clic-glisser. Il est possible de définir jusqu’à 8 groupes.

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 uniquement que vous n’entendrez pas votre signal revenant 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

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.

Menu commandes

Fichier > Configuration de connexion…

Ouvre la fenêtre de connexion (voir ci-dessus).

Fichier > Charger/sauvegarder la configuration des canaux du mixeur

Vous pouvez enregistrer et restaurer le mixage de votre groupe. Ce mixage stocke vos réglages pour le volume du chariot de chaque personne, le réglage du panoramique, la sourdine et l’état du solo. Vous pouvez charger ce mixage à tout moment (même lorsque vous jouez). Le chargement peut également se faire par glisser/déposer dans la fenêtre de la table de mixage.

Fichier > Quitter

Ferme toutes les fenêtres et quitte l’application.

Éditer > Effacer tous les réglages solo/silence enregistrés

Chaque fois que vous mettez un canal en solo ou en sourdine, Jamulus se souvient de ces paramètres. Même si cette personne quitte et rejoint à nouveau le canal - ou si vous rejoignez un serveur où elle joue - les réglages seront automatiquement appliqués. Utilisez cette commande pour effacer tous ces réglages mémorisés.

Éditer > Régler tous les chariots sur le nouveau niveau du client

Applique la configuration “Niveau des nouveaux clients” à tous les canaux actuellement connectés.

Éditer > Auto-ajustement de tous les chariots

Applique un ajustement 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. À appliquer de préférence pendant un échauffement ou une partie uniforme du morceau de musique.

Affichage > (options de tri)

La plupart des éléments du menu “Affichage” vous permettent d’ajuster l’ordre dans lequel Jamulus choisit d’afficher les canaux sur le serveur :

• Canal personnel en premier
  Cette option peut être utilisée en plus des autres pour que votre propre canal soit toujours le plus à gauche, quel que soit l’ordre de tri des autres canaux.

• Pas de tri par utilisateur
  Cette option ne prend pas en compte les détails de l’utilisateur lors du tri. Le tri se fait selon l’ordre dans lequel les canaux rejoignent le serveur actuel, comme décrit plus haut, les nouveaux canaux étant ajoutés à l’extrémité droite.
• Tri par nom
  Ce tri est effectué en fonction du nom que l’utilisateur a choisi dans son profil.
• Trier par Instrument / Ville
  Permet d’effectuer un tri en fonction de l’instrument ou de la ville que l’utilisateur a choisi dans son profil, ainsi que de son nom.
• Trier par groupe
  Lorsque la fonction de groupe de chariots est utilisée, le tri se fait par numéro de groupe croissante de gauche à droite (et à l’intérieur de celui-ci, par nom), avec tous les canaux non groupés à droite.
• Trier par canal
  Lorsque les contrôles de canaux de Jamulus (chariot, muet, solo, etc) sont contrôlés par MIDI (voir Contrôle MIDI), ceci permet de trier par numéro de canal afin d’assurer un ordre de tri stable qui s’aligne sur les contrôles matériels MIDI. Notez que dans les clients Jamulus antérieurs à la version 3.12.0, les numéros de canaux sont attribués directement par le serveur. Les clients à partir de la version 3.12.0 gèrent leurs propres numéros de canaux et attribuent toujours le canal 0 à l’utilisateur local (à condition que la version du serveur soit au moins la 3.5.5).

Affichage > Tchate

Ouvre la fenêtre de Tchate.

Menu de paramètres

Permet d’accéder directement à chacun des onglets Configurations.

Aide

Permet d’accéder au Guide de démarrage et au Manuel de l’utilisateur (cette page) sur le site web, ainsi qu’aux informations relatives aux droits d’auteur, à la licence et aux précisions de remerciements. Il existe également une option “Qu’est-ce que c’est ?” qui permet d’obtenir plus de détails sur certaines parties de l’affichage du client.

Paramètres

Mon profil

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

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

Thème graphique

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

Style de vu-mètre

Cela modifier le style visuel des indicateurs audio, indépendamment de l’habillage choisi.

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.

Alertes audio

Cette option permet d’activer une alerte sonore lorsqu’une personne rejoint un serveur ou lorsqu’elle reçoit un nouveau message de tchate.

Configuration audio/réseau

Périphérique audio

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édemment est sélectionné. Sous macOS, le matériel d’entrée et de sortie peut être sélectionné.

Mappage des canaux d’entrée/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 cartographie des canaux d’entrée (Input Channel Mapping) et cartographie des canaux de sortie (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

Sélectionne le nombre de canaux audio à utiliser pour la communication entre le client et le serveur.

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

Voici les trois modes disponibles :

Les modes Mono et Stéréo 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 puisque l’effet est appliqué aux deux canaux dans ce cas.

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 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 tampon à partir du logiciel Jamulus. Dans ce cas, le réglage du délai de mise en tampon est désactivé et doit être modifié à l’aide du pilote de la carte son. Sous Windows, appuyez sur le bouton paramètres ASIO pour ouvrir le panneau de configuration du pilote.

Sous Linux : - si vous utilisez JACK, utilisez QJackCtl pour modifier la taille du tampon et redémarrer JACK ; - si vous utilisez le serveur JACK de PipeWire, modifiez le paramètre Quantum de PipeWire à l’aide de ses propres outils de configuration.

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

Le réglage du 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 influe 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 chariots de taille de 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 du 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 chariots de taille de la mémoire tampon de gigue sont désactivés (ils ne peuvent pas être déplacés avec la souris).

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 (en particulier si votre connexion réseau présente une gigue importante). Essayez d’activer cette option si vous souffrez d’une latence élevée ou d’une mauvaise qualité audio. Toutefois, si vous la maintenez désactivée, la qualité audio sera normalement meilleure.

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

Annuaires personnalisés

Si vous avez besoin d’ajouter des adresses d’annuaires autres que celles qui sont embarquées, vous pouvez le faire ici. Saisissez le nom d’hôte ou l’adresse IP du répertoire personnalisé. Un numéro de port facultatif peut être ajouté après l’adresse en utilisant deux points comme séparateur, par exemple jamulus.example.com:22124. (Notez que l’IPv6 n’est pas actuellement pris en charge pour les annuaires.) Le bouton qui suit le champ permet de supprimer l’entrée actuelle de la liste.

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 Éditer > “Régler tous les chariots sur le niveau d’un nouveau client”.

Amplification de l’entrée

Augmente le gain de votre périphérique. Utilisez cette fonction si votre périphérique 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 mixage.

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 qui est beaucoup plus fort que le microphone, déplacez le chariot audio pour augmenter le volume relatif du microphone.

Contrôle MIDI

Les chariots et boutons de volume, contrôle de panoramique, muet et solo des tranches dans la fenêtre du mixeur du Client peuvent être pilotés à l’aide d’un contrôleur MIDI connecté. Cette fonctionnalité est disponible depuis la version 3.7.0 sur macOS, Linux et la version JACKifiée de Jamulus pour Windows. Depuis la version 3.12.0 c’est aussi disponible pour la version non-JACK (ASIO) pour Windows. Pour l’activer et ouvrir un port d’entrée MIDI, cochez la case Midi-in.

Périphérique MIDI

Lorsque l’entrée MIDI est activée, Jamulus détecte les périphériques disponibles pour connexion et les affiche dans la liste ‘Périphérique MIDI’. Choisissez le périphérique que vous désirez connecter à Jamulus. La version non JACKifiée pour Windows se connecte automatiquement à tous les périphérique disponibles si aucun n’a précédemment été sélectionné, ou si un périphérique enregistré est absent. Pour connecter un périphérique particulier, choisissez-le dans la liste.

Paramètres MIDI

Il y a un paramètre canal MIDI global (0-16) et deux paramètres pour chaque élément contrôlé : le premier MIDI CC et les CC consécutifs (décompte). Réglez d’abord le canal que vous voulez que Jamulus écoute (0 pour tous les canaux). Puis, pour chaque élément que vous désirez contrôler (chariot de volume, panoramique, solo, sourdine), indiquez le premier CC MIDI (numéro CC de début) et le nombre de CC consécutifs (décompte) que vous voulez assigner à cet élément particulier. Vous pouvez soit saisir les valeurs CC MIDI, soit utiliser le bouton “Apprendre” : cliquer sur “Apprendre”, actionnez le chariot/potard/bouton sur votre contrôleur MIDI, et le numéro de CC MIDI sera détecté et sauvegardé.

À titre d’exemple, un ‘premier CC MIDI’ à 0 et un ‘Nombre’ de 8 chariots de volume signifie que les CC numéro 0 à 7 piloteront les chariots de volume jusqu’à 8 canaux du mixeur.

Il existe une exception qui ne nécessite pas de définir des numéros CC consécutifs : il s’agit du paramètre “Me mettre en sourdine” - qui ne nécessite qu’un seul numéro CC, car il s’applique uniquement à son propre flux audio.

Mode reprise

Lorsqu’activé, les contrôles de chariot et de panoramique attendront que la position du contrôleur physique rejoigne celle du logiciel avant de bouger. Ceci empêche les changements brusques qui peuvent se produire quand les contrôles se désynchronisent.

Note : Jamulus ne fournit pas de retour de l’état on/off des boutons, c’est à dire que c’est à votre contrôleur lui-même de suivre et commuter les éventuelles DELs à ‘allumé’ ou ‘éteint’. Autrement dit, les boutons de votre contrôleur MIDI doivent être positionnés en mode “Bascule”. Ceci signifie que lors d’un appui pour ‘mettre en marche’ un bouton, il doit envoyer un numéro de MIDI CC avec une valeur ≥64, et que pour ‘arrêter le contrôle’, il doit envoyer le même numéro de CC avec une valeur <64. Référez-vous au manuel de votre contrôleur pour paramétrer ce comportement.

Quand MIDI est activé, Jamulus assigne en préfixe un n° de canal à chaque nom de Client, nom qui peut alors être utilisé pour contrôler le canal qui utilise les CC MIDI. Depuis Jamulus 3.12.0, quand on est connecté à un serveur de version au moins 3.5.5, votre propre chariot se verra toujours attribué le canal 0 et apparaîtra ainsi en premier quand le tri est défini par canal, ou quand l’option “Mon chariot en premier” est activée.

Astuce : avec les réglages par défaut, lors de l’arrivée ou du départ d’utilisateurs, leur disposition gauche-droite dans l’IGU peut cesser de suivre l’ordre numérique, ce qui peut rendre difficile de savoir à qui correspond tel ou tel chariot/bouton physique de contrôleur MIDI. Pour garder les tranches de console dans l’ordre numérique, rendez-vous dans “Affichage” dans la barre de menu et basculez vers “Trier par canal” (ou utilisez le raccourci Ctrl+E).

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, saisissez %APPDATA% dans la barre de recherche et cherchez un dossier nommé Jamulus. Vous trouverez un ou plusieurs fichiers .ini dans ce dossier. Maintenant sauvegardez les paramètres de Jamulus.

Pour toutes les autres plateformes, exécutez la commande suivante à partir de la ligne de commande pour trouver leur emplacement et copier les fichiers à un autre endroit :

find ~ -name Jamulus.ini -ls

Si vous avez utilisé le paramètre --inifile pour sauvegarder un fichier ini à un endroit différent, n’oubliez pas de sauvegarder également ces fichiers. 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 pour les utilisateurs de macOS : à partir de Jamulus 3.8.1, nous avons un installateur signé. Celui-ci stockera les paramètres dans

$HOME/Library/Containers/app.jamulussoftware.Jamulus/Data/.config/Jamulus/

Options de la ligne de commande

La plupart des fonctions courantes de Jamulus peuvent être paramétrées à l’aide de l’interface graphique, mais ces fonctions et d’autres peuvent également être paramétrées à 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:\chemin\vers\monfichierini.ini"

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

 /Applications/Jamulus.app/Contents/MacOS/Jamulus --inifile "/chemin/vers/monfichierini.ini"

• -M ou --mutestream Empêcher les autres membres du serveur d’entendre ce que je joue
• --mutemyown Me silencer dans mon mixage personnel (mode “headless” seulement)
• -c ou --connect Se connecter à l’adresse du serveur donné au démarrage, format adresse[:port]
• -j ou --nojackconnect Désactive l’auto-connexion de JACK
• --ctrlmidich Canal MIDI à écouter, les contrôles de Jamulus + numéro de contrôle MIDI et le décompte de numéros CC consécutifs (ou canaux Jamulus), mode reprise, option de sélection de périphérique. Format : canal[;fn[*n]][;pn[*n]][;sn[*n]][;mn[*n]][;on][;u][;dDeviceName] 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 paramètre l’emplacement du fichier d’initialisation (remplace la valeur par défaut). Sur macOS, fournissez simplement un nom de fichier, puisque les fichiers de configuration ne peuvent être lus que depuis /Users/<nomdutilisateur>/Library/Containers/app.jamulussoftware.Jamulus/Data/. Pour le serveur, remplacez app.jamulussoftware.Jamulus par app.jamulussoftware.JamulusServer. Activez “Afficher le dossier Bibliothèque” dans “Afficher les options d’affichage” dans le Finder pour voir ce dossier.)
• -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
• --jsonrpcport Permet au serveur API JSON-RPC de contrôler l’application, définit le numéro de port TCP (EXPÉRIMENTAL, les API peuvent changer ; accessible uniquement depuis localhost). Veuillez consulter le fichier de documentation de l’API JSON-RPC.
• --jsonrpcsecretfile Requis lorsque vous utilisez --jsonrpcport. Définit un chemin vers un fichier texte contenant une chaîne d’authentification pour obtenir l’accès à l’API JSON-RPC.
• --jsonrpcbindip L’adresse IP à laquelle le serveur JSON-RPC devrait se lier. (optionnel, la valeur par défaut est 127.0.0.1)
• -Q ou –qos` Définit la valeur DS Field byte de la qualité de service. La valeur par défaut est 128 (DSP/CS4). QoS est ignoré par Windows. Pour l’activer, voir cette page
• -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

Contrôle du client via l’API

En plus de la ligne de commande, Jamulus peut être contrôlé à l’aide d’une API. Ceci est utile pour les cas d’utilisation avancés - par exemple, lorsqu’il n’y a pas d’interface graphique, ou lorsqu’une autre application doit interagir avec Jamulus. Veuillez noter que l’API est encore expérimentale. Des informations sur l’API JSON-RPC peuvent être trouvées dans le dépôt principal (en anglais).