[Dingoo] Linux sur sa Dingoo, jour 2 : les frontend

[Dreamkey]

Introduction

Un frontend, qu'est-ce que c'est ? Pour le savoir un peu d'histoire.
Au début de Dingux, la console était reliée au PC grâce Ã* un câble spécial. Quand Dingux était lancé, il attendait une commande, qui était tapée sur l'ordinateur puis envoyé Ã* Dingux par ce câble. Dingux ne servait Ã* rien sans un ordinateur sous la main, un comble pour une console portable !
Le frontend est donc lÃ* pour pallier ce problème ; il est lancé automatiquement au démarrage, et vous propose de lancer des commandes au travers d'icônes.

Aujourd'hui, vous avez le choix entre deux frontend :

• Dmenu :
  
• DinguXMB :
  

[BREAK=Dmenu (1/3)]
Pour les anglophobes, voilÃ* la traduction des changelog (je commence Ã* partir de la version 0.5 car ce tuto a d'abord été écrit pour la version 0.4)

v0.5

• Ajout de l'option "SelectorDir" pour les objets des menus et des sous-menus (permet de séparer les roms de l'émulateur, par exemple)
• Ajout de nouvelles touches dans l'explorateur pour se déplacer d'une page Ã* la fois (L et R au lieu de Y + haut/bas)
• Ajout d'un sélecteur de fonds d'écran avec miniatures
• Ajout d'un sélecteur de couleur pour la police
  Ensuite, beaucoup de fichiers de déplacés ou fusionnés (voici la liste pour faire le ménage) :
• Déplacement et renommage du dossier de ressources de "/usr/local/home/.dmenu" vers "/usr/local/dmenu/resources"
• Déplacement de "dmenu.ini" de "/usr/local/dmenu/resouces/" vers "/usr/local/dmenu/"
• Déplacement des configurations du fond d'écran, du volume et de la luminosité de chaque "theme.cfg" vers "dmenu.ini"
• Fusion de "main.cfg" et "fontcolor.ini" vers "dmenu.ini"
• Suppression du dossier et des scripts de la configuration de la couleur de la police
• Suppression de "fontcolor.ini"

v0.6

• Ajout de la possibilité d'utiliser des ressources globales pour les thèmes
• Le sélectionneur de thème utilise maintenant une image de prévisualisation
  Il va d'abord chercher le fichier "theme.png" Ã* la racine du dossier de chaque thème. S'il n'est pas trouvé, il va utiliser "notfound.png" dans le dossier des ressources.
• Améliorations de l'interface du menu principal
  Les objets apparaissent maintenant plus ou moins transparent suivant leur distance de l'objet actif. Si un sous-menu est ouvert, la même chose se passe, mais pour les objets verticaux.
• Pour le son, replacement d'une icône et du pourcentage par une icône représentant le niveau actuel
• Réduction de la luminosité au bout d'un certain temps
• Ajout d'une option pour définir la marge entre une icône et son texte (seulement pour les objets verticaux)

[BREAK=Dmenu (2/3)]
Dmenu est le premier frontend Ã* être apparu sur la Dingoo, il reprend la même interface que le firmware officiel. Même si l'on passe du temps Ã* le configurer, il permet de faire tout ce que l'on veut.

Installation :

• Pour le télécharger, allez ici et la seule archive
• Connectez votre Dingoo en USB, et copiez le dossier "local" de l'archive "release-0.6.zip" Ã* la racine de votre miniSD ; confirmez la fusion

Dmenu est maintenant installé, vous pouvez le lancer en redémarrant votre Dingoo.
Je vous l'accorde, l'interface et les sons font vraiment peur, mais (je me répète) tout est configurable.

Configuration :
Maintenant il faut le configurer ; voyons comment on procède.

Partie 1 : configuration de Dmenu

Spoiler

Il faut d'abord le faire lancer automatiquement au démarrage de la Dingoo. Sur votre carte, allez dans le dossier "local/sbin/", créez un fichier appelé "main" (les windoziens, faîtes attention Ã* ne pas avoir d'extension du genre ".txt") et collez ce code :

#!/bin/sh
cd /usr/local/dmenu
./dmenu

