Configuration

Configuration

Priorité des réglages

L'application résout ses paramètres dans cet ordre :

1. config.ini (Linux/macOS : ~/.config/muxiveo/config.ini ; Windows dev : racine du projet ; Windows packagé : %APPDATA%\muxiveo\config.ini)
2. les valeurs persistées par l'interface (QSettings)
3. les valeurs par défaut internes

Sous Windows, setup.py et le démarrage de l'application peuvent auto-détecter les outils et renseigner automatiquement la section [tools] de config.ini.

Paramètres principaux

Paramètre	Défaut	Description
work_dir	$XDG_CACHE_HOME/muxiveo/work ou ~/.cache/muxiveo/work sur Linux ; temporaire système Muxiveo_work ailleurs	dossier des fichiers temporaires
output_dir	dossier Vidéos de l'OS	dossier de sortie par défaut
theme	dark	thème visuel (dark ou light)
language	auto-détecté	langue de l'interface (fra ou eng)
startup_panel	dashboard	panneau ouvert au démarrage (dashboard, container, encoding, hybrid, hdr, dovi, extensions, settings)
mux_backend (section [matroska])	ffmpeg	assembleur final : ffmpeg, auto ou native
update_channel (section [ui])	stable, ou unstable pour un build de préversion	canal de mise à jour : stable ou unstable
check_updates (section [ui])	true	vérifie les mises à jour au démarrage (au plus une fois par 24 h)
update_popup (section [ui])	true	affiche une fenêtre popup de notification de mise à jour au démarrage
auto_update (section [plugins])	true	mises à jour automatiques des extensions
tensorrt_enabled (section [plugins])	true	autorise l’accélération TensorRT lorsqu’elle est installée et compatible
release_group_tag_enabled (section [paths])	false	ajoute le suffixe de groupe au nom de sortie
release_group_tag (section [paths])	vide	nom du groupe, utilisé lorsque le suffixe est activé ; vide = NoGroup
display_peak_nits (section [hdr])	1000	pic de l’écran pour la simulation de tone mapping dans HDR Studio, de 100 à 10 000 nits
tmdb_api_key	vide	clé API TMDB v3 utilisée par la recherche IMDb/TMDB
tmdb_bearer_token	vide	token Bearer TMDB v4 (utilisé si tmdb_api_key est vide, ou via MUXIVEO_TMDB_BEARER_TOKEN)
generate_nfo	true	génère un fichier .nfo MediaInfo à côté du MKV final après workflow réussi
ram_buffer_enabled	true	autorise l'usage de /dev/shm pour les HEVC intermédiaires si disponible
ram_buffer_threshold_pct	15	pourcentage minimal de RAM libre à conserver pour activer ce buffer
rewrite_enabled (section [sync])	false	autorise la réécriture physique expérimentale des offsets sous-titres/audio
advanced_audio_rewrite_enabled (section [sync])	false	autorise les stratégies audio avancées pour TrueHD/MLP, DTS/DTS-HD/DTS:X, EAC3+JOC/Atmos, PCM/LPCM, lossless et lossy
quick_audio_check (section [sync])	true	vérification rapide de synchronisation audio avant de basculer sur l'analyse continue
cadence_auto_apply (section [sync])	true	applique automatiquement la conversion PAL ↔ Cinéma détectée
cadence_audio_method (section [sync])	auto	méthode de conversion audio : auto (analyse de hauteur/pitch), atempo ou asetrate

Choisir le multiplexage et les mises à jour

Le réglage global [matroska] mux_backend vaut FFmpeg par défaut. Auto utilise le muxer natif lorsque le plan est compatible et explique les replis dans le journal. Natif refuse une opération non prise en charge au lieu de basculer. Un choix explicite dans un job CLI ou --mux-backend prend le dessus. Voir Workflows.

Les canaux de l’application sont décrits dans Mises à jour ; la gestion des extensions dans Plugins. MUXIVEO_CONFIG_HOME permet de choisir un autre dossier de configuration. Sous Windows, les préférences de l’interface sont dans muxiveo.conf, distinct de config.ini.

Le suffixe de groupe se règle dans Chemins. Il s’ajoute au nom de sortie lorsque l’option est activée ; vérifiez le nom proposé avant le lancement, notamment en batch.

Buffer RAM

Le workflow d'encodage peut placer les fichiers HEVC temporaires en RAM pour limiter les E/S disque.

Conditions d'utilisation :

• ram_buffer_enabled = true
• un répertoire RAM-backed disponible et inscriptible (/dev/shm)
• après allocation estimée, la RAM libre reste au-dessus du seuil ram_buffer_threshold_pct

Comportement :

• si toutes les conditions sont remplies, les intermédiaires HEVC sont écrits en RAM
• sinon, fallback automatique vers le dossier temporaire sur disque (work_dir ou temporaire système)
• la décision est réévaluée à chaque allocation

Limite Windows :

• l'application ne s'appuie pas sur un backend RAM standard sur Windows
• le chemin par défaut reste donc disque pour garantir un comportement stable et compatible avec les outils externes (ffmpeg, dovi_tool, hdr10plus_tool) qui attendent des chemins de fichiers classiques

Outils configurables

Vous pouvez définir explicitement dans config.ini :

• ffmpeg, ffprobe
• mediainfo
• dovi_tool, hdr10plus_tool
• eac3to

Exemple :

[paths]
output_dir = /mnt/nas/videos

[tools]
ffmpeg = /opt/ffmpeg/bin/ffmpeg
dovi_tool = /usr/local/bin/dovi_tool

[matroska]
mux_backend = auto

[ui]
theme = light
language = eng
startup_panel = container
check_updates = true
update_popup = true

[metadata]
tmdb_api_key = <VOTRE_CLE_API_TMDB_V3>
tmdb_bearer_token = <VOTRE_TOKEN_BEARER_TMDB_V4>
generate_nfo = true

[sync]
rewrite_enabled = false
advanced_audio_rewrite_enabled = false
quick_audio_check = true
cadence_auto_apply = true
cadence_audio_method = auto