----------------------------------------------------------------------

  Introduction

  1) Utilisation

  2) Mentions lgales

  3) Historique

  4) Historique des versions bta

----------------------------------------------------------------------

Introduction :
------------

WinMP3Shrink, UTILITAIRE DE COMPRESSION/RECOMPRESSION DE MP3.

Cet utilitaire rpond  une question souvent pose :
"- Comment puis-je recompresser mes mp3 pour mon baladeur ?"

Il apporte une rponse simple, sans complications inutiles.

En outre, on peut s'en servir comme encodeur en srie, utilisant
l'un des meilleurs encodeurs en ligne de commande gratuits : LAME.



1) Utilisation :
   -----------

Slectionnez vos fichiers, votre bitrate, votre mode,
et cliquez sur "GO!". tonnant, non ? ;)

Il est possible de slectionner plusieurs fichiers  la fois.

Par dfaut, chaque mp3 recompress est stock dans le rpertoire
d'origine, et se voit ajouter l'indication du bitrate  son nom.

Ex : soit le fichier "C:\Audio\L'accordon de tonton Maurice.mp3".

Si le bitrate choisi est CBR 112 kbps, le fichier rsulant sera :
"C:\Audio\L'accordon de tonton Maurice_C112kbps.mp3"

Si le bitrate choisi est ABR 96 kbps, le fichier rsulant sera :
"C:\Audio\L'accordon de tonton Maurice_A96kbps.mp3"

Il est possible de modifier ce comportement dans les paramtres
avancs, et de dfinir un rpertoire de destination fixe.




2) Mentions lgales :
   ----------------

Ce logiciel utilise l'encodeur Lame
http://www.mp3dev.org

La partie "vrification d'une nouvelle version et tlchargement"
est ralise  l'aide des composants Delphi de la suite Indy
http://www.indyproject.org

Compression par UPX
http://upx.sourceforge.net/




3) Historique :
   ----------


* 31/08/2005 : version 1.1 [31/08/2005 22:01]


  fonctions ajoutes/modifies :

  - Rvision complte du systme de dtection et de tlchargement
    des mises  jour, en parallle avec la rfection du site.
    Entre autres, il sera possible d'afficher un court message
     l'utilisateur, concernant la nouvelle version.

  - L'erreur socket est affiche en cas d'erreur de connexion.


  bugs corrigs :

  - BUG GRAVE : dans certains cas de figure, il pouvait y avoir
    crasement du mp3 original, car le nom du fichier destination
    tait identique au nom du fichier source. Corrig en amont.
    Paralllement, ajout d'un autre test, juste avant l'encodage,
    et qui effectue une numrotation automatique du nom de destination,
    si celui-ci existe dj (truc_96kbps.mp3 , truc_96kbps (2).mp3, etc..)
    Il ne peut donc plus y avoir, en aucun cas, de perte de donnes.

  - problme de traduction de la version anglaise : certaines parties
    n'taient pas traduites (bote de dialogue "add files" par exemple)

  - bug bnin : dans des cas trs particuliers, lors de l'importation
    d'un dossier, se dclenchait l'erreur "Rpertoire de destination
    inclus dans le rpertoire source", alors que ce n'tait pas le cas.


  REMARQUE : il est fortement conseill de mettre  jour avec cette
  version, d'une part  cause du bug important de la version 1.0,
  d'autre part parce que si vous tardez, vous risquez d'avoir  faire
  la mise  jour en deux fois.
  En effet la version 1.1 sera la dernire version accessible par
  la vieille adresse http://capjack.free.fr/telech/WinMP3Shrink.zip,
  la nouvelle adresse tant :
  http://capjack.free.fr/download/download.php?file=WinMP3Shrink





* 06/08/2005 : version 1.0 [06/08/2005 19:42]

  PREMIRE VERSION STABLE PUBLIE


  Diffrences par rapport  la dernire version  publie :

  fonctions ajoutes/modifies :

  - mentions  Indy et UPX dans la bote " propos"

  - la bote de dialogue "Enregistrer sous" du tlchargement
    affiche un avertissement d'crasement de fichier (je ne
    comprends pas pourquoi cette option n'est pas active
    par dfaut...)

  bugs corrigs :

  - bug bte : extension de fichier incorrecte quand le
    fichier source n'est pas un mp3, ET qu'on a dfini
    un rpertoire de sortie ET que la case 'parcourir
    les sous-rpertoires' est coche. Logiquement, ce bug
    doit dater de la version 0.20, tonnant que personnne
    ne s'en soit aperu, mme s'il est rare.