À coté de l'exécutable "dmenu.bin", dans le dossier "local/dmenu" de votre carte, vous trouvez un fichier "dmenu.ini" :

Theme = "default"
SearchPath = {"sample_search_dir", "sample_search_dir2"}
AllowDynamicThemeChange = true 

# Volume and Brightness Icon display settings
VolDisp = true
BrightDisp = true

# SoundVolume setting (%)
SndVol = 70

# Brightness level setting (0 - 4)
Bright = 4

Background = "/usr/local/dmenu/wallpapers/default_bg.png"

# Autodim timer setting (seconds)
DimmerDelay = 5

# Font color setting
FontColor = "255,255,255"

# Font = ""

• Theme : contient le nom du dossier de votre thème
• SearchPath : permet d'intégrer des menus supplémentaires par des applications dont le chemin est configuré (personnellement je n'en ai pas encore vu)
• AllowDynamicThemeChange : vous permet de changer le thème de Dmenu Ã* la volée
• VolDisp et BrightDisp : vous permet de voir les icônes de volume et de luminosité dans le menu (sinon mettez false)
• SndVol et Bright : valeur du volume et de la luminosité, entre 0 et 100 et 0 et 4 respectivement
• Background : chemin vers le fond d'écran
• DimmerDelay : secondes avant que l'écran s'atténue pour inactivité. Vous pouvez le désactiver en le définissant Ã* 0
• FontColor : couleur de la police utilisée, au format RGB
• Font : laissez-le commenté, cela me faisait un Segmentation Fault si j'essayais de le définir

Attention : des problèmes d'écritures pouvant encore survenir avec Dingux, et comme Dmenu écrira dans ce fichier pour sauvegarder vos préférences, il se peut que vous ayez des problèmes avec cette fonctionnalité.

Partie 2 : configuration générale du thème

Spoiler

À côté se trouve un fichier "dmenu", ne le touchez pas. Il y a un dossier "wallpapers" où vous pourrez mettre vos fonds d'écran, un dossier "resources" qui servira pour les ressources communes des thèmes et un dossier "themes" : déplacez-vous dedans. Dupliquez le dossier "default" avec le nom que vous voulez et allez dedans : vous vous retrouvez avec un dossier "res", deux fichiers "theme.png" et "theme.cfg", éditez ce dernier.

# Menu file

Cursor = "res/cursor.png"
Font = "global:FreeSans.ttf"
Background = "res/default_bg.png"

# MenuItem & SubMenuItem text padding
ItemTextPadLeft = 10

ListBackground = "res/listbg.png"
ListSelector = "res/listselect.png"

ListDirIcon = "res/dir.png"
ListFileIcon = "res/file.png"

MenuSE = "global:menu.wav"
MenuItemSE = "global:menuitem.wav"
DecideSE = "global:decide.wav"
CancelSE = "global:cancel.wav"
OutSE = "global:out.wav"
TestSE = "global:test.wav"

Pour les options :

• Cursor : image qui apparaitra en dessous de vos icônes
• Font : police utilisée par Dmenu ; elle doit contenir les accents si vous voulez les utiliser
• Background : image de fond du menu
• ItemTextPadLeft : décalage du texte en pixel pour les menus et sous-menus (0 va coller le texte Ã* l'icône)

Les options suivantes concernent l'explorateur (navigation sur la carte et sélection d'une rom).

• ListBackground : image de fond de l'explorateur
• ListSelector : image qui apparaitra entre "ListBackground" et le fichier/dossier que vous sélectionnez
• ListDirIcon : image utilisée comme icône pour représenter un dossier
• ListFileIcon : image utilisée comme icône pour représenter un fichier

Les options suivantes concernent les sons joués, fonctionnalité apparue avec la version 0.4.

• MenuSE : son de déplacement d'un menu Ã* l'autre/sauter une page dans l'explorateur
• MenuItemSE : son de déplacement des objets d'un menu ou de l'explorateur
• DecideSE : son quand l'on rentre dans un sous-menu ou un dossier de l'explorateur
• CancelSE : son quand l'on sort d'un sous-menu ou d'un dossier de l'explorateur
• OutSE : son quand vous appuyez sur gauche/droite dans un sous-menu
• TestSE : son quand vous changez le volume ou la luminosité

