home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / mp3osr05.zip / docs / eng / readme.txt < prev   
Text File  |  2000-01-07  |  6KB  |  172 lines
  1.  
  2. = [ abstract ] ===========================================================
  3.  
  4. MPEG Searcher
  5.  
  6.         this small program will find MPEGs for you using  specified  path,
  7.  will edit tags by the way, and will write the resulting list of MPEGs ac-
  8.  cording to templates.
  9.  
  10.         there is no much features, but they are planned ;-)
  11.  
  12.         in  that  program  I implemented things that were needed by me, so
  13.  you'll  find  there  two-items sort (there will be three-items sort) that
  14.  sometimes is great thing.
  15.  
  16. = [ license info ] =======================================================
  17.  
  18.         common  license principle is AS IS. by using this software, you're
  19.  automatically agreeing this license.
  20.  
  21.         1)  the  author  will  not answer to any damages of your hardware,
  22.  since no destruction code were used. you can verify that by viewing sour-
  23.  ce code that distributed with that program.
  24.  
  25.         2)  you  can  freely use and distribute that software without com-
  26.  mercial income, you can not modify original archive and files that it co-
  27.  ntains. if you modify the program, you must point to these modifications.
  28.  
  29.         3)  you can freely use the fragments of source code and algorithms
  30.  that  were  used without mentioning the author, if your resulting program
  31.  is  not commercial, otherwise you must receive the author's agreement and
  32.  you must mention author by adding 'Portions Copyright (pc) 199 by Alexan-
  33.  der Trunov [2:5069/10, jnc@mail.ru]'.
  34.  
  35. = [ templates ] ==========================================================
  36.  
  37.         in  some  cases  it is possible to use the templates, according to
  38.  them MPEG Searcher will generate resulting file.
  39.  
  40.         there  is  two  cases  when that is possible: "whole" template and
  41.  "by" template.
  42.  
  43.         "by"  template  is  needed to divide resulting report into several
  44.  groups.  following is the example of the report, that was generated using
  45.  "by" template.
  46.  
  47. = [ cut ] ================================================================
  48.  
  49. = [ abstract ] ===========================================================
  50.  
  51.                              grouped list of mp3s
  52.  
  53.                        generated at 1999/12/12 21:19:56
  54.  
  55. = [ list ] ===============================================================
  56.  
  57. = [ Chris Norman ] =======================================================
  58.  
  59. s0807.mp3     3,029kb  Chris Norman - Baby Don't Change (03:41)
  60. s0803.mp3     2,872kb  Chris Norman - Baby I Miss You (03:30)
  61. [...]
  62.  
  63. = [ total 27 mpegs, 90,836kb ] ===========================================
  64.  
  65. = [ Chris Rea ] ==========================================================
  66.  
  67. s0410.mp3     4,057kb  Chris Rea - 'Disco' La Passione (04:56)
  68. s0402.mp3     4,974kb  Chris Rea - (Film Theme) Dov'e Il Signore (06:03)
  69. [...]
  70.  
  71. = [ total 47 mpegs, 180,870kb ] ==========================================
  72.  
  73. = [ Chris de Burgh ] =====================================================
  74.  
  75. s0113.mp3     2,819kb  Chris de Burgh - A Rainy Night In Paris (03:26)
  76. s0107.mp3     4,158kb  Chris de Burgh - A Spaceman Game Travelling (05:04)
  77. [...]
  78.  
  79. = [ total 43 mpegs, 145,649kb ] ==========================================
  80.  
  81. = [ Gary Moore ] =========================================================
  82.  
  83. s0608.mp3     5,495kb  Gary Moore - Afraid Of Tomorrow (06:41)
  84. s0201.mp3     3,187kb  Gary Moore - Always Gonna Love You (03:53)
  85. [...]
  86.  
  87. = [ total 24 mpegs, 113,430kb ] ==========================================
  88.  
  89. = [ totals ] =============================================================
  90.  
  91.                        total listed 141 mpegs, 530,785kb
  92.  
  93. = [ cut ] ================================================================
  94.  
  95.  
  96.         the  division  type  must be choosed before the generation. in the
  97.  dialog  first column is the division method, and the second column - sor-
  98.  ting method of resulted groups. in the example that was mentioned, in the
  99.  first column was "Artist", in the second - "Title".
  100.  
  101.         "whole"  template is composed in three files, as described in con-
  102.  figuration file:
  103.  
  104.         .hdr
  105.         .inf
  106.         .inf
  107.         [....]
  108.         .ftr
  109.  
  110.         .inf-file is used on each MPEG-file
  111.  
  112.         "by" template is composed in five files, as also described in con-
  113.  figuration file:
  114.  
  115.         .hdr
  116.         .shd
  117.         .inf
  118.         .inf
  119.         [...]
  120.         .sft
  121.         .shd
  122.         .inf
  123.         .inf
  124.         [...]
  125.         .sft
  126.         [...]
  127.         .ftr
  128.  
  129.         .shd and .sft files are used on each group
  130.         .inf file is used on each MPEG
  131.  
  132.         in each template you can use the following macros:
  133.  @curhour/@curmin/@cursec - current time;
  134.  @curday/@curmonth/@curyear/@curdow/@curshortdow - current time.
  135.  
  136.         in .shd you can use:
  137.   @artist,  @title, @album, @comment, @year - from MPEG's tag ('?' symbols
  138.  are used when the tag item empty);
  139.   @mpegversion,  @bitrate,  @samplerate, @layer, @mode (joint-stereo, dual
  140.  channel, etc), @playtimesec, @playtimemin, @size (size of mpegfile), @fi-
  141.  lename (filename of mpeg) of *first* MPEG of the whole group.
  142.  
  143.         in .inf you can use the same macros as in .shd
  144.  
  145.         in .sft you can use:
  146.   @subsize  (size  of  all  MPEGs in group), @subnum (quantity of MPEGs ingroup)
  147.  
  148.         in .ftr you can use:
  149.   @totsize, @totnum in analogy to @subsize and @subnum
  150.  
  151. = [ source code info ] ===================================================
  152.  
  153.         this  stuff  is  compiled  by  Virtual  Pascal  2.0  release (rule
  154.  thing!!)     with     DPMI32     addition     by     Veit     Kannegieser
  155.  (Veit.Kannegieser@gmx.de).  I think, it can be easily compiled with anot-
  156.  her compiler, such as BP or FPC.
  157.  
  158. = [ contact info ] =======================================================
  159.  
  160.         Alexander Trunov,
  161.           FIDO: 2:5069/10
  162.           Internet: jnc@mail.ru
  163.  
  164.         new  versions  you  can get at: (russian page, see in the download
  165.  section)
  166.         http://jnc.newmail.ru/mp3srch.htm
  167.  
  168.         for  problems  that  seems to related to MPEG Searcher please send
  169.  mail to adresses at the top of section. please include:
  170.         * how can the problem recreated ?
  171.         * screen dumps or logfiles
  172.         * etc