4) Historique des versions bta
   ----------------------------

* 05/08/2005 : version 0.29 build 995 [05/08/2005 18:09]

  fonctions ajoutes/modifies :

  - bouton "Vrifier maintenant" pour les nouvelles versions

  - compression par UPX (merci Scaramanga et Gowap...)

  bugs corrigs :

  - quelques fautes... mais sans doute pas toutes :(




* 04/08/2005 : version 0.28 build 990 [04/08/2005 23:04]

  fonctions ajoutes/modifies :

  - vrification automatique de disponibilit d'une nouvelle
    version, avec tlchargement sur demande


  bugs corrigs :

  - l'affichage du temps restant tait souvent sans signification
    pendant un bon moment...

  - bugs d'affichage non critiques, le plus important tant li
     la mmorisation de la position de la fentre.

  - si Lame tait interrompu, l'interruption n'tait pas immdiate




* 03/08/2005 : version 0.27 build 955 [03/08/2005 20:44]

  fonctions ajoutes/modifies :

  - Modifications de fond du code source en vue de la localisation

  - Localisation en anglais (voir options avances)

  - Affichage du type dans les proprits de fichier
    (ex : "MPEG-1 Layer III", etc.)

  - Affichage des totaux en Mo (plutt qu'en ko)

  - Hints dans la bote de dialogue "Warning" qui s'affiche parfois

  - Modifications cosmtiques mineures




* 22/07/2005 : version 0.26 build 900 [22/07/2005 20:42]

  bugs corrigs :

  - La longueur des trames des fichiers MPEG-2 Layer III n'tait pas
    correctement calcule, ce qui provoquait des erreurs avec certains
    fichiers, et un ralentissement pnible avec les mp3 VBR...




* 20/07/2005 : version 0.25 build 885 [20/07/2005 16:58]

  fonctions ajoutes/modifies :

  - Bulles d'aide (partout) !

  - En encodage, affichage des temps restant et total estims

  - Affichage du total et du total estim dans la barre d'tat
    (compte aussi les fichiers dont le bitrate est infrieur au bitrate
    de destination, mais ne compte pas ceux en italique).

  - Options de recherche supplmentaires dans la bote "Importation
    de dossier" : CBR, VBR, taille minimale en ko.


  bugs corrigs :

  - Bug "Read Error" corrig, et du mme coup, meilleure
    estimation de la taille rsultante.

  - Correction de quelques dfauts d'affichage





* 19/07/2005 : version 0.24 build 850 [19/07/2005 13:04]

  fonctions ajoutes/modifies :

  - J'ai remarqu que, dans beaucoup de mp3 ayant un tag V2,
    il y avait beaucoup d'espace vide inemploy. diteur de
    tags mal conu, espace libre pour faciliter l'ajout de
    tags personnaliss ? Quoiqu'il en soit, j'ai ajout une
    option "compacter les tags V2" qui permet de rcuprer
    quelques prcieux octets, parfois quelques milliers, sans
    perdre d'information. Option exprimentale,  utiliser
    avec prudence.  priori le rarissime footer optionnel
    "3DI" (rptition des donnes "ID3", place  la fin
    du tag), est dtruit par cette option, ce qui ne gnera
    personne, du moins je le pense. :D

  - On peut dfinir des rglages "Expert" diffrents pour
    les modes CBR et ABR.

  - Dans la bote des proprits du fichier, on rappelle
    s'il s'agit d'un VBR ou d'un CBR.

  bugs corrigs :

  - BUG IMPORTANT, suite  l'ajout de la fonction permettant
    l'arrt de l'importation : quand on importait un dossier,
    sans cocher la case "parcourir les sous-dossiers", les
    fichiers n'taient pas ajouts.

  - "Vieux" bug, difficile  dtecter : dans "ajout de fichiers",
    si un fichier tait invalide, ce n'tait pas le bon nom
    de fichier qui apparaissait dans le message d'erreur.

  - Dans la bote des proprits du fichier, la frquence
    d'chantillonnage des VBR apparaissait toujours  zro.




* 17/07/2005 : version 0.23 build 824 [17/07/2005 22:41]

  fonctions ajoutes/modifies :

  - Possibilit d'interrompre l'importation (dans le cas o
    on a cliqu sur "Parcourir les sous-rpertoires")

  - Paralllement  la correction du bug des colonnes,
    l'affichage des fichiers qui ne seront pas traits est
    en italique au lieu d'tre en rouge. C'est moins agressif,
    de toutes faons.


  bugs corrigs :

  - Dfaut d'affichage des colonnes quand on les redimensionne



* 17/07/2005 : version 0.22 build 800 [17/07/2005 17:44]

  fonctions ajoutes/amliores :

  - Il est maintenant possible, pour Lame, de choisir un autre
    rpertoire que celui de l'application.
    Si, au dmarrage de l'application, Lame n'est plus retrouv,
    et ne se trouve pas dans le rpertoire de l'application, il
    est propos de dfinir son chemin. En parallle, une option
    "Chemin d'accs  Lame" a t rajoute dans l'onglet "Lame"
    des options avances.

  - La disponibilit des rpertoires de destination en criture
    est maintenant vrifie en amont.
    Si l'option choisie est "rpertoire source", la vrification
    se fait fichier par fichier. Sinon, on vrifie seulement
    la disponibilit en criture du rpertoire slectionn,
    sachant que cette vrification a dj t faite lors de
    la dfinition du rpertoire dans les options avances.
    Dans tous les cas, s'affichent en rouge les fichiers qui
    ne vont pas pouvoir tre convertis.

  - LameInfo ne fabrique plus son fichier de capture dans
    le rpertoire de l'application, mais dans le rpertoire
    temporaire courant. C'est plus cohrent, et ainsi l'appli
    peut se lancer depuis un rpertoire non disponible en
    criture.

  bugs corrigs :

  - Vrification de validit du rpertoire de destination.
    (Bon, a marche maintenant, oui ? :( )




* 16/07/2005 : version 0.21 build 735 [16/07/2005 17:07]

  fonctions ajoutes/amliores :

  - Quand on cherche  valider le rpertoire de destination,
    dans les options avances, il est d'abord transform en
    chemin complet si ce n'est pas le cas, puis la validit
    du nom est vrifie ( contrler).
    Si le nom est valide, mais que le rpertoire n'existe pas,
    il est propos  l'utilisateur de le crer.

  bugs corrigs :

  - Le rpertoire de destination des options avances tait
    vrifi, mme quand il n'y avait pas lieu.

  - Pas vraiment un bug, mais une prvention de gros risque,
    suite aux expriences de gowap, bta-testeur hors pair.
    L'utilitaire charg de lire le numro de version de Lame
    (au dmarrage), et son aide ( l'ouverture de la bote
    de dialogue "Options avances"), excutable qui tait
    une ressource compresse dans WinMP3Shrink, est maintenant
    livr en fichier spar, appel "LameInfo.exe", aprs avoir
    t entirement rcrit. Par ailleurs il n'est plus invoqu
    qu'au dmarrage de l'application, et quand on clique sur
    le bouton "?" de l'onglet "Lame" des options avances.

  REMARQUES :
    Le fichier LameInfo.exe n'est pas ncessaire au bon
    fonctionnement de WinMP3Shrink. Je l'ai mme rendu
    facultatif : s'il est effac ou renomm, WinMP3Shrink
    fonctionnera quand mme, simplement il n'y aura pas
    d'affichage du numro de version de Lame, ni de
    bouton "?" dans l'onglet "Lame" des options avances.



* 15/07/2005 : version 0.20 build 700 [15/07/2005 21:36]

  fonctions ajoutes/amliores :

  - GESTION SIMPLE DU MODE ABR : deux boutons radio ont fait
    leur apparition, permettant de choisir entre les 2 modes:
    CBR : Constant Bit Rate (le mode habituel)
    ABR : Average Bit Rate (un mode VBR particulier, dans
          lequel Lame essaie de raliser le bitrate moyen
          transmis en paramtre;  noter qu'il ne tombe
          jamais juste...).

  - Ajout d'options dans la bote d'importation de dossier, pour
    PARCOURIR LES SOUS-RPERTOIRES, et choisir les types de
    fichiers  importer.

  - En complment du parcours des sous-rpertoires, le programme
    peut REPRODUIRE L'ARBORESCENCE dans le rpertoire de destination
    si ce dernier est fix. Peut bien sr se dsactiver.

  - Ajout de l'option "CONSERVER LA DATE ET L'HEURE DES FICHIERS"

  - Rcriture complte du systme de gestion des options, et
    de leur sauvegarde dans la base de registre. En plus, j'ai
    chang le nom de la clef BDR o le programme sauvegarde
    ses paramtres. Le nouveau systme est beaucoup plus simple
    pour moi, mais provoquera une perte de vos paramtres
    personnaliss d'une version antrieure... Regardez-bien
    s'il n'y a pas de problme au niveau de la sauvegarde
    des paramtres personnaliss.
    Dsol, ce sont les joies du bta-testing ! ;)

  - En complment de ce qui prcde, il y a maintenant une option
     cocher, si vous dsirez que le programme vous demande le
    droit de sauvegarder les paramtres, en sortie. Ce qui
    permet alors d'essayer des paramtres provisoires sans
    les sauvegarder.

  - La version et la longueur du tag v2 s'affiche.


  bugs corrigs :

  - les tags V2.2 n'taient pas affichs correctement

  - les tags V2.4 risquaient de n'tre pas affichs correctement

  - un ralentissement global  l'ajout de fichiers a t corrig,
    pour ne pas dire parfois un plantage complet.
    Il tait li  la lecture de la liste des trames V2, ce qui
    ne sert strictement  rien pour lire le bitrate.
    Modifi et corrig : la lecture de la liste des trames ne se
    fait plus qu' l'ouverture du dialogue "Proprits'.

  - Toujours concernant les tags, une limite arbitraire (5000 octets)
    a t fixe pour le dumping hexadcimal, sinon le composant
    "Memo" part en tilt. De toutes faons, pour des trames de cette
    taille-l (images le plus souvent), le dumping n'a qu'un intrt
    tout  fait relatif.

  - Gestion de la variante de Michael Mutschler pour les ID3v1.1
    (Numro de piste cach dans la zone commentaires)

  - Je ne sais pas depuis quand, mais les VBR, s'ils taient bien
    dtects en interne, n'taient plus affichs correctement.


  REMARQUES :
   L'affichage des tags V2 mrite quand mme d'tre test
   sur le long terme. Signalez-moi tout problme.

   Si vous le dsirez, il y a du mnage  faire,
   effacer dans la base de registre la clef :
   "HKEY_CURRENT_USER\Software\CJSoft\mp3Shrink"
   Ce n'est pas obligatoire, mais elle ne sert plus

   La nouvelle clef est la suivante :
   "HKEY_CURRENT_USER\Software\CJSoft\WinMP3Shrink"

   "Une bonne mnagre nettoie sa BDR avec Prop'BDR.
    Prop'BDR, et la BDR n'est plus un enfer !" (tsoiiin)



* 14/07/2005 : version 0.19 build 600 [14/07/2005 15:54]

  fonctions ajoutes/amliores :

  - AFFICHAGE DES TAGS V2 (popup, touche F1 ou double-click)
  - Amlioration visuelle de la bote de dialogue des proprits.

  bugs corrigs :

  - Bug divers, surtout un concernant l'importation de dossier



* 13/07/2005 : version 0.18 build 545 [13/07/2005 20:55]

  fonctions ajoutes/amliores :

  - AFFICHAGE DES TAGS V1 (popup, touche F1 ou double-click)
  - Vrification de la validit du rpertoire de destination.
  - Le test concernant le bitrate peut tre dsactiv.
  - Ajout d'options "pour les experts" dans l'onglet "Lame"
    des options avances. Accessoirement, un petit bouton "?"
    permet de rcuprer l'aide de la version de Lame installe,
    et un autre d'avoir une ide de la ligne de commande.
    Deux macros permettent de modifier le comportement
    de WinMP3Shrink. Ce serait sympa de faire connatre
    vos rglages favoris... ;)
  - Correction de quelques dfauts d'affichage.



* 12/07/2005 : version 0.17 build 456 [12/07/2005 16:16]

  fonctions ajoutes/amliores :

  - Affichage du numro de version de Lame dtecte
    (n'a l'air de rien, mais a m'a pris deux jours :( )
  - Prise en charge du format wav
  - Prise en charge des formats mp2 (test), mp1 (non test)
  - On peut choisir un rpertoire  importer !
    (vive la paresse ! ;) )
  - On peut choisir un rpertoire de destination, auquel
    cas le suffixe n'est plus ajout, sauf pour les
    fichiers qui seraient dj dans le rpertoire
    de destination.
  - Les en-ttes de colonne ne se comportent plus comme
    des boutons, ce qui pouvait troubler l'utilisateur.
  - Redimesionnement automatique des colonnes supprim.
    On peut dornavant les redimensionner manuellement.
  - Grand nettoyage du code source (les dveloppeurs me
    comprendront ;) )

  REMARQUE :
    quand on slectionne un rpertoire, soit pour l'importer,
    soit lors du choix d'un rpertoire de destination,
    le lecteur de disquette va "gratter" quelques instants.
    Ce comportement, auquel nous ne sommes plus habitus,
    n'est pas de mon fait, mais de Borland et de son composant
    TShellTreeView. C'est un problme connu. Je vais essayer
    de voir ce que je peux faire, mais a risque d'tre long,
    alors vous me pardonnerez pour le moment...



