Davar4: Indexing of Audio Files Homepage Help index Previous Next

 
 

Indexing of Audio Files


Menu: Open (empty or semifinished) AIX module:
Multimedia | Open audio index > (select AIX)
Menu Multimedia commands:
Index audio file...
Library tree: Open (empty or semifinished) AIX module:
Double click to selected AIX module in Audio folder
Toolbar Icons: (Index audio file...)

Indexing of the audio MP3 files is a process where information about a verse reference is linked with its position in the MP3 file (offset). Data is stored in an AIX file as plain text. To create an AIX index, first it is necessary to prepare an "empty" AIX file, according to the MP3 files that will be indexed. Then the MP3 files are played in Davar4 (switched to indexing mode) and the user must determine the start of each verse in the audio.

Indexing the audio files requires more advance experience than other Davar4 functions. Please study and review this information carefully!


IMPORTANT: Davar4 index files are NOT compatible with Davar3 AIX files (and vice versa). It is possible that Davar4 AIX format was extended to cover all possible MP3 file divisions, such as, (MP3 of an entire Bible / one Bible book / one Bible chapter / one verse).


1) Preparation of an "empty" AIX file.

An AIX file is a text file that describes the name of each MP3 file according to the names of the books in the DBK book file. It also contains the starting position for each verse. At the bottom of this page, there is an AIX file "template", which (after manual modification) can be used to begin indexing a project.

These are the parts that need to be modified in your AIX file:

AIX_Books=39
The number of (Bible) books must be the same as the number of books listed in the AIX_BookListpart.

AIX_Files=39

The number of files which cover the range of all the books specified in AIX_Books. If one MP3 file is one Bible book (e.g. Genesis.mp3), then AIX_Books will be same as AIX_Files. But it is possible to have any number of file divisions and, in this case, AIX_Files can be different. All MP3 files must be properly listed in the AIX_FileList section, see below.


AIX_Abbreviation=BHS
The abbreviation of an AIX file - can be the same as the narrated book.

AIX_Title=Hebrew Old Testament narration
The title of an AIX file. It is displayed in the library tree.

AIX_Copyright=Files downloaded from http://www.mechon-mamre.org/p/pt/pt00.htm#mp3 (or http://www.audioscripture.com/) and distributed free of charge. The content of these MP3 files remains unchanged.
Copyright information about the MP3 and AIX files. You should insert the url of where the MP3 files can be obtained.


AIX_BookList part:
1,OTGen,Gen
2,OTExod,Exo
3,OTLev,Lev

...

In this section, the number of lines after the line "AIX_BookList" must be the same as the AIX_Books. Each line has three parts (all case sensitive):
number of the book,sync name,abbreviation

number of the book is the number of book order starting from number 1
sync name is a unique string which is used for synchronisation. A list of all the sync names is in the Module Development Kit
abbreviation is the abbreviation of the book which is used in the indexing dialog (see below)

AIX_FileList part:

This part connects the file number (1st item) with the file name (2nd item). For example:

AIX_FileList
1,01_genesis.mp3
2,02_exodus.mp3

where 1 is the file number for file 01_genesis.mp3.

 

It is very important that all MP3 files are correctly listed in this section. The following are extreme examples:

1,all_bible.mp3

This indicates that the entire Bible narration is in one file

 

or

1,genesis_01_01.mp3

This indicates that only one verse (Gen 1:1) is in single mp3 file.

This second example requires that the AIX_FileList contain thousands of items listed to cover the entire Bible range and must be listed completely.

MP3 files are usually divided by books or chapters.

 

AIX_IndexList part

This is the index. It is expressed as a list of references, files and offsets to indicate where to start playing and (optionally) where to stop playing. Each line of this index covers one verse.

It contains 5 (or 6 as an option) numbers:

 

1. number = number of book according to the AIX_BookList + ':' character as separator
2.number = number of the chapter + ':' character as separator
3.number = number of the verse + ',' character as separator

4. number = file number according to the AIX_FileList + ',' character as separator
5.number = offset of start of the verse in the MP3 file (position on the MP3 where to start play)
6.number [OPTIONAL] = ',' character as separator and offset of end of the verse in the MP3 file (position in MP3 where to stop play)

