Description of various functions in Obi

Original Author(s): Prashant Ranjan Verma
Updated in May 2016: Obi 3.8 was released in December 2015 with new features and enhancements. Check out the Release Notes or refer to the "What is new" section in the Obi Help Manual.

Creating a new Project

Watch this in a Video

Every project corresponds to a digital talking book (DTB) in Obi. You can create a new project by following the steps given below:

  1. From the menu, select File->New Project or press Ctrl+N. A dialog box opens as shown in the figure below.
  2. Enter the following details:
    Field Field Type Description
    Title Edit Box Enter a title of your project. This will be the title of the exported DTB.
    Automatically create a title section with this title Checkbox If checked, Obi will create a section (strip) for the title section.
    ID Edit Box Enter a unique identifier for the book. This identifier should be compliant with the scheme of assigned identifiers to a book in your organization. You can leave this field with the default value provided, if you are not sure. ID is stored in the metadata and can be changed any time.
    Generate Button Generates an identifier for your project randomly and fills in the ID field.
    Location Edit Box Enter the location where you want to store your project. You can also browse for a location by Clicking the Select button or pressing Alt+S.
    Select Button Opens the Windows file browser to select a directory for your project. If the selected location is not empty, Obi will suggest one. Click Yes or press Alt+Y to accept or click No or press Alt+N to ignore.
  3. Click OK or press Alt+O to create a project. Obi will attempt to create the specified directory if it does not exist.

A new project will be opened in the work area of Obi, showing the title as the first node of the tree in the TOC View. This title will become the first section of the project at the top level.

Obi also creates a strip (section) corresponding to it in the Content View, if chosen while creating (in the Create New Project dialog box).

Working with Sections

Watch this in a Video

A section can be described as a container holding one or more audio clips, called phrases. Each section in an Obi project corresponds to a section in the exported DTB. Phrases are combined to form the contents of the section.

A section can represent different parts of a book such as a chapter, a topic, a sub-topic, table of contents, etc.

Obi allows nested sections. Therefore, a section can have one or more subsections. This feature helps users to put all topics of a chapter under its corresponding section, the sub-topics under a topic and so on.

Obi shows a section in different styles: in TOC View and Content View.

You can perform the following operations:

Adding a Section

You can create a new section in Obi by clicking Section->Add Section on the menu, or by pressing Ctrl+H. The newly created section will be selected, and it can be edited. Type the name of the section and press Enter. This section will be empty. This means that it will not have any phrases.

Inserting a Section

If you wish to insert a section before the current one, select Sections->Insert Section from the menu, or press Ctrl+Alt+H.

Adding a Subsection

You can add a subsection to the selected section by clicking Section->Add Subsection on the menu, or by pressing Ctrl+Shift+H.

The newly created subsection will be selected and can be edited. Type the name of the subsection and press Enter. This subsection will be empty - it will not have any phrases.

Note: Obi allows you to create a subsection only if a section is selected.

Section Properties

You can see or modify the properties of a section by clicking View->Section properties on the menu, or by pressing Alt+Enter. A dialog box opens. It has the following fields:

Field Field type Editable? Description
Section title Edit Box Read Only Name of the section.
Level / Depth Combo Box Read / Write Level of the section. The top level section has a level 1, its subsections have level 2 and so on.
Ancestor section (s) List Box Read Only Shows the exact location of the section in the tree by listing the names of its parents starting from the top level.
Duration Edit Box Read Only Total audio content in the section (in terms of time) it is the sum of audio content in all Used and Unused phrases.
Number of phrases Edit Box Read Only Total phrases in the section. It includes both Used as well as Unused phrases.
Used Check Box Read / Write If checked, the section is a Used section. Otherwise, it is Unused.

Preferences

Preferences are the settings and adjustments used in all Obi sessions. These preferences are global - used across all projects. However, some of the audio preferences can be set for a single project. For all other projects, global preferences will be used.

You can set or modify preferences by clicking Tools->Preferences on the menu or by pressing Ctrl+Alt+F. A dialog box opens with six pages (tabs), one for each type of preference.