* 09/07/2005 : version 0.16 build 262 [09/07/2005 12:00]

  fonctions ajoutes/amliores :

  - Le rglage de la qualit se fait dornavant dans les
    rglages avancs
  - L'affichage d'une bote de dialogue d'alerte, si des
    mp3 sont rencods avec un bitrate suprieur, se fait
    maintenant AVANT l'encodage, ce qui est plus logique.
  - Modifications esthtiques

  bugs corrigs :

  - Plantage svre dans Windows 9x : Lame ne rendant pas la
    main, l'application gelait aprs le premier encodage.



* 08/07/2005 : version 0.15 build 250 [08/07/2005 23:36]

  bugs corrigs :

  - Apparition d'un fichier mystre (mais sans danger :) )
  - Oubli d'un bouton inutile, sauf pour moi...



* 08/07/2005 : version 0.15 build 249 [08/07/2005 23:09]

  fonctions ajoutes/amliores :

  - Ajout d'une bote de dialogue permettant le rglage
    de paramtres approfondis
  - SAUVEGARDE DES TAGS MP3, si l'utilisateur le dsire...
    (sauvegarde du tag v1 active par dfaut, sauvegarde
    du tag v2 (ID3) dsactive par dfaut).
  - Ajout d'une option permettant d'afficher plutt le chemin
    court dans la liste d'excution.
  - Ajout d'une option afin que, si le bitrate ne change pas,
    les donnes audio soient copies, pour viter toute perte.
    (activ par dfaut)
  - Affichage d'une bote de dialogue d'alerte, si des
    mp3 sont rencods avec un bitrate suprieur. La bote
    apparat  la fin, et donne la liste des fichiers.

  bugs corrigs :

  - Affichages intempestifs de botes de dialogue