Here is example of index for Gen 1:1 and Gen 1:2 (6th number is not used)

1:1:1,1,0
1:1:2,1,47772

 

Important: if a file has not been indexed yet, at least one line for each file number (#4, number, on the AIX indexlist) MUST be present with correct reference to the book/chapter/verse where this MP3 file starts (1., 2., 3 numbers).

For example, if each MP3 file covers one Bible book, this lines must be present in the AIX file before indexing:

1:1:1,1,0 (= Gen 1:1 starts in file #1 from offset 0 = from begin)

2:1:1,2,0 (= Exo 1:1 starts in file #2 from offset 0 = from begin)

... etc,

After you create or modify the AIX file, copy the file to the \audio\ folder of the program.
There, then, create a subfolder with the same name as the name of your AIX file (case sensitive!). Next copy all MP3 files to that folder.

For example, bhs.aix is placed in the \audio\ folder and there is an \audio\bhs\ folder with all MP3 files.

2) Indexing process

After you have prepared an empty AIX file and placed all the files in their proper paths, restart Davar4. It will find your copy of AIX. Open it (from either the menu or library tree).

Then open only one window - with the book you want to index. The content of the opened book and the MP3 audio must correspond.

Finally, open the indexing dialog (using the menu or toolbar button). The Dialog is modal - when opened it will stop you from working in the main window. It can take some time if you have a slow PC and a big AIX file.


Perform the following steps:

1) Backup your AIX file (really a good rule for any work!).

2) Now select the reference, from where you want to start. For example, if you want to start from Genesis 1:1. When selected in the combo, it will synchronise with the text in the book window. See picture above to the left.

3) The FIRST click on the button (Start indexing of MP3) will start playing the MP3 file. About 0.2 - 0.5 sec before you expect the start of a new verse (Gen 1:2), press the button again (Add verse Gen 1:1). See picture above on the right. The position in the text window will be updated. Continue clicking the button. It is usually enough to store just the start point of each verse. But in some cases, (like long gaps between verses or some unwanted sounds), you can store also the end of the verse, by pressing "Verse end" button.

4) When you want to stop (MP3 can still play), just press the Save button - data is saved into the AIX file. The Audio is stopped and you will find the new references in the combo. (You can press the Close button or go to point 2)

5) If you click the button at the wrong time, DO NOT PANIC! Just press the Save button, select from the combo the reference where the MP3 was indexed as OK and go over the critical parts again.




Below is an empty AIX file which was used for the indexing of the BHS MP3 narration.
You can edit this template in notepad or similar editor to meet your needs, store your template as an AIX file (UTF-8 encoding, without BOM) and use it as a base for your own AIX file.


;This is Davar4 audio index file (AIX).Purpose is to point to MP3 files according
;(biblical) books and store offsets in MP3 stream versus references.
;This file is stored in \audio\ folder in some of Davar paths. MP3 files
;MUST(!) be stored in same folder name as is name of AIX file. For example:
;C:\Davar4\audio\bhs.aix\bhs\01-gen.mp3, 02-ex.mp3, 03-lev.mp3 ...etc.
;If first character on the line is ';' or enter (=CR+LF), all line is ignored
;IMPORTANT: Davar4 AIX files are NOT backward compatible with Davar3. But it is
;possible relative easily to convert old D3 files to D4 in text editor. See manual.

AIX_Version=4
AIX_Books=39
AIX_Files=39
AIX_Abbreviation=BHS
AIX_Title=Hebrew Old Testament narration
AIX_Copyright=Files downloaded from http://www.mechon-mamre.org/p/pt/pt00.htm#mp3 (or http://www.audioscripture.com/) and distributed free of charge. Content of MP3 remained unchanged.