Audio Preferences

The Audio Preferences tab allows you to set or modify Obi-specific audio settings as well as project-specific audio settings. The preferences dialog offers the following options under this tab:

Field Field Type Specific to Description
Input Device Name Combo Box Obi Select an audio input device (sound card input port) to be used for recording.
Output Device Name Combo Box Obi Select an audio output device (sound card output port) to be used for playback.
Sampling Rate Combo Box Project Select a sampling rate for recording. Note: The higher the sample rate, the better the quality of audio, and therefore, more disk space is required. Default sampling rate is set to 44100 hertz.
Audio Channels Combo Box Project Select mono for using a single channel or stereo for two. By default, it is set to mono to save disk space.
Preview Duration Edit Box Obi Set the duration (in seconds) for previewing an audio after the position, where you paused. Default value is 1.5 seconds.
Noise Level Combo Box Obi Reflects the noise level in your recording environment. Select low for a recording studio, medium for a silent but not a sound proof room, or high for a noisy background. Note: Obi sets the thresholds for peak meter in accordance with this field.
Audio Clues Check Box Obi If checked, enables the audio clues, disables otherwise. Audio clues provide audio indicators for non-visual users.

Keyboard Shortcut Preferences

The keyboard Shortcut tab of the Preferences dialog lets you modify the shortcut keys for operations available in Obi.

The Preferences dialog offers the following options under this tab:

FieldField TypeDescription
Select key list Combo boxSelect the scope of the operation. For example, Menu item shortcut keys for New project.
Keyboard shortcut list List view Provides the list of operations available in the scope selected in the above combo box. Select the operation for which the keyboard shortcut has to be changed.
Shortcut keys Edit box Type in the desired key combination. Please note: If you press Enter here, the shortcut will be assigned to the operation selected in the List view.
AssignButton Assigns new key combination to the selected operation in the List view.
Remove shortcut Button Removes the keyboard shortcut of the selected operation in the List view. Consequently, the selected operation will have no shortcut key combination.

Example:

Let's change the shortcut keys for the operation. Select the complete phrase waveform. Its default keyboard shortcut is A. The process of modifying consists of the following steps:

  • Select the scope of the operation from the combo box Select shortcuts to view, which is Content/TOC view.
  • Now select the operation from the List view beneath it.
  • Type in the desired shortcut, say Q. Press Enter or click on the Assign button.

The operation Select complete waveform of phrase has a new keyboard shortcut, namely Q.

Live Recording

Audio content can be placed into the project by recording directly in Obi.

There are two ways to do this:

  1. Record entire content as a single phrase and then perform auto-splitting. The structure editing however, has to be completed manually.
  2. Create the structure of the book while recording using the navigation controls of the Transport Bar.

Before recording, you must check the microphone settings and sound level to ensure high-quality production.

Pre-recording Tasks

Before recording for the first time, you must perform some pre-recording tasks:

  1. Check your microphone settings.
  2. Check the audio preferences of Obi.

Checking the microphone settings

Check the system settings for the volume of microphone. It is advised to maintain a consistent volume throughout the book.

You must ensure that the volume is loud enough to be heard comfortably. At the same time, the selected volume level should not cause clipping and distortion.

You can change the microphone settings from your system’s volume control settings.

Check audio preferences

Audio preferences can be viewed in the Audio preferences tab of the Preferences dialog.

Preferences: What should be checked?
Input Device Name The driver corresponding to your microphone should be selected.
Sampling Rate The default value (44100 hertz) is optimum sampling rate. If you want to save the disk space, the lower rates can be selected.
Channel Specifies whether the recording will be done for a stereo sound or a mono sound.
Noise Level Indicates the noise level of your recording environment. Select low for recording studio, medium for room that is not sound proof, and high for a noisy environment.

Audio Monitoring for optimum quality

It is a good practice to review and establish the audio quality before recording.

To start monitoring, click Transport->Start Monitoring on the menu or, press Ctrl+R. Alternatively, you can click the Start Monitoring button on the Transport Bar.