* 07/07/2005 : version 0.14 build 208 [07/07/2005 20:51]

  fonctions ajoutes/amliores :

  - suppression de l'tape de dcodage (!!!)
  - rcriture de la routine de dtection du bitrate
    ( priori plus rapide et plus fiable)
  - touche Suppr active pour l'effacement dans la liste
  - petits dsagrments cosmtiques

  bugs corrigs :

  - problme d'affichage de la liste avec bcp de fichiers



* 06/07/2005 : version 0.13 build 121 [06/07/2005 22:13]

  fonctions ajoutes/amliores :

  - Enlever des fichiers de la liste :
    * On peut slectionner plusieurs fichiers  enlever
    * Le click sur "enlever..." redonne le focus  la liste

  bugs corrigs :

  - Le STOP ne fonctionnait pas pour plus d'un fichier
  - Correction d'un bug empchant la reconnaissance
    d'un mp3 corrompu dans le cas d'une slection multiple
  - Correction d'un bug empchant la reconnaissance
    de certains mp3 particuliers rcalcitrants (rares)
  - Affichage du logo corrig



* 06/07/2005 : version 0.12 build 107 [06/07/2005 19:45]

  bugs corrigs :

  - Sous certaines conditions, l'appel  Lame.exe
    ne s'effectuait pas. Merci  Scaramanga, de
    Gravure-News, d'avoir attir mon attention sur
    ce problme.
  - Fichier .wav temporaire effac aprs usage.



* 06/07/2005 : version 0.11 build 100 [06/07/2005 16:42]

  fonctions ajoutes/amliores :

  - le dernier rpertoire utilis est maintenant mmoris.

  bugs corrigs :

  - la position de la fentre est correctement mmorise.
  - rsolu problme bte pour les mp3 ayant un tag v2. :(
  - les mp3 vbr sont dornavant correctement grs
  - vrification disponibilit des fichiers avant traitement
  - correction de certains affichages



* 05/07/2005 : version 0.10 build 38 [05/07/2005 23:54]

  premire version publie



Programme entirement ralis sous Delphi 2005

(c) CapJack 2005

----------------------------------------------------------------------
