TaraniTunes

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 21 Open GitHub ↗

Awesome music player for FrSky Taranis radios

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

TaraniTunes
===========

*Awesome music player for FrSky Taranis radios.*

> **Note**:
> [jrwieland](https://github.com/jrwieland) made quite a lot of improvements to TaraniTunes: he added playlists, automatic song switching, and more.  
> It’s a little bit more complicated to set up, but I strongly recommand you to check out [his fork](https://github.com/jrwieland/TaraniTunes) if you are interested by these features!

Compatible with FrSky’s [Taranis Q X7](https://www.frsky-rc.com/product/taranis-q-x7-2), [Taranis X9D](https://www.frsky-rc.com/product/taranis-x9d-plus-2) and probably their variants.
You need [OpenTX](http://www.open-tx.org) 2.3.x or later (tested on 2.3.7).

* Taranis Q X7  
  ![Taranis Q X7](https://raw.githubusercontent.com/GilDev/TaraniTunes/master/Screenshots/TaraniTunesQX7.png)
* Taranis X9D  
  ![Taranis X9D](https://raw.githubusercontent.com/GilDev/TaraniTunes/master/Screenshots/TaraniTunesX9D.png)

English instructions
--------------------

Here’s a video explaining everything, from the installation to the usage:

[![TaraniTunes Instruction Video](https://img.youtube.com/vi/gCiody4izEs/0.jpg)](https://youtu.be/gCiody4izEs)

The installation process changed a bit, principaly the `playlist.txt` syntax. Please refer to the following instructions.

### Installation

The “[Example](Example)” folder contains an exemple of the Taranis’ SD card structure you must follow. It works, and you can, if you want to, merge it with your Taranis’ current SD card content. You currently need to have at least 5 songs for the script to work.

1. On your computer:
	1. Edit [`iTunes.lua`](iTunes.lua) according to your preferences if needed then put `iTunes.lua` in `/SCRIPT/TELEMETRY`.
	2. Create a [`playlist.lua`](Example/SOUNDS/playlist.txt) file in `/SOUNDS` where each line must be formatted like this: `{"Song name", "SONG_FILENAME"},` where `SONG_FILENAME` must be 6 characters or less. Look at “[Example/SOUNDS/playlist.txt](Example/SOUNDS/playlist.txt)” for an example of formatting.
	3. Put your corresponding songs `SONG_FILENAME.wav` in `/SOUNDS/en` if your radio is in English (otherwise replace `en` with 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](http://www.audacityteam.org) to do that, it works great.

2. On your Taranis (I’m going to explain how I setup my radio):
	1. Set “DISPLAY” model’s setting screen as follow:  
	![Display settings](https://raw.githubusercontent.com/GilDev/TaraniTunes/master/Screenshots/DisplaySettings.png)
	2. Set “LOGICAL SWITCHES” model’s setting screen as follow:  
	![Logical switches settings](https://raw.githubusercontent.com/GilDev/TaraniTunes/master/Screenshots/LogicalSwitchesSettings.png)
	3. Set “FLIGHT MODES” model’s setting screen as follow:  
	![Flight modes settings](https://raw.githubusercontent.com/GilDev/TaraniTunes/master/Screenshots/FlightModesSettings.png)  
	In fact, put every throttle trims to “`--`” for every flight mode you use.

There you go! Next section will explain you how to use TaraniTunes.

### Usage

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`](iTunes.lua), maybe some configuration values are wrong.
* The `playlist.lua` syntax may be wrong. Please check that.

1. Use the rotary encoder (Q X7) or the “+”/“-” buttons to sweep through songs.
2. Press “Enter” to choose a song to play.
3. Put the “SD” switch in the middle position to start playing. Put it back in the up position to stop.
4. Put “SD” in the down position to select a random song from your playlist.
5. You can press throttle trims up and down to play next and previous song respectively.

French instructions
-------------------

Voici une vidéo en Anglais qui explique tout, de l’installation à l’utilisation :

[![TaraniTunes Instruction Video](https://img.youtube.com/vi/gCiody4izEs/0.jpg)](https://youtu.be/gCiody4izEs)

Le processus d’installation a légèrement changé, notamment la syntaxe du fichier `playlist.txt`. Veuillez vous référer aux instructions suivantes.

### Installation

Le dossier « [Example](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.

1. Sur votre ordinateur :

1. Éditer [`iTunes.lua`](iTunes.lua) selon vos préférences, si nécessaire, et mettre ensuite `iTunes.lua` dans le dossier `/SCRIPT/TELEMETRY` ».
	2. Créer un fichier [`playlist.lua`](Example/SOUNDS/playlist.txt) dans `/SOUNDS` dans lequel chaque ligne doit suivre le format suivant : `{"Nom du morceau", "NOM_DU_FICHIER"},` où `NOM_DU_FICHIER` doit faire 6 caractères maximum. Regardez « [Example/SOUNDS/playlist.txt](Example/SOUNDS/playlist.txt) » pour un exemple de fichier correctement formaté.
	3. Mettre les morceaux correspondants `NOM_DU_FICHIER.wav` dans `/SOUNDS/fr` si votre radio est en français (sinon remplacez `fr` par 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](http://www.audacityteam.org) pour faire ça, ça marche bien.

2. Sur votre Taranis (je vais expliquer comment je règle ma radio, avec le fichier « iTunes.lua » par défaut) :

1. Configurer l’écran de configuration du modèle « AFFICHAGE » comme ceci :  
![Display settings](https://raw.githubusercontent.com/GilDev/TaraniTunes/master/Screenshots/DisplaySettings.png)
	2. Configurer l’écran de configuration du modèle « INTERS LOGIQUES » comme ceci :  
![Logical switches settings](https://raw.githubusercontent.com/GilDev/TaraniTunes/master/Screenshots/LogicalSwitchesSettings.png)
	3. Configurer l’écran de configuration du modèle « PHASES DE VOL » comme ceci :  
![Flight modes settings](https://raw.githubusercontent.com/GilDev/TaraniTunes/master/Screenshots/FlightModesSettings.png)  
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.

### Utilisation

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`](iTunes.lua), des valeurs de configurations sont peut-être erronées.
* La syntaxe du fichier `playlist.txt` est peut-être incorrecte. Vérifiez-la.

1. Utilisez l’encodeur (Q X7) ou les boutons « + »/« - » pour naviguer dans vos morceaux.
2. Appuyez sur « Enter » pour sélectionner un morceau à jouer.
3. Mettez l’interrupteur « SD » en position centrale pour démarrer la lecture. Mettez-le en position haute pour arrêter.
4. Mettez « SD » en position basse pour sélectionner un morceau aléatoire.
5. Vous pouvez utiliser le trim des gaz bas ou haut pour passer respectivement au morceau suivant ou précédent.

Todo
----

* Automatically play next music after the current one is finished (no idea how to do this).

Suggestions for OpenTX’s API
----------------------------

* 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 use `table[#table + 1] = value` instead.

TaraniTunes

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README