You can see the amplitudes in Textual Peak Meter (Left and Right controls of Transport Bar). The values will range from -90(minimum) to 0(maximum) decibels. But these values will rarely be seen, if your microphone volume has been set. Obi will warn you long before reaching these extremes.

If you want to monitor graphically and check for overloads, open the Graphical Peak Meter.

Note: If you press Ctrl+R again, Obi will start recording.

Advanced Recording mode

Obi provides the Advanced Recording Mode that enables the following options:

  • Start recording from cursor
  • Delete the audio content after the cursor position is on the selected phrase and start recording in a new phrase next to it
  • Always record directly from transport bar
  • Deactivate the toggling feature of the Start monitoring/Record button of the Transport bar
  • Always record directly from each click on the button
  • Allow overwriting: Record at a selection point inside a phrase. Rules are described in the Allow overwrite option topic

You can enable the Advanced Recording Mode using the Enable Advanced Recording Mode button in Audio Preferences tab of the Preferences dialog.

Recording toolbar

Recording toolbar allows recording the contents displayed on the computer screen. It provides an exhaustive set of controls required for recording book contents and marking structure at the same time.

It is not a component of the application window but is a vital part of Obi. Its miniature appearance leaves maximum space for the resource being read.

The buttons presented by the Recording toolbar can be categorized as follows:

  • Audio controls
  • Navigation and Mark-up Controls

Recording toolbar can be in any of the following modes:

  • Idle: No operation is taking place
  • Playing: Playback is in progress
  • Monitoring/Recording: Audio monitoring/recording is in progress

The Recording toolbar can be displayed by selecting View-> Show Recording toolbar from the menu or pressing Ctrl+Alt+R. It is hidden by default.

Please note that Obi opens the Graphical Peak Meter automatically with the initiation of the Recording toolbar.

Recording into a Phrase

To record a blank phrase, select it first. To start recording directly, click Transport->Start recording directly on the menu or, press Ctrl+Shift+R.

If you want to monitor before recording, press Ctrl+R. if you press Ctrl+R again, the recording will start.

Obi will continue recording into the phrase until you stop by clicking Transport->Stop on the menu or, press Ctrl+Space.

Now, the phrase will display the duration of the recorded content, and draw a waveform of audio beneath it.

If you pause instead of stopping by clicking Transport->Pause on the menu or pressing Space, the recording will stop, and the point of recording will be saved. The phrase being recorded will be marked as a starting point for recording. Whenever you start recording again, Obi will create a new phrase next to the start-point and starts recording into it. To remove the start-point, simply press Ctrl+Space.

Audio Clues

Audio clues are the voice indications provided by Obi for the confirmation or warnings. The following table lists these audio clues:

Audio Clue Purpose Significance
Single Knock Confirmation Beginning of the audio selection has been marked.
Double Knock Confirmation End of the audio selection has been marked.
“Low” Warning Amplitude of the audio being played is low.
“High” Warning Amplitude of the audio being played is high.
“Good” Confirmation Amplitude of the audio being played is of good quality. This means that it is neither low nor high.
Collapsing sound Warning The Search bar has collapsed (gone out of sight).
“Fine navigation on” Confirmation Fine navigation mode has been turned on.
Milliseconds (e.g “200”) Confirmation Notifies the nudge duration when you increase or decrease it.

Note: The items in double quotes are spoken in Obi.

You can disable the audio clues in the audio preferences tab of the Preferences dialog. They are enabled by default.

Changing the Todo or Used Status

The phrases in Obi can also hold a special status. These phrases require special attention, and are listed below:

Changing the Todo status

Todo phrases are the ones on which work has to be done. You may want to mark the current phrase as Todo. For example, if you made a mistake while reading the text, etc. Once you have completed the necessary corrections, you need to change its status back to normal.

It is a good practice to mark the incomplete phrases as Todo so that you do not miss the minute details before publishing the book.

You can change the Todo status of the phrase by clicking Phrases->Phrase is Todo on the menu or by pressing F9.

Changing the Used status

The audio of the phrase is included or excluded from the exported DTB depending on the Used status of the phrase.