L'option "global:" dans le nom du fichier (apparue avec la version 0.6) permet de chercher les fichiers dans le dossier "local/dmenu/resources/", pratique pour partager les mêmes éléments entre plusieurs thèmes et ainsi gagner de la place.

Pour plus de propreté et de facilité Ã* retrouver un objet, on va supprimer tout ce qui est après ces options.

Partie 3 : configuration des menus du thème

Spoiler

Maintenant on va créer notre menu pour les émulateurs, pour cela créez un fichier du nom de votre choix Ã* coté de "theme.cfg" (pour l'exemple je vais prendre "menu_emus.cfg") ; voici un modèle, vous pouvez le copier/coller et l'adapter :

Menu MonMenu
{
	Icon = "res/menu/emulator.png"
	Name = "Émulateurs"

	MenuItem MonObjet
	{
		Icon = "res/objet.png"
		Name = "Mon objet"
		Executable = "./objet -option1 -option2"
		WorkDir = "/usr/local/test"
	}

	MenuItem MonSousmenu
	{
		Icon = "res/emus/nintendo.png"
		Name = "Nintendo"

		SubMenuItem GnuBoy
		{
			Icon = "res/emus/gb.png"
			Name = "GnuBoy"
			Executable = "./sdlgnuboy"
			WorkDir = "/usr/local/emus/gnuboy"
			Selector = "true"
        		SelectorDir = "/usr/local/emus/roms_gb"
		}

		SubMenuItem Snes9x
		{
			Icon = "res/emus/snes.png"
			Name = "Snes9x"
			Executable = "./snes9x"
			WorkDir = "/usr/local/emus/snes9x"
			Selector = "true"
        		SelectorDir = "/usr/local/emus/roms_snes"
		}
	}
}

Cela est assez simple Ã* comprendre pour la syntaxe, voilÃ* pour les options :

• Icon : image qui apparaitra Ã* l'écran
• Name : nom qui apparaitra Ã* l'écran.
  Attention : si vous êtes sous windoze et que vous voulez utiliser les accents, il vous faut un éditeur plus complet que notepad (tel que Notepad++) afin d'encoder vos accents en UTF-8 ("Format->convertir en UTF-8 sans BOM" sous N++)
• Executable : nom du programme a lancer. Le "./" est obligatoire ; j'ai aussi mis un exemple de programme avec des options au cas où que vous en auriez besoin
• WorkDir : chemin où se trouve votre exécutable. A noter que s'il se trouve dans "local/emus/snes9x", il faudra écrire "/usr/local/emus/snes9x"
• Selector et SelectorDir : utile seulement pour les émulateurs, il permet de sélectionner un fichier (pour nous une rom) parmis ceux se trouvent dans le dossier "SelectorDir" pour l'envoyer ensuite Ã* l'émulateur. Si "SelectorDir" n'est pas défini, Dmenu utilisera "WorkDir" (comme avant).

Attention toutefois : le nom devant Menu, MenuItem et SubMenuItem doit être unique pour chaque catégorie, sinon seul le premier objet sur ceux qui ont le même nom sera affiché !

Reste maintenant Ã* l'incorporer, pour cela rajouter dans "theme.cfg", après les options :

include("menu_emus.cfg")

Faites de même pour les portages, les jeux... L'ordre des menus affichés Ã* l'écran dépendra de l'ordre des "include".

Quelques configurations spécifiques (n'oubliez pas de changer le chemin des images !) :

• Explorateur de fichier :
  
  Spoiler

  MenuItem Explorateur
  {
  	Icon = "res/systeme/explorateur.png"
  	Name = "Explorateur"
  	Executable = ""
  	WorkDir = "/"
  	Selector = yes
  }

  
  
• Redémarrer :
  
  Spoiler

  MenuItem Reboot
  {
  	Icon = "res/systeme/reboot.png"
  	Name = "Redémarrer"
  	Executable = "reboot"
  	WorkDir = "/"
  }

  
  
• Éteindre (vous devez avoir la version 0.31 du fichier "zImage" du pack "local" de toddler, trouvable ici) :
  
  Spoiler

  MenuItem Shutdown
  {
  	Icon = "res/systeme/reboot.png"
  	Name = "Éteindre"
  	Executable = "shutdown"
  	WorkDir = "/"
  }

  
  
• Afficher le terminal 10 secondes (utile si un programme ne marche pas et que vous voulez voir l'erreur) :
  
  Spoiler

  MenuItem Terminal
  {
  	Icon = "res/systeme/terminal.png"
  	Name = "Afficher le terminal"
  	Executable = "sleep 10"
  	WorkDir = "/"
  }

  
  
• Changer le thème :
  
  Spoiler

  MenuItem ThemeSelect
  {
  	Icon = "res/systeme/skin.png"
  	Name = "Changer le thème"
  	Executable = "!themeselect"
  }

  
  
• Changer le fond d'écran :
  
  Spoiler

  MenuItem BackgroundSelect
  {
  	Icon = "res/systeme/wpper.png"
  	Name = "Changer le fond d'écran"
  	Executable = "!backgroundselect"
  }

  
  
• Changer la couleur de la police :
  
  Spoiler

  MenuItem FontColor
  {
  	Icon = "res/systeme/skin.png"
  	Name = "Changer la couleur de police"
  	Executable = "!colorselect"
  }

[BREAK=Dmenu (3/3)]
Les touches dans Dmenu :
Dans le menu principal :

• gauche/droite : sélectionner le menu
• haut/bas : sélectionner l'objet
• A : entrer dans un menu/sous-menu ou lancer l'application
• gauche ou B : quitter ou sous-menu ouvert
• Select : quitter dmenu
• L/R : diminuer/augmenter le son de 5%
• X/Y : augmenter/diminuer la luminosité

Dans l'explorateur :

• haut/bas : sélectionner le fichier
• L/R : monter/descendre d'une page Ã* la fois
• gauche : revenir au dossier parent
• droite : aller dans le dossier sélectionné
• A : lancer le fichier ou aller dans le dossier sélectionné
• B : quitter l'explorateur
• Start : sauvegarder le dossier actuel comme la future valeur de SelectorDir pour l'objet qui l'a lancé

Dans le sélecteur de couleur :

• haut/bas : sélectionner le curseur rouge, vert ou bleu
• gauche/droite : réduire/augmenter la valeur de la couleur
• L/R : réduire/augmenter finement la valeur de la couleur
• A : sauvegarder la couleur et revenir au menu
• B : annuler et revenir au menu

Créer un skin :
Je ne vais pas m'étendre dessus, mais voilÃ* des petits conseils :

• les images sont en png, donc cela vous permet de faire de la transparence (avec même des dégradés) !
• si vous éditez votre thème alors que Dingux est lancé, il faut le recharger pour appliquer les effets : soit vous redémarrer, soit vous changer de thème en le resélectionnant

N'hésitez pas Ã* partager vos créations sur le forum !
[BREAK=DinguXMB]
C'est donc le deuxième frontend, il provient d'un portage (comprendre récupérer les sources de l'auteur principal et l'adapter) d'un frontend GP2X. Il reprend quant Ã* lui le XMB (Cross Media Bar) des dernières consoles de Sony, soit la PSX, la PS3 et la PSP.

Installation :

• Pour le télécharger, c'est ici
• Connectez votre Dingoo en USB, copiez le dossier "dinguxmb_v1.01" de l'archive dans le dossier "local" de votre miniSD et renommez-le en "dinguxmb"
• Déplacez le fichier "main" dans le dossier "local/sbin" de votre miniSD (confirmez le remplacement si vous avez installé Dmenu)

DinguXMB est maintenant installé, vous pouvez le lancer en redémarrant votre Dingoo.

Configuration :
La configuration est différente de Dmenu, car tout se passe sur la Dingoo.
Toutefois, lorsque vous installez un programme, il va falloir le renommer en rajoutant :

• ".sh" pour les scripts
• ".dge" pour les applications

Slaanesh s'explique en disant qu'il serait préférable que la communauté utilise ces extensions... En tout cas, si vous utilisez aussi Dmenu, n'oubliez pas de modifier la configuration de votre menu en conséquence.
Si vous voulez afficher une image avec votre programme, il faut créer une image en png de 128x74 pixels et la nommer avec le même nom que votre programme. Ex : "test.png" pour le programme "test.dge". Seulement cela ne marche pas avec les scripts, Ã* moins de renommer son extension en ".dge"...

Une fois ceci fait, démarrer votre Dingoo, aller dans "Games → SD Memory Card", naviguer dans votre carte jusqu'Ã* votre programme, appuyez sur X puis "Add Shortcut". Un message vous signalant la réussite va s'afficher, fermez-le avec Start.
Allez maintenant dans "Game → My Shortcuts", tous vos raccourcis vont s'afficher.

Les touches dans DinguXMB :

• A : sélectionner un élément
• B : annuler ou revenir en arrière
• L/R : diminuer/augmenter le son
• X : afficher les options (programmes ou images)
• Select : quitter. Un compte Ã* rebours de 5 secondes va s'afficher, Ã* vous de redémarrer manuellement la Dingoo, sinon DinguXMB va se relancer.
  Vous pouvez modifier le fichier "main" dans le dossier "local/sbin" de votre miniSD pour changer ce comportement.

[BREAK=Comparaison]
Voici un tableau comparatif :
[TABLE="head"]

Dmenu

|

Dingux

{colsp=2}

Points positifs

• interface sobre
• changement de thème Ã* la volée
• configuration de A Ã* Z

|

• interface vraiment léchée
• pas besoin de le configurer sur l'ordinateur

{colsp=2}

Points négatifs

• on passe du temps Ã* le configurer

|

• obligation de renommer les programmes
• pas d'explorateur (adieu les émulateurs)
• pas de configuration de la luminosité
• portage trop rapide (icônes en trop, options inutiles...)

[/table]

Vous hésitez toujours entre les deux ? Pas grave, j'ai fait un petit script !
Comment ça marche ? Il écrit dans un fichier une variable, et au démarrage de la Dingoo, lance l'un ou l'autre des frontend suivant cette variable. C'est un simple script, donc ouvrez-le avec un éditeur de texte pour comprendre en détail.

• téléchargez-le ici
• décompressez-le Ã* la racine de votre miniSD et confirmez le remplacement du fichier "main"
• rajouter ceci pour l'utiliser dans Dmenu (n'oubliez pas de configurer l'adresse de l'icône correctement) :
  

  MenuItem ChangeFrontend
  {
  	Icon = "res/systeme/swap.png"
  	Name = " Passer Ã* DinguXMB"
  	Executable = "./frontend.sh"
  	WorkDir = "/usr/local/systeme/frontend"
  }

• il ne reste plus qu'Ã* créer un raccourci sous DinguXMB

Pour l'utiliser, lancez-le, et votre Dingoo redémarrera sous l'autre frontend

Dans l'hypothèse où le fichier "main" d'un frontend changerait, renommez-le en "main_dmenu" ou "main_dinguxmb" et remplacez l'actuel.

[Yodajr]

Génial, merci beaucoup, surtout pour la partie configuration
J'avais trop la flemme de chercher comment ajouter des applis au menu

[snk4ever]

Sympa le tuto. Moi j'ai une approche différente: je prends le toddler, j'édite les cfg pour virer tout ce qui ne me plaît pas et réorganiser un peu Ã* ma sauce et je supprime les fichiers inutiles.
J'ai aussi mis un noyau qui supporte Ã* la fois mplayer et le shutdown.

DinguXMB manque vraiment trop de raffinement et d'adaptation Ã* la Dingoo pour le moment.

[Dreamkey]

Personnellement, je préfère faire ma configuration "from scratch" plutôt que d'adapter quelque chose

Et maintenant il n'y a plus de raison de se passer de Dingux - n'est ce pas Pixou

Je vais aussi contacter l'auteur de Dmenu, parce qu'Ã* triturer son programme dans tous les sens j'ai eu plein d'idées d'amélioration, et si il arrive Ã* toutes les implémenter on pourra faire des thèmes aussi beau que les non officiels sur PSP

[snk4ever]

Envoyé par Dreamkey

Je vais aussi contacter l'auteur de Dmenu, parce qu'Ã* triturer son programme dans tous les sens j'ai eu plein d'idées d'amélioration, et si il arrive Ã* toutes les implémenter on pourra faire des thèmes aussi beau que les non officiels sur PSP

Bonne idée ça. Il est temps de newser ce sujet et de renommer Player Advance en Dingoo Advance AHAHAHAHAH

[mulot]

Salut,
Bravo beau tuto.

J'aimerai toutefois avoir plus d'infos sur les options pour executable.
je m'explique je souhaiterai faire cela

MenuItem supernes
{
Icon = "res/monbelleiconmarioworld.png"
Name = "mario world"
Executable = "./sn9x -demare marioworld apres sn9x"
WorkDir = "/usr/local/snes"

le but est de ne pas passer par l'explorateur, afin de selection le jeux par des photos (1 icone = 1 jeux dans section supernes)

merci d'avance si tu a de la doc la dessus

[snk4ever]

Il suffit de voir les arguments en ligne de commande de ton executable snes9x.
Classiquement, tu mets directement le nom du fichier Ã* ouvrir derrière le nom de l'executable :
Executable = "./programme_Ã*_lancer fichier_Ã*_ouvrir"

ou :
./snes9x mario.smc

Si tu l'écris ainsi, c'est que mario.smc et snes9x sont dans le même répertoire.
Note: je n'ai pas vérifié que c'était la bonne syntaxe pour snes9x, tu peux tester comme ça et te renseigner si ça ne marche pas.

[Dreamkey]

Tout Ã* fait je confirme. Tu peux aussi t'amuser Ã* le faire Ã* travers des sous-menus, les objets étant Snes9x, Gnuboy...

[Pixou]

J'ai sorti mon PC, je vais m'installer Dingux ce soir je sens

[Dreamkey]

VoilÃ* je viens de passer plus de 3 heures Ã* mettre le tuto Ã* jour pour Dmenu v0.6, enjoy

Il me reste Ã* voir le nouveau frontend et mettre Ã* jour mon script pour changer de frontend.

[Ayla]

Il est un peu dépassé ton tuto
Y'a gmenu2x maintenant, qui est 20 fois mieux

[Dreamkey]

Envoyé par Ayla

Il est un peu dépassé ton tuto
Y'a gmenu2x maintenant, qui est 20 fois mieux

Oui, c'est le "nouveau frontend" dont je parle juste au dessus. Je devrais le mettre á jour d'ici ce soir ou demain

[Pixou]

J'ai beau avec le fichier "main" dans le bon dossier et avoir copié Dmenu, la dingoo refuse de démarrer et m'indique tjs "cannot usr/local/sbin/main"..

Une idée ?

1024ème post !

[Ayla]

Dmenu est dans quel dossier ?
Ton "main" contient quoi ?

[Pixou]

Contenu du main (local/sbin) :

#!/bin/sh
cd /usr/local/dmenu
./dmenu

"dmenu" est dans /local

[snk4ever]

Envoyé par Pixou

J'ai beau avec le fichier "main" dans le bon dossier et avoir copié Dmenu, la dingoo refuse de démarrer et m'indique tjs "cannot usr/local/sbin/main"..

Une idée ?

1024ème post !

Ok, la check-list:
1: tu utilises une carte sd formattée en fat32
2: tu as mis le zImage
3: tu as mis le rootfs
4: tu as un répertoire local Ã* la racine de ta sd
5: dans le repertoire local tu as un repertoire sbin
6: dans le répertoire sbin tu as un fichier texte main que tu as enregistré sous ce nom et pas sous le nom main.txt
7: tu as créé ce fichier texte avec un vrai éditeur qui fait des retour charriot unix comme notepad++ ou vi
8: ce que tu lances dans ce fichier main (dmenu certainement) existe sur ta carte sd dans le bon chemin indiqué

Tu peux confirmer point par point ?

[Ayla]

1. 2. 3. => c'est forcément bon sinon il arriverait pas jusqu'ici

[Pixou]

le 7, j'avais pas penser au retour chariot Unix, j'ai converti mon "main", je test ça.

[edit] c'était ça ! [/edit]

[edit2] Bon, ben reste plus qu'a mettre des applications, des conseils les gens ? [/edit2]