Awesome music player for FrSky Taranis radios.
Compatible with FrSky's Taranis Q X7, Taranis X9D and their variants. You need at least OpenTX 2.2.
- Taranis Q X7
- Taranis X9D
Here's a video explaining everything, from the installation to the usage:
The “Example” folder contains an exemple of the Taranis' SD card structure you must follow. It works, you can, if you want, merge it with your Taranis' current SD card content. You currently need to have at least 5 songs for the script to work.
-
On your computer:
- Edit
iTunes.luaaccording to your preferences if needed then putiTunes.luain/SCRIPT/TELEMETRY. - Create a
playlist.txtfile in/SOUNDSwhere each line must be formatted like this:Song name:SONG_FILENAMEwhereSONG_FILENAMEmust be 6 characters or less. Don't end the file with a newline! Look at “Example/SOUNDS/playlist.txt” for an example of formatting. - Put your corresponding songs
SONG_FILENAME.wavin/SOUNDS/enif your radio is in English (otherwise replaceenwith your language, the folder where you put your other sound files). They must be converted to mono, preferably normalized, and encoded in Microsoft WAV 16-bits signed PCM at a 32 kHz sampling rate, you can use Audacity to do that, it works great.
- Edit
-
On your Taranis (I'm going to explain how I setup my radio):
- Set “DISPLAY” model's setting screen as follow:
- Set “LOGICAL SWITCHES” model's setting screen as follow:
- Set “FLIGHT MODES” model's setting screen as follow:
In fact, put every throttle trims to “--” for every flight mode you use.
- Set “DISPLAY” model's setting screen as follow:
There you go! Next section will explain you how to use TaraniTunes.
From the main screen, hold “Page” to access TaraniTunes. If everything has been setup correctly, your songs should appear, otherwise:
- If you modified your
iTunes.lua, maybe some configuration values are wrong. - The
playlist.txtsyntax may be wrong. Be sure to put the song name, then the colon “:”, then the song filename of 6 characters maximum. Also make sure there is no empty line at the end, or you will get a “CPU Limit” error, yeah I probably need to fix that…
- Use the rotary encoder (Q X7) or the “+”/“-” buttons to sweep through songs.
- Press “Enter” to choose a song to play.
- Put the “SD” switch in the middle position to start playing. Put it back in the up position to stop.
- If you select another song, you have to stop and start playback (“SD” up then center again). I'm sorry I can't do it any other way…
- Put “SD” in the down position to select a random song from your playlist then start playback again (“SD” in the center position).
- You can press throttle trims down and up to play next and previous song respectively. You still have to stop and start playback to play it.
Voici une vidéo en Anglais qui explique tout, de l'installation à l'utilisation :
Le dossier « Example » contient un exemple de la structure de la carte SD que vous devez suivre. Ça marche, et vous pouvez, si vous le souhaitez, fusionner ce dossier avec le contenu actuel de la carte SD de votre Taranis. Vous devez pour l'instant avoir au moins 5 morceaux pour que le script marche.
-
Sur votre ordinateur :
-
Éditer
iTunes.luaselon vos préférences, si nécessaire, et mettre ensuiteiTunes.luadans le dossier/SCRIPT/TELEMETRY». -
Créer un fichier
playlist.txtdans/SOUNDSdans lequel chaque ligne doit suivre le format suivant :Nom de la chanson:NOM_DU_FICHIERoùNOM_DU_FICHIERdoit être 6 caractères maximum. Ne pas terminer le fichier avec un saut de ligne ! Regardez « Example/SOUNDS/playlist.txt » pour un exemple de fichier correctement formaté. -
Mettre les morceaux correspondants
NOM_DU_FICHIER.wavdans/SOUNDS/frsi votre radio est en français (sinon remplacezfrpar votre langue, le dossier dans lequel vous placez vos autres sons). Ceux-ci doivent être converti en mono, préférablement normalisés, et encodés au format WAV Microsoft 16-bits non signé PCM à une fréquence d'échantillonnage de 32 kHz, comme les autres sons que vous utilisez. Vous pouvez utiliser Audacity pour faire ça, ça marche bien. -
Sur votre Taranis (je vais expliquer comment je règle ma radio, avec le fichier « iTunes.lua » non modifié) :
-
Configurer l'écran de configuration du modèle « AFFICHAGE » comme ceci :
-
Configurer l'écran de configuration du modèle « INTERS LOGIQUES » comme ceci :
-
Configurer l'écran de configuration du modèle « PHASES DE VOL » comme ceci :
Vous devez en fait régler chaque trim de gaz à «--» pour toutes les phases de vol que vous utilisez.
Et voilà ! La section suivante va expliquer comment se servir de TaraniTunes.
Depuis l'écran principal, maintenez « Page » pour accéder à TaraniTunes. Si tout a été correctement configuré, vos morceaux devraient apparaître, sinon :
- Si vous avez modifié votre
iTunes.lua, des valeurs de configurations sont peut-être erronées. - La syntaxe du fichier
playlist.txtest peut-être incorrecte. Assurez-vous d'avoir écrit le nom du morceau, suivi de deux-points « : », suivi du nom du fichier de 6 caractères maximum. Faites également attention de ne pas avoir de saut de ligne à la fin du fichier sous peine d'avoir une erreur « CPU Limit ».
- Utilisez l'encodeur (Q X7) ou les boutons « + »/« - » pour naviguer dans vos morceaux.
- Appuyez sur « Enter » pour sélectionner un morceau à jouer.
- Mettez l'interrupteur « SD » en position centrale pour démarrer la lecture. Mettez-le en position haute pour arrêter.
- Si vous choisissez un autre morceau, vous devez arrêter et redémarrer la lecture (« SD » en haut puis à nouveau au centre). Je suis désolé on ne peut pas faire autrement…
- Mettez « SD » en position basse pour sélectionner un morceau aléatoire puis relancez la lecture (« SD » en position centrale).
- Vous pouvez utiliser le trim des gaz bas ou haut pour passer à la chanson suivante ou précédente respectivement. Vous devrez toujours relancer la lecture pour jouer la nouvelle musique.
- Automatically play next music after one is finished (maybe skip to next song when already 30 seconds have been played?)
- Constants to determine the radio type, useful when calculating switche's index because in special functions, logical switch 1 have the index 51 on Taranis X9D and 39 on Taranis Q X7.
- A function called when entering a telemetry screen. Useful to draw the screen only when needed and not every frame. Without that variable, when entering the telemetry screen more than once, the screen stays stuck onto the main screen.
table.insert(table, value)doesn't seem to work, need to usetable[#table + 1] = valueinstead.