You can set the status to Used or Unused by clicking Phrases->Phrase is Used on the menu or by pressing Ctrl+K. If the checkbox in front of the menu item is checked, the phrase is Used and vice versa.

Importing Audio Files

You can import pre-recorded audio files into your project if they are in the following formats:

  • WAV/RIF format (.wav extension)
  • MP3 format (.mp3 extension)
  • MP4 format (.mp4 extension)

Follow the steps provided below to import audio files:

  1. Select the section where the audio files should be placed.
  2. To import audio files, click Phrases->Import Audio Files on the menu, or press Ctrl+I. An open dialog that is displayed lets you browse for the files to be imported.
  3. Select your files and click the Open button. Obi will display the Import audio file settings dialog displaying the list of files selected by you, and some other controls enabling their manipulation as described below.
  4. Import audio files settings dialog

    If you want to move a file above or below its adjacent file, select it and do any of the following:

  • Click on the Move file up button to move the selected file up by one position in the list.
  • Click on the Move file down button to move the selected file by one position down in the list.
  • To add more files to the list, click on the Add button. It opens a dialog box that lets you browse and select the required audio files.
  • You can also remove unneeded files from the list by selecting them in the list, and then pressing the Remove button.
  • Furthermore, you can sort the files in one go by using the Ascending order or Descending order buttons that will sort the files by their names.
  • To create a section for each selected file, check the checkbox Create a section for each audio file; this will also enable three more controls as described later in this topic.
  • Finally, you have the option to either apply phrase detection on the imported audio or restrict the length of each phrase via the following radio buttons:

    • Split phrases on import: Splits phrases if their length exceeds the size mentioned in the edit box Phrase size in minutes.
    • Apply phrase detection: Applies phrase detection on the imported audio and splits the phrases at the detected points.
    • Click on the OK button.

    Please note that the files will be imported in the same order as they appear in the list of selected files in the Import audio file settings dialog. So, it is important to check and correct their order before starting the import process.

    Obi will import the audio content from the selected files and store them as phrases according to the following set of rules.

    By default, Obi will create a phrase for each audio file at the beginning of the selected section or after the selected phrase. The phrase will contain entire audio from the audio file. If the format or audio settings (channel and sampling rate) of the audio files are different from that of the project, the audio files will be converted before importing.

    After importing audio, it will either be broken in the fragments of fixed size or at the points determined using phrase detection.

    If you opted to create a section for each audio file, new sections will be created after the selected section. The section will bear the same name as that of the audio file and contain the audio content from the respective file. If the selected section is empty, it will be replaced with the section corresponding to the first file.

    Activation of this option also enables you to give the inputs for parsing and refining the section names as follows:

    To replace with space: A character that should be replaced with the space character in resulting section name, such as “_”. For example, if the files are named as “Chapter_1 and you type the character “_” in the edit box, the resulting section name will be “Chapter 1”. Some characters should be trimmed from the beginning of the audio file name. For instance, if the file name is “001 Chapter 1” and you type in the number 4 in the edit box, the resulting section name will be “Chapter 1”. Page identification: A string that signifies that the audio file name contains audio for the page number. In this case, Obi will not create a separate section for it but create a page phrase and append it to the previous section. But if the audio file name contains some alphabets other than this string, a new section will be created, and the audio of page number will be stored therein. Please note that if this field is left blank, pages will not be appended to the previous section, but a new section will be created for each of them.

    Please note that each of these options is preceded by a checkbox to activate or deactivate the respective option.

    This function is very useful when you have pre-recorded audio content which has to be converted to a navigable DAISY/EPUB book. The operation is designed so that users will be able to produce a DAISY/EPUB book by creating a new project, importing audio files, and exporting the project.

    Auto-splitting using Phrase Detection

    When you import an audio file, it is brought into the project as a single phrase. This contradicts the definition of phrase and will not provide the reader with a rich reading experience. To support the full capabilities of DAISY players, the phrase must be split into smaller parts to represent a small paragraph, a sentence, or a part of a sentence.

    This can be a very tedious job. However, Obi empowers you to do this in three steps by using phrase detection as described below:

  1. Select the phrase which you want to split using phrase detection.
  2. Click Phrases->Apply Phrase Detection on the menu, or press Ctrl+Shift+P. A dialog appears as follows:
  3. Change the values, if you wish to do so and press OK.