;after BookList string, on each line is reference between
;book number, sync name and abbreviation
;Number of lines must be same as AIX_Books (!)
;-------------------------------------------------------------------------------
AIX_BookList
1,OTGen,Gen
2,OTExod,Exo
3,OTLev,Lev
4,OTNum,Num
5,OTDeut,Deu
6,OTJosh,Jos
7,OTJudg,Jdg
8,OTRuth,Rth
9,OT1Sam,1Sa
10,OT2Sam,2Sa
11,OT1Kgs,1Ki
12,OT2Kgs,2Ki
13,OT1Chr,1Ch
14,OT2Chr,2Ch
15,OTEzra,Ezr
16,OTNeh,Neh
17,OTEsth,Est
18,OTJob,Job
19,OTPss,Psa
20,OTProv,Pro
21,OTQoh,Ecc
22,OTCant,Son
23,OTIsa,Isa
24,OTJer,Jer
25,OTLam,Lam
26,OTEzek,Eze
27,OTDan,Dan
28,OTHos,Hos
29,OTJoel,Joe
30,OTAmos,Amo
31,OTObad,Oba
32,OTJonah,Jon
33,OTMic,Mic
34,OTNahum,Nah
35,OTHab,Hab
36,OTZeph,Zep
37,OTHag,Hag
38,OTZech,Zec
39,OTMal,Mal


;after FileList string, on each line is reference between
;file number and its name - ONLY ASCII strings in filename are allowed!
;Number of lines must be same as AIX_Files (!)
;-------------------------------------------------------------------------------
AIX_FileList
1,01_genesis.mp3
2,02_exodus.mp3
3,03_leviticus.mp3
4,04_numbers.mp3
5,05_deuteronomy.mp3
6,06_joshua.mp3
7,07_judges.mp3
8,08_ruth.mp3
9,09_1-samuel.mp3
10,10_2-samuel.mp3
11,11_1-kings.mp3
12,12_2-kings.mp3
13,13_1-chronicles.mp3
14,14_2-chronicles.mp3
15,15_ezra.mp3
16,16_nehemiah.mp3
17,17_esther.mp3
18,18_job.mp3
19,19_psalms.mp3
20,20_proverbs.mp3
21,21_ecclesiastes.mp3
22,22_songofsongs.mp3
23,23_isaiah.mp3
24,24_jeremiah.mp3
25,25_lamentations.mp3
26,26_ezekiel.mp3
27,27_daniel.mp3
28,28_hosea.mp3
29,29_joel.mp3
30,30_amos.mp3
31,31_obadiah.mp3
32,32_jonah.mp3
33,33_micah.mp3
34,34_nahum.mp3
35,35_habakkuk.mp3
36,36_zephaniah.mp3
37,37_haggai.mp3
38,38_zechariah.mp3
39,39_malachi.mp3


;list of references, files and offsets to file
;1. number: number of book according AIX_BookList (1=Gen, 2=Exod, ...) + ':' character
;2.number: number of the chapter + ':' character
;3.number: number of the verse + ',' character
;4. number: file number according AIX_FileList + ',' character
;5.number: offset of start this verse in MP3 file
;6.number [OPTIONAL]: ',' character and offset of end of this verse in MP3 file
;for example, first verse can be: 1:1:1,1,0 or 1:1:1,1,0,31235 where last number is end of verse in mp3
;if file was not indexed yet, at least one line e.g. 1:1:1,1,0 must be presented!!
;-------------------------------------------------------------------------------
AIX_IndexList
1:1:1,1,0
2:1:1,2,0
3:1:1,3,0
4:1:1,4,0
5:1:1,5,0
6:1:1,6,0
7:1:1,7,0
8:1:1,8,0
9:1:1,9,0
10:1:1,10,0
11:1:1,11,0
12:1:1,12,0
13:1:1,13,0
14:1:1,14,0
15:1:1,15,0
16:1:1,16,0
17:1:1,17,0
18:1:1,18,0
19:1:1,19,0
20:1:1,20,0
21:1:1,21,0
22:1:1,22,0
23:1:1,23,0
24:1:1,24,0
25:1:1,25,0
26:1:1,26,0
27:1:1,27,0
28:1:1,28,0
29:1:1,29,0
30:1:1,30,0
31:1:1,31,0
32:1:1,32,0
33:1:1,33,0
34:1:1,34,0
35:1:1,35,0
36:1:1,36,0
37:1:1,37,0
38:1:1,38,0
39:1:1,39,0