The following table lists the fields in the Phrase Detection Settings dialog and their description.

Field Field Type Description
Silence threshold Edit Box Sets maximum amplitude for silence.
Gap between sentences Edit Box Sets minimum duration (in milliseconds) of silence.
Leading silence Edit Box Duration (in milliseconds) of a little part of silence to be kept at the beginning of each split phrase.

Phrase Detection uses a preceding silence phrase to determine the parameters given in the above table. Whenever a portion of audio meets the first two parameters, it is split at a position decided using the third parameter.

If there is no silence phrase preceding the current phrase, default parameters are shown in the dialog.

You can create a silence phrase by recording the audio of silence. This is important as the background noise varies in different recording environments. For example, silence means a pin drop silence in a recording studio, whereas it means clock ticks if your room has one.

You can create a silence phrase by creating a blank phrase before the current phrase and recording without speaking anything. Then, assign a silence role by clicking Phrases->Assign Role->Silence on the menu. Note here, the duration of the silence phrase is important as it represents the pause in the sentence (may be a comma or a full stop).

Working with Phrases

A phrase is a single unit of audio content representing a sentence or a part of a sentence. One or more sentences are combined to form a topic in a book. Similarly, one or more phrases are combined to form a section in an Obi project.

There is no restriction on the length of the phrase, and hence, it can hold the audio content of any duration. But you must formulate the definition of the phrase for your project, and make full use of the capabilities of DAISY players.

Since you can navigate among phrases in a DAISY DTB, you must answer a simple question before recording: What will a single phrase hold? For a mathematical book, a phrase may contain a single expression, whereas, for a novel it may contain two or three lines.

The question above should be answered, as this will form the basis of the kind of navigation you want to provide in your DTB.

Pictorial representation
A phrase is only visible in Content View. Its pictorial representation has 2 parts:

  1. Label containing the phrase number with respect to total phrases of the section, and duration of audio content in the phrase.
  2. A graph displaying the waveform of audio of the phrase.

A single section may contain a large number of phrases as they hold the actual content of the topic. The content of the book can be recorded directly in Obi or, audio files can be imported into the project.

You can create blank phrases that act as placeholders of audio to be filled later. Some other semantics can also be added to the phrases, like a page phrase, a silence phrase, etc. This is discussed in more detail in the topic: Pages and Special Roles.

Cutting, Copying, and Pasting the Phrases

Cut: You can cut a phrase by clicking Edit->Cut on the menu or pressing Ctrl+X.

Copy: Similarly, a phrase can be copied by clicking Edit->Copy on the menu or by pressing Ctrl+C.

Obi stores the phrase you have just cut or copied in the clipboard.

Paste: You can paste the phrase you have just cut or copied after the selected item by clicking Edit->Paste on the menu or by pressing Ctrl+V.

How the phrase will be pasted depends on the item you have selected:

  • If the selected item is a section, the phrase will be pasted at the end of the list of phrases. This means this phrase will be the last phrase of the section.
  • If the selected item is a phrase, the phrase from the clipboard will be pasted after it.
  • If the selected item is a phrase separator, the phrase will be pasted into its place.
  • If you have made an audio selection, it will be replaced by the audio contained in the phrase from the clipboard.

Splitting a phrase

Watch this in a Video

Any phrase can be split into two by following the steps given below:

  1. Select a phrase you want to split.
  2. Set the audio cursor at the point of the desired split.
  3. Play the audio of the phrase.
  4. Pause at a point where you want to split.
  5. Alternatively, you can mark the point of the split on the waveform by clicking on it.
  6. Click Phrases->Split Phrase on the menu, or press Ctrl+Q.

A new phrase will be created after the current phrase containing the audio after the selection point.

For example:

A phrase contains an audio “At a time when the spirit of adventure was strong, the literature of travel naturally flourished”.

Now, if you set the audio cursor after “strong”, the phrases will be split as:

  1. “At a time when the spirit of adventure was strong”
  2. “The literature of travel naturally flourished”

Note: Splitting can also be performed on the fly by simply using the Split Phrase command during playback.

Merging the phrases

Watch this in a Video

Obi enables you to merge any number of continuous phrases in a single section. To perform the merge operation on the phrases, three types of merge commands are provided:

  • Merge with the next phrase
  • Merge with following phrases
  • Merge with preceding phrases

Merge with the next phrase. In this mode, the merge command attaches the subsequent phrase to the selected phrase.

Follow the steps given below to merge a phrase with the next one:

Select the former phrase of the two that you want to merge.

Click Phrases->Merge->Merge Phrase with Next on the menu, or press Ctrl+M.

The audio of the subsequent phrase is appended to the one you selected. This is the converse operation of Split Phrase.

Merged phrase will be assigned a role according to the following rules:

  • If any of the phrases is a page phrase, the merged phrase will hold a page role.
  • If any of the phrases has a heading role, the same will be assigned to the merged phrase.
  • In all other cases the merged phrase will have the role held by the first phrase of the two.

Merge with following phrases: This command merges all phrases following the selected phrase in a section, in the same order as they appear in the section.

To merge all the successive phrases with the current one, follow the steps listed below:

  • Select the foremost phrase from the list of phrases to be merged.
  • Click Phrases-> Merge-> Merge with following phrases from the menu.
  • Obi will start appending all the phrases after the selected phrase until the end of the section is reached. The selected phrase will become the last phrase of the section containing the audio of all the phrases that have been merged. You can merge with preceding phrases.

    You may also choose to merge all the phrases prior to the current phrase in a single section.

    Follow the steps given below to merge the phrases with the preceding phrases:

    • Select the last phrase from the list of phrases to be merged.
    • Click Phrases-> Merge->Merge with preceding phrases on the menu.

    In this mode of the merge command, Obi will start from the beginning of the section, merging all the phrases one by one, till the selected phrase is encountered. After the merge, the first phrase of the section will contain audio from all the merged phrases.

    Remarks:

    If you merge phrases using the command Merge following phrases or Merge preceding phrases, the merged phrase will be assigned a role according to the following rules:

    • If any of the phrases has a heading role, the merged phrase will hold a heading role.
    • In all other cases the merged phrase will have the role held by the first phrase.

    Deleting a phrase

    A phrase can be deleted by selecting, then clicking Edit->Delete or by pressing Del. The phrase is removed from the section, and the phrase following it takes its position.

    Pages and Special Roles

    In general, phrases hold the contents of a topic. But they may be used to portray assigned roles.

    These roles are defined in the table below:

    Role Description
    Page Indicates that the phrase corresponds to a page and will be skippable in the exported DTB. A page number is associated with each page phrase.
    Heading Indicates that the phrase contains the audio for the heading of the section. There can be only one heading phrase in the section. If not specified explicitly, the first one will be considered as a heading.
    Silence Indicates that the phrase contains audio representing silence in the recording environment. This will always be an Unused phrase.
    Custom Custom roles can also be assigned to a phrase. But they are not exported to the DTB.

    The phrases with special roles have an extra tag in their label indicating the type of role they are portraying.

    Pages

    Pages are a special type of phrases that contain audio pertaining to the page number. For example, a page phrase contains an audio “Page 34”.

    The label of page phrase will have an extra tag indicating the page number, such as Page Number 1.

    There are three kinds of pages in a DAISY book:

    • Page Front: The pages in front of the book containing the table of contents, a preface, etc.
    • Page Normal: Normal pages containing the actual content of the book.
    • Page Special: Special pages at the end of the book containing Appendix etc.

    When you assign a page role to a phrase, you must specify what kind of page it is.

    Cleaning Unreferenced Audio

    Whenever you delete some audio content, its entry is removed from the project file. However, the physical data corresponding to it still exists on the disk. Obi keeps a record of this operation so that it can be reversed later.

    The audio content that neither has an entry in the project file nor corresponds to the Undo record is known as "unreferenced audio".

    Note: This is done to reduce burden on disk operations and Improve turnaround time.

    Clean Unreferenced Audio is a very simple command that cleans all the unreferenced audio (physical audio files or some of their parts) by a single command. Click Tools->Clean unreferenced Audio->Complete cleanup on the menu, or press Ctrl+L.

    Obi performs this operation automatically when the project is closed. It also checks the consistency of physical data within the project file at the beginning of each session.

    Metadata View

    The Metadata View allows you to view or modify book metadata. It is divided into two parts:

    • A list that shows all the entries of metadata.
    • Edit area that lets you modify the entry selected from the list.

    Show/Hide Metadata View

    The Metadata View can be shown or hidden by selecting View->Show Metadata View from the menu or pressing Ctrl+Alt+M. It is hidden by default.

    Exporting as DAISY DTB

    This is the last step of creating the DAISY DTB. You must ensure the following before exporting:

    • All contents of the book have been entered correctly.
    • The structure of the book is in sync with the physical book.
    • Metadata entries are filled properly.

    Click Tools->Export as DAISY on the menu, or press Ctrl+E.

    A dialog box pops up that allows you to select the DAISY standard to which the exported DTB should comply.

    Select the appropriate radio button and click on the OK button. The export dialog opens.

    Obi suggests a path for the export directory in the dialog box. You can change it if you want to store the exported DTB somewhere else. You can also browse for a location by clicking the Select button.

    While exporting, Obi creates one audio file per section. You can restrict this behavior to a certain level (depth of section) by choosing an appropriate value from the combo box named Create one audio file per section. All the sections after that level will be clubbed into one file. For example, if you choose level 4 in the combo box, Obi will create one file per section until level 4. The subsections of the section at level 4 will be appended to the same file as the section at level 4. A new file will only be created when the section with level 4 or less is encountered.

    If you want to have audio files in MP3 format in your exported DTB, check Encode to MP3. In this case, you must select a suitable bit rate for MP3 files; the higher values ensure better quality. If this checkbox is unchecked, the exported audio files will be in WAV format. Click on the OK button to start exporting.

    Obi creates a subdirectory of your project directory and exports the files into it. The files will be exported according to the DAISY standard chosen before exporting. For example, if you chose DAISY 2.02, the files will conform to DAISY 2.02 specifications.

    Please note that while exporting according to DAISY 2.02 specifications, Obi will shift any page phrase appearing at the beginning of a section to the last position of the prior section.

    Before exporting, Obi checks for the following:

    • Duplication of page numbers for each kind of page. Obi allows you to have the same page numbers across different pages, but not within a page. For example, you can have page number 4 in "page front", as well as in "page normal". But if page number 4 is encountered twice in "page normal", a message will be displayed with a warning.
    • Empty sections or phrases: Obi does not export empty sections or phrases to the DTB. But during DAISY 2.02 export, Obi will permit blank page phrases in exported DTB. This is done purposefully to provide flexibility to the publisher in the scenario where the intended audience does not wish to hear page numbers while listening to the audio of the book.

    The following types of files are exported by Obi:

    • WAV files: Audio files containing the actual content of the book.
    • SMIL files: Synchronization file to relate markings in the text file with time points in the audio file.
    • OPF file (DAISY 3 export): Manifest file that acts as an entry point for accessing the contents of the DTB. You have to give the path of this file to play the book using a DAISY player or for performing operations like validation etc.
    • NCX file (DAISY 3 export): navigation control file which enables the user to move smoothly between files during synchronization.
    • NCC document (DAISY 2.02 export): The entry point provides navigation control.

    The exported DTB can be played using a DAISY player.

    You can hear the contents of the DTB in any player that supports WAV/MP3 file formats, but missing the main feature of a DAISY book - navigation. Each audio file contains one or more sections of the DTB, and the audio files are named with a number suffix. If you play these files in an increasing order of their number suffix, it will allow hearing the contents in the same order as they appear in the book.

    Validating the Exported DTB

    After exporting you must validate the book to ensure its compliance with the DAISY standards.

    Follow the steps given below to validate the exported DTB:

  • Click Tools-> DAISY 3 Validator on the menu to validate the exported DTB according to the DAISY 3 standard, or Tools-> DAISY 2.02 Light Validator to validate according to the DAISY 2.02 standard. A dialog box opens.
  • Enter the following fields:
    FieldField TypeDescription
    Select the input package file / input NCC documentEdit Box Enter the full path of OPF file of exported DTB (in case of DAISY 3 Validator), or NCC document (in case of DAISY2.02 Light Validator). To browse for the file, click on the browse button.
    Validation Report Edit BoxIf you want to store error log in XML format, enter full path of the file. To browse for the file, click on the browse button. Note: If you leave this field blank, errors will not be copied, but only show on the screen.
    Time ToleranceEdit BoxSets the threshold for time tolerance to be used for validating SMIL files.

  • Click the OK button.
  • Obi’s DTB Validator will start checking for errors in the exported DTB and report them if any. Errors can be viewed by clicking the Details>> button.

    If you selected a path for an error log, errors would be saved into a file in that location.

    You must correct the errors and export the DTB again, and continue the process of validating and exporting until all the errors have been removed.

    Encoding DTB Audio to MP3

    You may want to encode the book to a compressed audio format, as WAV files are quite large.

    Obi allows you to convert the audio files to MP3 by following the steps given below:

    1. Click Tools->Convert audio to MP3.
    2. Select the DAISY standard to which the exported DTB conforms by clicking on the respective radio button in the dialog box just opened.
    3. Click on the OK button. A dialog box opens.
    4. Enter the following fields:
      FieldField TypeDescription
      Input export directory Edit Box Full path of the .opf or .ncc file of DTB. You can also browse for the file by clicking on the Browse button.
      Output directory Edit Box Full path of the directory to store the encoded files. You may also browse for a location by clicking on the Browse button.
      Bit rateCombo Box Select the bit rate for the MP3 files. Higher the bit rate, higher the quality and hence, more space required.
    5. Click on the OK button.

    Obi will encode the WAV files to MP3 and store them in the output directory specified by you. It will also make necessary changes in other files and copy them to the same directory.

    Please note that if you opted to encode the exported audio files in MP3 format during the Export to DAISY operation, you should omit this step.

    Backup and Recovery

    Watch this in a Video

    Obi provides an Auto Save option to reduce the risk of losing important data to a great extent. This option can be turned on or off using the Auto Save settings in the Project Preferences tab of the Preferences dialog.

    When you choose to save automatically, all the modifications made in the project will be saved in a backup file. The backup file will be named as Backup_project-file-name.obi, where project-file-name is the existing name of the project file. This file will be created in the subdirectory of your project directory named Backup.

    If the project file gets corrupted or you find any inconsistencies, you can recover your project by clicking File-> Restore from backup on the menu.

    Obi will close the current project and reopen it from the backup file. Now, administer the contents thoroughly and save the project to claim the backup file as the main project file.

    But if you wish to reinstate the original project, click File->Restore from the original project on the menu. The menu item File->Restore from Backup toggles with each click; it shows Restore from Backup and Restore from original project alternatively.

    Multi-phrase operations

    Obi allows selection of a contiguous range of phrases:

    1. Select the first phrase from which selection should begin.
    2. Click Phrases->Multi phrase/page operation->Begin mark on the menu.
    3. Go to the last phrase of the range and click Phrases->Multi phrase/page operation->End mark on the menu.
    4. A dialog box will appear enabling you to select an operation to be performed. Select the desired operation and click OK.

    See also:

    AttachmentSize
    Obi Import files dialog.png129.66 KB
    ObiImportCsv.png68.91 KB
    DAISYpedia Categories: 


    This page was last edited by VLuceno on Friday, May 6, 2016 13:00
    Text is available under the terms of the DAISY Consortium Intellectual Property Policy, Licensing, and Working Group Process.